Top  Previous  Next


The ECS.MAP command specifies the character map to be used by the QM session.





ECS.MAP {name}




nameis the name of the map to be used.



This command, available only on an ECS mode system, allows a QM session to change the character map used to control sort ordering, upper/lower case pairing and character types.


When a QM session is started (login, phantom creation, etc), the first map defined in the QM configuration parameters is selected as the default map for the session or, if no map was specified in the configuration parameters, a system supplied default map is used. The ECS.MAP command can be used to select an alternative map within a QM process, for example, to meet local language conventions for character sort order.


If the map identified in the ECS.MAP command was specified in the configuration parameters to be loaded into shared memory when QM was started, the command links to this map data. If the map is not in shared memory, it will be loaded into the process private memory. Where possible, shared memory maps should be used if they apply to multiple processes to minimise memory usage.


Use of the ECS.MAP command without a map name displays the name of the currently selected map.


Note that alternate key indices are stored internally in sorted order based on a map specified when the file was created. The ECS.MAP command sets the name of the base map and does not affect index operations. The map associated with the file will be selected when an index related operation commences and the system will  revert to the base map when the operation is complete. Actions within the dictionary expression of the index will be performed in the context of the file's map.



See also:

Extended Character Set Support, SET.ECS.MAP()