Connection Objects attributes
Use the Connection Object attributes to create situations for monitoring the status of handle. The Connection Objects attributes display connection information about the applications that are connected to the queue manager. Use these attributes to identify applications with long-running units of work. If an attribute is specified that is not relevant for the connection, operating environment, or type of status information requested, that parameter is ignored.
Asynchronous State The state of the asynchronous consumer on this object handle. Valid values are as follows:
- n/a = 255
- NONE = 0
- SUSPENDED = 4
- SUSPENDEDTEMP = 5
- ACTIVE = 6
- INACTIVE = 7
Connection ID The identifier of the connection. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Conn ID Prefix (EXTCONN) Character hexadecimal representation of the prefix of connection ID. The valid format is an alphanumeric string of up to 32 characters.
Conn ID Suffix (CONN) Character hexadecimal representation of the suffix of connection ID. The valid format is an alphanumeric string of up to 16 characters.
Destination The destination queue for messages that are published to this subscription. This parameter is only relevant for handles of subscriptions to topics. Valid format is an alphanumeric string of up to 48 characters.
Destination Qmgr The destination queue manager for messages that are published to this subscription. The valid format is an alphanumeric string of up to 48 characters.
Handle Status This attribute is the status of the handle. Valid values are n/a = -1, Inactive = 0, and Active = 1.
Host Name The name of the system on which this queue manager is running. On z/OS systems, this is the SMF ID. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Object Name The name of an object that the connection has opened. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Object Type The type of the object that the connection has opened. Valid values are as follows:
- n/a = -1,
- Queue = 1,
- NameList = 2,
- Process = 3,
- StorageClass= 4,
- QMgr = 5,
- Channel = 6,
- AuthInfo = 7,
- TOPIC = 8
Open Options The open options that are currently in force for the connection for the object. The valid format is an alphanumeric string of up to 8 case-sensitive characters.
Origin Node The IBM MQ Monitoring agent-assigned name of the node on which the data for the queue manager originates.
On z/OS systems, this name takes the form qmgr:smfid:MQESA, where qmgr is the name of the queue manager and smfid is the z/OS system ID or SMF ID.
On distributed systems, this name takes the form qmgr::MQ. If the host ID value is specified by the SET AGENT command, this name takes the form qmgr:hostid:MQ. The valid format is an alphanumeric string of up to 128 case-sensitive characters.
QMgr Name The name that is assigned to this queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters. This attribute is for z/OS systems only.
QSG Disp Indicates the disposition of the object in QSG environment. Valid values are QMgr = 0, Copy = 1, Shared = 2, and Unknown = 255.
Read Ahead The read ahead connection status. Valid values are as follows:
- NO = 0
- YES = 1
- INHIBITED = 3
- BACKLOG = 4
Subscription ID The internal, all-time unique identifier of the subscription. This parameter is relevant only for handles of subscriptions to topics. The valid format is an alphanumeric string of up to 24 characters.
Sub Name The unique subscription name of the application that is associated with the handle. This parameter is relevant only for handles of subscriptions to topics. Not all subscriptions will have a subscription name. The valid format is an alphanumeric string of up to 256 characters.
Topic String The resolved topic string. This parameter is relevant for handles with OBJTYPE(TOPIC). It is blank for any other object type. The valid format is an alphanumeric string of up to 256 characters.