CICSplex RLS Lock Analysis attribute group

The CICSplex RLS Lock Analysis attributes report on tasks waiting for a Record Level Sharing (RLS) resource and tasks holding the records. Use the CICSplex RLS Lock Analysis attributes in situations to help identify applications that are making poor use of serially reusable resources and degrading system performance.

These attributes provide data for the VSAM RLS Lock Analysis table view.

Argument or Key Indicates one of following identifiers: the complete record key for the VSAM KSDS files, the relative byte address for the VSAM RRDS files, or the record number for the VSAM ESDS files. The value format is an alphanumeric string, a maximum of 256 characters, and is case-sensitive.

CICS Region Jobname Indicates either the job name or modify ID of the CICS region being monitored or the job name of the CICS region running a transaction that is holding an RLS record being waited on by transactions running in the CICS region being monitored. Each CICS region in a z/OS image has a unique job name. This job name is used for operations initiated from the z/OS system console. The value format is an alphanumeric string, maximum 8 characters, and is case-sensitive. CICS region names are always in uppercase characters.

Dataset Name Indicates the name of the VSAM data set allocated to the selected CICS region. The value format is an alphanumeric string, a maximum of 44 characters, and is case-sensitive.

Dataset Type Indicates the name of the type of VSAM data set. Valid values are:

ESDS
Entry sequence data set
KSDS
Key sequence data set
RRDS
Relative record data set
VRRDS
VSAM relative record data set
Unknown

Key Length Indicates the length of the record key. The value format is an integer, maximum 2 bytes, and in the range 0-32767.

Origin Node Is the combination of the z/OS System ID (SMFID) and the CICS region name. The value format is an alphanumeric string, maximum 32 bytes, and case-sensitive.

z/OS System ID Indicates the four-character name that uniquely identifies an active z/OS operating system within a given CICSplex. z/OS System IDs are always in uppercase characters. The value is an alphanumeric string, a maximum of four characters and case-sensitive.

Task No. Is the number sequentially assigned by CICS to uniquely identify each task. The value format is an alphanumeric string, a maximum of five characters, and is case-sensitive.

Task State Indicates whether the task is waiting for a record or holding one. Values are: Holder, Retained, and Waiter.

Time in Suspend Indicates the length of time the task has been in a waiting or holding state. The value format is an alphanumeric string, maximum 11 characters. In the example, format is hh:mm:ss:hh Indicates the amount of time is zero hours, 14 minutes, 7 seconds, and 42 hundredths of a second. Example: 00:14:07.42.

Time in Suspend Hours Indicates the hours portion of the length of time the task has been in a waiting or holding state. The value format is a numeric string with a maximum of two characters.

Time in Suspend Minutes Indicates the minutes portion of the length of time the task has been in a waiting or holding state. Values are: 0-59.

Time in Suspend Numeric Indicates the length of time the task has been in a waiting state or a holding state. This attribute allows the time to be presented graphically. Valid value is an integer, or in the format hh:mm:ss.th.

Time in Suspend Seconds Indicates the seconds portion of the length of time the task has been in a waiting or holding state. Values are: 0-59.

Time in Suspend Hundredths of a Second Indicates the hundredths-of-a-second portion of the length of time the task has been in a waiting or holding state. The value format is a numeric string with a maximum of two characters.

Transaction ID Indicates the ID of the transaction that either holds or is waiting for the specified VSAM record. The value format is an alphanumeric string with a maximum of four characters, and is case-sensitive.