IMS Local Locks Held attributes

Use the IMS Local Locks Held attributes to create situations that monitor all locks application running within a dependent region currently holds.

DB Name The name of the requested database. Valid format consists of up to eight alphanumeric characters. Example: DI21PART is the name of an IMS database.

DCB Number The token identifier assigned to the IMS database. Valid format consists of alphanumeric characters. Example: 01

HALDB Partition ID The partition ID of a HALDB. Valid format is an integer.

HALDB Partition Name The partition name of a HALDB. Valid format consists of up to eight alphanumeric characters.

IMSID The IMS Subsystem identifier. Valid format consists of up to four alphanumeric characters. Example: I61A

IRLM Lock Elapsed Time Elapsed time of this lock in seconds. For an owner, the amount of time the owner has held a lock on a resource. For a waiter, the amount of time the waiter has been waiting on a resource. Valid format is HH:MM:SS (hours:minutes:seconds). IMS does not maintain lock elapsed time for IRLM 1.5. For IRLM 1.5 lock elapsed time will always be 0.

Job Name The name of a job that is requesting the lock. Valid format consists of up to eight alphanumeric characters. Example: IMS51MS1

Lock Intent The intent of a job that is holding or waiting for a lock. Valid values include ER (erase), EX (exclusive), RD (read only), SH (share), and UP (update).

Lock Status The status of a job holding a lock. Valid values includes OWNER (job is holding lock) and WAITER (job is waiting on lock).

Long Token The value, including the name of the database (if any), that IMS uses to identify the resource. The long token value can be a relative byte address (RBA), a relative block number (RBN), or some other value that IMS provides. The long token differs from the true token because it contains the name of the database (if any) as a prefix to the normal token. Valid format consists of up to sixteen alphanumeric characters.

LTERM ID The ID of the logical terminal associated with the transaction. Valid format is a text string of up to eight alphanumeric characters.

MVS ID The MVS System Management Facility (SMF) identifier. Valid format consists of up to four alphanumeric characters. Example: SP11

Originating System Identifier Identifier of the node representing the system where this data was collected. Valid format consists of up to 32 alphanumeric characters. Example: I91A:SP22:IMS

PSB Name The name of a program scheduling block (PSB) that IMS associates with a lock. Valid format consists of up to eight alphanumeric characters. Example: DFSSAM01

Recovery Token The recovery token for this lock. Valid format consists of up to eight alphanumeric characters.

Region ID The IMS identification number for a region. Valid format is an integer.

Region Status The current status of the IMS region. Valid values include N/A, ESSCALL, WT_INTNT, WT_PSBW, WT_DMB, IDLE, HOT_RGN, WT_WFI, WT_IRLM, WT_TERM, WT_DISP, WT_IWAIT, EX_TERM, EX_DRGN, WT_FPWFI, WT_FXBUF, WT_MSDB, WT_OCLTH, WT_DMLTH, WT_MSLTH, EX_SYNC, EX_DEOWN, WT_OBA, WT_SYLOK, WT_PIENQ, and WT_DBLTH.

Region Type The type of IMS region. Valid values include BMP (batch message processing), DBCTL (DBCTL thread), IFP (IMS Fast Path), and MPP (message processing program).

Sysplex Identifier The originating sysplex for this request. Valid format consists of up to eight alphanumeric characters.

Timestamp The date and time when the monitoring agent retrieved the data. This attribute is intended for logging and reporting data collection times rather than for creating situations. To specify a time of day for monitoring, use attributes from the Universal Time or Local Time groups. See the Tivoli Enterprise Portal help for instructions on specifying timestamp attributes in situations and queries.

Token The value that IMS uses to identify the resource. The token value can be a relative byte address (RBA), a relative block number (RBN), or some other value that IMS provides. Valid format consists of up to eight alphanumeric characters. Example: C3204001 is an RBA.

Transaction Name The name of the transaction that IMS associates with a lock. Valid format consists of up to eight alphanumeric characters. Example: DLETPART