CICSplex Connection Analysis attribute group

The CICSplex Connection Analysis attributes help you determine the efficiency of multiregion operation (MRO) and intersystem communication (ISC) links between regions within a selected CICS region. Use the CICSplex Connection Analysis attributes in situations to analyze the balance of work across connected Application-Owning Regions (AORs) and the routing of transactions from any Terminal-Owning Region (TOR) to connected regions.

These attributes provide data for the Connections Analysis table views.

Note: The attributes within the Connection Analysis Situations group are stored for historical retrieval within the Tivoli Data Warehouse. Selected attributes within this group are candidates for the Tivoli Data Warehouse summarization and pruning features.

AIDs Queued to this Connected System Indicates the number of automatic initiate descriptors (AID) that are queued on this connection. The queuing of AIDs against the connection Indicates that the connection is running at full capacity or can be out of service. If the connection is running at full capacity, you can need to redefine or increase the connection capacity. The value format is an integer, maximum 2 bytes, and in the range 0-32767.

CICS Region Jobname Indicates the job name or modify ID of the CICS region being monitored. Each CICS region in a z/OS operating system 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 eight characters, and case-sensitive. CICS region names are always in uppercase characters.

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

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

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

Connected System Name Indicates the eight-character name of the system connected to this CICS region. The value format is an alphanumeric string, maximum eight characters, and case-sensitive.

Connected System VTAM Applid Indicates the eight-character name that specifies the VTAM applid of the system connected to this CICS region. The value format is an alphanumeric string, maximum eight characters, and case-sensitive.

Connection Name Indicates the name that is specified for the connection in the Terminal Control Table (TCT). The value format is an alphanumeric string, maximum four characters, and case-sensitive.

Connection Status Indicates the status of the connection specified in the Terminal Control Table (TCT). These are the values:

  • INS
  • OUT
  • REL_INS
  • REL_OUT
  • SIMLOGON
  • OBT_INS
  • FRE_INS
  • AVA_INS
  • ACQ_INS
  • ACQ_OUT
  • Pending
  • Unknown

Connection Type Indicates the type of connection between the selected region and this region. The valid connection types are ISC, MRO, and cross-system coupling facility (XCF). These are the values:

  • IRC EXCI
  • IRC XCF
  • IRC XM
  • IRC SRB
  • ISC LU61
  • ISC LU62
  • Unknown

Connection Type Prefix Specifies the prefix of the connection type between the selected region and this region. For example, to verify an ISC connection type of either LU6.1 or LU6.2, specify a connection type prefix of ISC. Values are IRC and ISC.

Link Allocate Count from Originating Region Indicates number of link allocate requests from the originating region to this region across the named connection. The value format is a positive integer, maximum four bytes.

Link Allocate Percentage on Connection Indicates the percentage of link allocates from the originating region to this region, across the named connection. The value format is a percentage in the range 0-100.

Example: If the originating region made 200 link allocate requests over four connections and the requests were split as follows, the percentage values are 40, 10, 50, and 0.

CONA
80 requests
CONB
20 requests
CONC
100 requests
COND
0 requests

Link Allocation Rate Indicates the rate (per minute) at which link allocations are occurring. This is a guide to the level of activity across the connection. The value format is a positive integer, maximum four characters.

Number of Links Defined Indicates the total number of links defined for this connection type. The value format is a positive integer, maximum four characters.

Number of Links in Use Indicates the number of links in use for this connection type. The value format is a positive integer, maximum four characters.

Number of Primary Links Defined Indicates the number of primary links defined for the connection. The value format is a positive integer, maximum four characters.

Number of Primary Links in Use Indicates the number of primary links currently in use. The value format is a positive integer, maximum four characters.

Number of Secondary Links Defined Indicates the number of secondary links defined for this connection. The value format is a positive integer, maximum four characters.

Percent of Links in Use Indicates the percent of defined links for this connection type that are in use. The value format is a percentage in the range 0-100. Example: If 10 links for this connection type are defined and 3 are in use, then the value for this item is 30 percent.

Number of Secondary Links in Use Indicates the number of secondary links currently in use. The value format is a positive integer, maximum four characters.

Origin Node 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, the system 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, the status of the item changes accordingly. If the names of the origin node and the managed systems do not match, the status of the item remains unchanged.

Percent of Primary Links in Use Indicates the percentage of primary links in use. The value format is a percentage in the range 0-100. Example: If 10 links for this connection type are defined and 3 are in use, then the value for this item is 30 percent.

Percent of Secondary Links in Use Indicates the percentage of secondary links in use. This percentage is determined by dividing the total number of links in use by the total number of links defined and multiplying that number by 100. The value format is a percentage in the range 0-100.

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

XLN Status The status of Exchange Log Name flow for the LU6.2 connection.