PARTITIONSET attributes

Describes the syntax and attributes of the PARTITIONSET 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.

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 that you enter are converted to uppercase.

It is preferable not to use names that start with DFH because these characters are reserved for use by CICS.

CICS can delete or discard them and replace them with CICS resources when you upgrade or provide new function or fixes.

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.

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 Controlling the use of modules from the MVS link pack area.