Queue Handle Status attributes

Use the Queue Handle Status attributes to view the most current data about which applications have a queue open. This attribute group can return multiple rows for a query, one for each queue open handle. Note that if a specific Queue Name is provided in the query to this attribute group, and that queue has no open handles, no rows are returned. No data is returned if the IBM MQ (WebSphere MQ) version requirement is not met.

If there are certain queues to be monitored by situations for Queue Handle Status, you must make a specific situation for each queue to be monitored and match the specific queue name with the Queue Name attribute as a condition in the situation. However, if you choose not to provide the queue name in the situation, only queues that are open are considered for possible match with the situation conditions specified.

Appl Type The type of application that owns the handle. Valid values are as follows:

  • Unknown = -1
  • NoContext = 0
  • CICS = 1
  • MVS = 2
  • IMS = 3
  • OS2 = 4
  • DOS = 5
  • UNIX = 6
  • QMGR = 7
  • OS400 = 8
  • WINDOWS = 9
  • CICS_VSE = 10
  • WINDOWS_NT = 11
  • VMS = 12
  • GUARDIAN = 13
  • VOS = 14
  • OPEN_TP1 = 15
  • VM = 18
  • IMS_BRIDGE = 19
  • XCF = 20
  • CICS_BRIDGE = 21
  • NOTES_AGENT = 22
  • TPF = 23
  • USER = 25
  • QMGR_PUBLISH = 26
  • JAVA = 28
  • DQM = 29
  • CHINIT = 30
  • WLM = 31
  • BATCH = 32
  • RRS_BATCH= 33
  • SIB = 34
  • SYSTEMEXT = 35
  • MCAST_PUBLISH= 36
  • SYSTEM = 101
  • USER = 65536

Application Tag The tag name identifies the application that owns the handle. For example, one of the following applications that are connected to the queue manager: z/OS batch job name, TSO USERID, CICS APPLID, IMS region name, Channel initiator job name, i5/OS job name, UNIX process, Windows process. The valid format is an alphanumeric string of up to 28 case-sensitive characters.

ASID The address space identifier of the application that opens the queue; the value is blank on non z/OS systems or on z/OS systems when the application type is Queue Manager. The valid format is an alphanumeric string of up to 4 case-sensitive characters.

Asynch State The state of the asynchronous consumption on this object handle. This attribute has the following valid values:

  • None = 0
  • Suspended = 4
  • SuspendedTemp = 5
  • Active = 6
  • Inactive = 7
  • n/a = 255

Channel Name The name of the channel that owns the handle if the handle belongs to the channel initiator; blank when no channel is associated with the handle. The valid format is an alphanumeric string of up to 20 case-sensitive characters.

CICS Region Name The CICS region name if Appl Type is CICS; otherwise blank. The valid format is an alphanumeric string of up to 8 case-sensitive characters. This attribute is for CICS applications on z/OS systems only.

CICS Task No The CICS 7-digit task number if Appl Type is CICS; otherwise blank. The valid format is an alphanumeric string of up to 8 case-sensitive characters. This attribute is for CICS applications on z/OS systems only.

CICS Trans ID The CICS transaction identifier if Appl Type is CICS; otherwise blank. The valid format is an alphanumeric string of up to 4 case-sensitive characters. This attribute is for CICS applications on z/OS systems only.

Connection Name The name of the connection that is associated with the channel that owns the handle if the channel belongs to the channel initiator; blank when no channel is associated with the handle. The valid format is an alphanumeric string of up to 264 case-sensitive characters.

External Unit of Recovery ID The external unit of recovery identifier that is associated with the connection. The valid format is an alphanumeric string of up to 264 case-sensitive characters.

External Unit of Recovery Type The type of external unit of recovery identifier as perceived. The external unit of recovery type identifies the external unit of recovery identifier type and not the type of the transaction coordinator. When the value of the external unit of recovery type is QMGR, the associated identifier is in the queue manager unit of recovery identifier, and not the external unit of recovery identifier. Valid values are as follows:

  • n/a = -1,
  • QMGR = 0,
  • CICS = 1 (z/OS systems only),
  • RRS = 2 (z/OS systems only),
  • IMS = 3 (z/OS systems only),
  • XA = 4

Handle Status The state 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.

IMS PSB Name The name of the IMS Program Specification Block that is associated with the running IMS transaction if Appl Type is IMS; otherwise blank. The valid format is an alphanumeric string of up to 8 case-sensitive characters. This attribute is for IMS applications on z/OS systems only.

IMS PST ID The IMS Program Specification Table region identifier for the connected IMS region if Appl Type is IMS; otherwise blank. The valid format is an alphanumeric string of up to 4 case-sensitive characters. This attribute is for IMS applications on z/OS systems only.

Open for Browse Indicates whether the queue is open for browsing. Valid values are No = 0 and Yes = 1.

Open for Input Indicates whether the queue is open for input. If so, further describes the type of open for input. Valid values are No = 0, Shared = 1, and Exclusive = 2.

Open for Inquire Indicates whether the queue is open for inquiring. Valid values are No = 0 and Yes = 1.

Open for Output Indicates whether the queue is open for output. Valid values are No = 0 and Yes = 1.

Open for Set Indicates whether the queue is open for setting. Valid values are No = 0 and Yes = 1.

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.

Process ID The process identifier of the application that owns the handle; this is the application that opened the queue. Valid values are an integer process identifier or n/a = -1 on a z/OS system.

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.

QMgr Unit of Recovery ID The queue manager unit of recovery identifier. On z/OS systems, this is a 6-byte log RBA, displayed as 12 hexadecimal characters. On systems other than z/OS systems, this is an 8-byte transaction identifier, displayed as m.n where m and n are the decimal representation of the first and last 4 bytes of the transaction identifier.

You can use the queue manager unit of recovery identifier as a filter keyword. On z/OS systems, you must specify the filter value as a hexadecimal string. On systems other than z/OS systems, you must specify the filter value as a pair of decimal numbers separated by a period (.). You can only use the EQ, NE, GT, LT, GE, or LE filter operators.

QSG Disp Disposition of the queue in a queue-sharing group environment. Valid values are Qmgr = 0, Copy = 1, Shared = 2, and Unknown = 255. This attribute is for QSG environment on z/OS systems only.

Queue Name The name of a queue that is managed by the selected queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

RRS UR ID The hexadecimal character form of the 16-byte RRS Unit-of-Recovery identifier that is associated with the handle if Appl Type is RRS Batch; otherwise blank. Valid format is an alphanumeric string of up to 32 case-sensitive characters. This attribute is for RRS Batch applications on z/OS systems only.

Thread ID The thread identifier of the thread in the application that owns the handle; this is the application that opened the queue. Valid values are an integer thread identifier or n/a = -1 on z/OS systems.

User ID The user identifier that is associated with the handle. The valid format is an alphanumeric string of up to 64 case-sensitive characters.