CICSplex MQ Connection Details attribute group
The CICSplex MQ Connection Details attributes help identify problems across CICS regions and z/OS images that the CICSplex spans. Use the CICSplex MQ Connection Details attributes in situations to monitor message queuing (MQ) services. These attributes provide data for the Message Queuing Analysis table view.
Adapter Status Indicates the status of the CICS MQ adapter. These are the valid values: Active, Inactive, Unknown, and Not installed.
The CICS MQ adapter provides access to CICS WebSphere MQ for CICS applications, and also provides control functions that initiate and manage connections. Control functions are accessed through the CKQC transaction, or from application programs using EXEC CICS LINK.
API Calls Indicates the number of API calls logged for this MQ connection. The value format is a positive integer, maximum four characters.
Backout Requests Indicates the number of MQ calls that resulted in a backout. An application issues a backout request if it encounters an error during a series of puts or gets. The value format is a positive integer, maximum four characters.
Busy TCBs Indicates the number of busy CICS MQ task control blocks (TCBs) that are in use for this MQ connection. The value format is an integer, maximum four characters, and in the range 0-50.
CICS 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.
Commit Requests Indicates the number of calls issued to commit operations for MQ resources. The value format is a positive integer, maximum four characters.
Connection Status Indicates the status of the connection for MQ services. These are the values:
- Connected
- Connecting
- Force
- Inactive
- Invalid
- Not Installed
- Pending
- Quiescing
- Shutdown
- Unsupported
Inflight Tasks Indicates the number of CICS MQ tasks that are currently in the process of being completed for this MQ connection. The value format is a positive integer, maximum four characters.
Miscellaneous Requests Indicates the number of special or undocumented calls for MQ resources. The value format is a positive integer, maximum four characters.
MQClose Requests Indicates the number of MQClose calls applications issued to close the queue. The value format is a positive integer, maximum four characters, and in the range 0 to no limit.
MQGet Requests Indicates the number of MQGet calls applications issued for getting messages from the queue. The value format is a positive integer, maximum four characters.
MQInq Requests Indicates the number of MQInq calls applications issued to determine the attributes of a queue. The value format is a positive integer, maximum four characters.
MQOpen Requests Indicates the number of MQOpen calls applications issued to open the queue. The value format is a positive integer, maximum four characters.
MQPut Requests Indicates the number of MQPut calls applications issued for putting messages on the queue. The value format is a positive integer, maximum four characters.
MQPut1 Requests Indicates the number of MQPut1 calls issued by the server application. The value format is a positive integer, maximum four characters.
MQSet Requests Indicates the number of MQSet calls applications issued to a queue. The MQSet command enables an application to change some attributes of a queue. The value format is a positive integer, maximum four characters.
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, 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.
Queue Manager Name Indicates the four character name assigned to the CICS WebSphere MQ queue manager for message queuing services. The value format is an alphanumeric string, maximum four characters, and case-sensitive.
Run OK Count Indicates the number of MQ calls that have been successfully completed. The value format is a positive integer, maximum four characters.
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.
VTAM Applid Indicates the eight character name that specifies the VTAM applid of the CICS region.