
>>-PARTITIONSET(name)--GROUP(groupname)------------------------->
.-RESIDENT(NO)--.
>--+-------------------+--+---------------+--------------------->
'-DESCRIPTION(text)-' '-RESIDENT(YES)-'
.-STATUS(ENABLED)--. .-USAGE(NORMAL)----.
>--+------------------+--+------------------+------------------->
'-STATUS(DISABLED)-' '-USAGE(TRANSIENT)-'
.-USELPACOPY(NO)--.
>--+-----------------+-----------------------------------------><
'-USELPACPOY(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.
- PARTITIONSET(name)
- specifies
the name of this PARTITIONSET 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 partition set names beginning with DFH, because these characters are
reserved for use by CICS®. For a device-dependent partition set, the partition
set name must be derived by adding the partition set suffix to the original
(1- to 6-character) partition set name. The suffix depends on the parameter
specified in the SUFFIX operand of the DFHPSD macro instruction that defined
the partition set.
To use device-dependent suffixes, you need to specify
BMS=(,,,DDS) as a system initialization parameter.
For programming
information on partition set suffixes, see the CICS Application Programming Reference.
- RESIDENT({NO|YES})
- specifies the residence status of the partition set.
- NO
- The partition set is not to be permanently resident.
- YES
- The partition 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 partition set status.
- DISABLED
- The partition set may not be used.
- ENABLED
- The partition set may be used.
- USAGE({NORMAL|TRANSIENT})
- specifies when the storage for this partition set is released.
- NORMAL
- When the use count for this partition set reaches zero, it becomes eligible
for removal from storage as part of the normal dynamic program compression
process.
- TRANSIENT
- When the use count for this partition set becomes zero, the storage for
this partition set is released. This value should be specified for partition
sets that are referenced infrequently.
- USELPACOPY({NO|YES})
- specifies whether the partition set is to be used from the link pack area
(LPA).
- NO
- The partition set is not to be used from the LPA. It is loaded into the
CICS partition.
- YES
- The partition set can be used from the LPA if LPA=YES is specified as
a system initialization parameter. The use of the partition set from the LPA
requires that it has been installed there and that the partition set is not
named by the PRVMOD start-up option. For more details on this, see the CICS Transaction Server for z/OS® Installation
Guide.