CICSplex Region Overview attribute group

The CICSplex Region Overview attributes report on the internal resources of CICS regions. These resources include storage, files, queues, and enqueues.

Note:
The attributes within the CICSplex Region Overview group are stored for historical retrieval within the Tivoli Data Warehouse. Selected attributes within this group are candidates for the TDW's summarization and pruning features.

AIDs Indicates the number of automatic initiate descriptors (AIDs) found on the AID chain within a given CICS region. The value format is a positive integer, maximum 4 characters. An AID is created when CICS is unable to start a task because a resource is not available. An accumulation of AIDs can adversely affect CICS storage and CPU availability. An AID remains in CICS until the resource is available, CICS is shut down, or the AID is killed.

CICS Region Name Indicates the job name or modify ID of the CICS region being monitored. Each CICS region in a z/OS image has a unique name. This name is an alphanumeric string, with a maximum of 8 characters, and case-sensitive. CICS region names are always in uppercase characters.

CICS SYSIDNT Indicates the 4-character CICS system ID assigned to this CICS region. The value format is an alphanumeric string, maximum 4 characters, and case-sensitive. CICS system IDs are always in uppercase characters.

CICS TOD Clock Indicates the time of day clock setting in the CICS Common System Area (CSA). The time is expressed in 0.01 seconds units. The value format is a maximum of 4 bytes.

Note:
If fractional values are desired, you must include decimal points and up to two decimal places. For example, if you want 5.2 seconds, add the decimal point.

CICS TOD Updated Indicates whether the CICS time of day clock is being updated. When a task goes into a loop and the CICS task dispatcher is unable to regain control, the CICS time of day clock field in the Common System Area is not updated by task control. Values are: Yes and No

CICS Version Indicates the version of CICS running in the region.

CPU Utilization Indicates the percentage of accumulated CPU time for the CICS region. This value is calculated at the beginning and end of a short elapsed-time interval. The difference between these two values is the amount of CPU consumed in the CICS region during that interval; this difference is then represented as a percentage of the elapsed-time interval. The value format is a percentage in the range 0-999.

Example:

Therefore percent of CPU used during time interval = 3/10 =30%

A low-to-zero value indicates the absence of a workload or nondispatch by z/OS. A high-to-100% (or greater) value indicates a heavy workload or a potential loop in either your application or CICS code. If the workload is running on multiple CPUs, the CPU utilization can exceed 100%.

Note:
If fractional values are desired, you must include a decimal point and either zero or one decimal places; for example, 5.2.

Enqueue Waits Indicates the number of CICS enqueues exclusively controlling a resource that tasks are also waiting for. The value format is a positive integer, maximum 4 characters. A large number signifies that too many tasks are competing for exclusive access to the same resources at the same time, which can indicate a looping task, a deadlock situation, or poor response time from a task that holds an enqueued resource.

ICEs Indicates the number of interval control elements (ICEs) found on the ICE chain within a given CICS region. The value format is a positive integer, maximum 4 characters. An ICE is created whenever a time-dependent request for a CICS service is made. When the expiration time for the ICE is reached, the CICS service requested is initiated if the resources required for the service are available. If the requested service is task initiation, CICS creates an automatic initiate descriptor (AID) on ICE expiration. The AID either initiates the task or waits until required resources become available.

I/O Rate Indicates the rate at which I/O operations are being performed in a specified CICS region per second of elapsed time. It includes both application- and CICS-initiated I/O operations. The value format is a maximum of 4 characters.

Note:
If fractional values are desired, you must include decimal points and up to two decimal places. For example, if you want 5.2 seconds, add the decimal point.

Largest Contiguous Available LSQA Indicates the largest amount of contiguous local system queue area (LSQA) that is available. If LSQA accumulates to reach the top of the allocated private region, address space termination can occur. The value format is a positive integer, maximum 4 characters.

Largest Contiguous Available OSCOR Indicates the largest amount of contiguous free operating system core (OSCOR) that is available. If OSCOR is consumed to meet the IEALIMIT or expands to the bottom of the local system queue area (LSQA) address space termination can occur. The value format is a positive integer, maximum 4 characters.

Maximum Tasks Percent Indicates the total number of tasks within a CICS region, expressed as a percentage of the MXT limit. Attaching of new tasks within the CICS region stops when the maximum task limit reaches 100%. The value format is a percentage in the range 0-100.

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

When a situation is true, Tivoli Enterprise Portal compares the origin node name in the attribute to the names of managed systems assigned to the item. If the origin node name matches the name of a managed system, Tivoli Enterprise Portal changes the status of the item accordingly. If the names of the origin node and the managed systems do not match, the status of the item remains unchanged.

Page Rate Indicates the number of page-in operations in the CICS region per CPU second. The paging rate is important because CICS transactions wait until a page-in resolves. The value format is a maximum of 4 characters.

Note:
If fractional values are desired, you must include decimal points and up to two decimal places. For example, if you want 5.2 seconds, add the decimal point.

Region Status Indicates CICS address space position. Values are:

In
Indicates that the region is swapped in.
Inactive*
Indicates that the CICS region is inactive.
N/S
Indicates that the CICS region is non-swappable.
Out
Indicates that the region was swapped out during data collection, perhaps for the entire sample period, and that the sample is incomplete.

*The Inactive status is not displayed in Tivoli Enterprise Portal for CICS reports. Use this value only for creating situations.

SOS Is the short-on-storage indicator. Valid values are YES and NO.

Storage Violations Indicates the number of storage violations that have occurred within the last hour. A storage violation occurs when CICS detects storage corruption for a task. The value format is a positive integer, maximum 4 characters.

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

Transaction Rate Indicates the average number of transactions executed in one minute of elapsed time. For example, if the statistics are collected every 10 minutes, and the total number of transactions during the last 10 minutes is 300, the average number of transactions per minute is 30. The value format is a positive integer of maximum 2 bytes.

VTAM ACB Open Indicates whether the VTAM Access Method Control Block (ACB) is open or closed. The VTAM ACB defines the interface between the application code (CICS) and VTAM routines so that CICS can use VTAM facilities. Values are: Yes and No.

VTAM Applid Indicates the 8 character name that specifies the VTAM applid of the CICS region. Each CICS region has a unique VTAM applid. VTAM applids are always in uppercase characters. The value is an alphanumeric string, maximum 8 characters and case-sensitive.

VTAM Generic Applid Indicates the 8 character name that specifies the generic VTAM applid of the CICS region. Each CICS region has a specific and a generic VTAM applid. Generic VTAM applids are always in uppercase characters. The value is an alphanumeric string, maximum 8 characters and case-sensitive.

Working Set Size Indicates the amount of central (both real and expanded) storage owned by the address space, including both address space and other storage, such as dataspace, expressed as kilobytes. If the working set size value is high and central storage is constrained, considerable paging activity can occur, which degrades response time. The value format is a positive integer, maximum 4 characters.

XCF GROUP Indicates the 8 character name of the XCF group where the CICS region belongs.