MAPSET attributes

Describes the syntax and attributes of the MAPSET resource.

DESCRIPTION(text)

You can provide a description of the resource that you are defining in this field. The description text can be up to 58 characters in length. There are no restrictions on the characters that you can use. However, if you use parentheses, ensure that for each left parenthesis there is a matching right parenthesis. If you use the CREATE command, for each single apostrophe in the text, code two apostrophes.

GROUP(groupname)

Every resource definition must have a GROUP name. The resource definition becomes a member of the group and is installed in the CICS® system when the group is installed.

Acceptable characters: `A-Z 0-9 $ @ #` Any lowercase characters you enter are converted to uppercase.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters.

MAPSET(name)

specifies the name of this MAPSET definition. The name can be up to eight characters in length.

Acceptable characters: `A-Z 0-9 $ @ #` Unless you are using the CREATE command, any lowercase characters that you enter are converted to uppercase.

Do not use map set names beginning with DFH, because these characters are reserved for use by CICS.

For a BMS device-dependent map set, the map set name must be derived by adding the map set suffix to the original (1-to 7-character) map set name. The suffix depends on the parameter specified in the TERM operand of the DFHMSD macroinstruction that defined the map set.

To use device-dependent suffixes, you need to specify BMS=(,,,DDS) as a system initialization parameter. For information on map set suffixes, see Device dependent support.

RESIDENT({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 operating system.

RSL

This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. For more information, see Obsolete attributes.

STATUS({ENABLED|DISABLED})

specifies the map set status.

DISABLED: The map set may not be used.
ENABLED: The map set may be used.

USAGE({NORMAL|TRANSIENT})

specifies when the storage for this map set will be released.

NORMAL: When the use count of the map set reaches zero, it will become eligible for removal from storage as part of the normal dynamic storage compression process.
TRANSIENT: When the use count for this map set becomes zero, the storage for this map set is released. This value should be specified for map sets that are referenced infrequently.

USELPACOPY({NO|YES})

specifies whether the map set is to be used from the link pack area (LPA).

NO: The map set is not to be used from the LPA. It is loaded into the CICS partition.
YES: The map set can be used from the LPA if LPA=YES is specified as a system initialization parameter. The use of the map set from the LPA requires that it has been installed there and that the map set is not named by the PRVMOD start-up option. For further guidance on this, see Controlling the use of modules from the MVS link pack area