Mapset Configuration File

3.11 Mapset Configuration File

The following table lists and defines mapsets available to be referenced by the CICS application. For more information, see tcxmapgen(1) in System Commands and Transactions.

The filename is mapsets.desc.

The format of a MAPSET definition is:

[mapset]
<field_name_1>=<field_value_1>
<field_name_2>=<field_value_2>
… …
<field_name_n>=<field_value_n>

For example,

[mapset]
name=ABANNER
filename=abanner.mpdef

Table 3-9 Mapset Parameters

Field Name	Type	Values	Description
`NAME`	`X(8)`	`Mandatory`	Name of the mapset.
`DESCRIPTION`	`X(60)`	`Optional`	A small textual comment zone for description of the resource.
`FILENAME`	`X(79)`	`Mandatory`	This specifies the physical (binary) file name of the mapset, which is generated by the tcxmapgen tool. It will be searched in directories defined by the `KIX_MAP_PATH` environment variable if the absolute path is not specified. If this field is not specified, the default mapset binary file name `.mpdef` will be used, in which the is the `MAPSET` name parameter specified in CICS MAP related APIs.
`RESIDENT`	`X(3)`	`NO \| YES`	Specifies the residence status of the map set. NO: The map set is not to be permanently resident. YES: The map set is to be loaded on first reference and is then to be permanently resident in virtual storage, but is to be pageable by the system.
`swastatus`	`X(10)`	`ENABLED\|DI SABLED`	Specifies the resource status. If set to `ENABLED`, the resource is available. If set to `DISABLED`, the resource is unavailable for use by the system.
`Usage`	`X(10)`	`NORMAL \| TRANSIENT`	This attribute specifies the caching scheme to be used once the `MAPSET` is loaded. `NORMAL` keeps the `MAPSET` loaded in a cache. Unload it when the cache overflows and it is the oldest, least used `MAPSET` in the cache. `TRANSIENT` unloads the `MAPSET` if it is not being used.

Parent topic: CICS Runtime Configuration Files