
>>-MAPSET(name)--GROUP(groupname)--+-------------------+-------->
'-DESCRIPTION(text)-'
.-RESIDENT(NO)--. .-STATUS(ENABLED)--.
>--+---------------+--+------------------+---------------------->
'-RESIDENT(YES)-' '-STATUS(DISABLED)-'
.-USAGE(NORMAL)----. .-USELPACOPY(NO)--.
>--+------------------+--+-----------------+-------------------><
'-USAGE(TRANSIENT)-' '-USELPACOPY(YES)-'
- DESCRIPTION(text)
- You can provide a description of the resource 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 one. 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
lower case characters you enter are converted to upper case. |
The GROUP name can be up to eight characters in length. Lowercase
characters are treated as uppercase characters. Do not use group names beginning
with DFH, because these characters are reserved for use by CICS.
- 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 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 programming
information on map set suffixes, see the CICS Application
Programming Reference.
- 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 the CICS Transaction Server for z/OS® Installation
Guide.