Attribute

CreateMap (CM)

Purpose

Determines whether the driver creates a new schema map when establishing the connection.

Valid Values

0 | 1 | 2 | 3

Behavior

If set to 0 (No), the driver uses the current schema map specified by the Schema Map option. If one does not exist, the connection fails.

If set to 1 (ForceNew), the driver deletes the current schema map specified by the Schema Map option and creates a new one at the same location.

Warning: This causes all views, data caches, and map customizations defined in the current schema map to be lost.

If set to 2 (NotExist), the driver uses the current schema map specified by the Schema Map option. If one does not exist, the driver creates one.

If set to 3 (Session), the driver does not create or use schema map. It stores metadata in the memory.

Default

2 (NotExist)

See also