Current Queue Manager Status attributes
Use the Current Queue Manager Status attributes to display the most current status information that is associated with the related queue manager. You can specify one or more attributes that define the data to be displayed. The attributes can be specified in any order, but do not specify the same parameter more than once. Use the Current Queue Manager Object attributes to create situations for monitoring the status of queue manager or command server.
% Max Active Channels The number of active channel connections as percentage of the maximum number of active channels. The valid value is a decimal in the range 0.0 - 100.0.
% Max Channels The number of current channel connections as a percentage of the maximum number of current channels. The valid value is a decimal in the range 0.0 - 100.0.
Active Channel Connections The number of active channel connections. The valid format is an integer. This attribute is always set to be n/a for distributed systems.
Active Log Copy 1 Dataset Name The name of the first copy of the current active log data set. The valid format is an alphanumeric string of up to 44 case-sensitive characters.
Active Log Copy 2 Dataset Name The name of the second copy of the current active log data set. The valid format is an alphanumeric string of up to 44 case-sensitive characters.
Channel Health Indicator of the channel health. Possible values are as follows:
- 15 (Critical)
- If there is one or more current channel connections that are not running (default of CCNRC)
- If current channel connections exceeds 90% (default of CMCPC) of the maximum number of current channels
- If active channel connections exceeds 90% (default of CMAPC) of the maximum number of active channels
- 10 (Warning)
- If there is one or more indoubt channel connections (default of CIDBW)
- If current channel connections exceeds 80% (default of CMCPW) of the maximum number of current channels
- If active channel connections exceeds 80% (default of CMAPW) of the maximum number of active channels
- If there are more than 100 server channel connections (default of CSERW)
- 5 (OK)
- 0 (Unknown) If the queue manager is stopped
Channel Health Thresholds The threshold value that is used to evaluate the channel health indicator and queue manager health indicator. For performance considerations, you can disable the evaluation or change the threshold value by customizing the associated queries. Use one of the following syntaxes in the query:
- CHLTHRESH = 'NONE'
- CHLTHRESH = 'CCNRC= integer,CIDBW= integer,CMAPC= integer,CMAPW= integer,CMCPC= integer, CMCPW= integer,CSERW= integer'
where:
- NONE
- Disables the data collection of realtime channel metrics. The channel health status and the queue manager health status are not evaluated.
- CCNRC
- Specifies the critical threshold for the number of current channel connections that are not running. If the number of current channel connections that are not running (Current Channel Connections Not Running) is greater than the specified value, the Channel Health attribute is Critical. The default value is 0.
- CIDBW
- Specifies the warning threshold for the number of the indoubt channel connections. If the number of the indoubt channel connections (Indoubt Channels) is greater than the specified value, the Channel Health attribute is Warning. The default value is 0.
- CMAPC
- Specifies the critical threshold for the number of active channel connections as a percentage of the maximum number of active channels. If the percentage (% Max Active Channels) is greater than the specified value, the Channel Health attribute is Critical. The default value is 90.
- CMAPW
- Specifies the warning threshold for the number of active channel connections as a percentage of the maximum number of active channels. If the percentage (% Max Active Channels) is greater than the specified value, the Channel Health attribute is Warning. The default value is 80.
- CMCPC
- Specifies the critical threshold for the number of current channel connections as a percentage of the maximum number of current channels. If the percentage (% Max Channels) is greater than the specified value, the Channel Health attribute is Critical. The default value is 90.
- CMCPW
- Specifies the warning threshold for the number of current channel connections as a percentage of the maximum number of current channels. If the percentage (% Max Channels) is greater than the specified value, the Channel Health attribute is Warning. The default value is 80.
- CSERW
- Specifies the warning threshold for the number of the server channel connections. If the number of server channel connections (Server Connections) is greater than the specified value, the Channel Health attribute is Warning. The default value is 100.
Channel Initiator Status The status of the channel initiator reading. Valid values are n/a = -1, Stopped = 0, Starting = 1, Running = 2, Stopping = 3, and Retrying = 4.
Command Prefix The command prefix for identifying the subsystem. The valid format is an alphanumeric string of up to 8 characters.
Command Server Status The status of the command server. Valid values are as follows:
- NotResponding = -2
- n/a = -1
- Stopped = 0
- Starting = 1
- Running = 2
- Stopping = 3
- Retrying = 4
- Waiting = 5
Connection Count Indicates the current number of connection to the queue manager. The valid format is an integer.
Current Channel Connections The number of current channel connections. The valid format is an integer. This attribute is always set to be n/a for distributed systems.
Current Channel Connections Not Running The number of current channel connections that are not running.
Current Log The name of the log extent that is written to at the time that the DISPLAY QMSTATUS command is processed. It is blank for non-linear logging. The valid format is an alphanumeric string of up to 24 case-sensitive characters. This attribute is always blank for z/OS systems.
Current MQEvents The number of rows that the current events table holds in memory.
DLQ Depth The current depth of the dead letter queue.
Get Inhibited Queue Count The number of queues that are get-inhibited.
High Depth Queue Count The number of queues that exceed the high depth threshold.
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.
In Doubt Connections The number of the indoubt channel connections.
Installation Name The MQ installation name that is associated with this queue manager. This attribute is always set to be n/a for z/OS systems.
Installation Path The installation path of this queue manager. This attribute is always set to be n/a for z/OS systems.
LPAR Name The LPAR name of the processor configuration. This attribute is for z/OS systems and is retrieved from the extended communications vector table (ECVT).
Max Active Channels The maximum number of channels that can be active at any time. Valid value is an integer. The default value is specified by the Max Channels attribute. On z/OS systems, the value must be in the range 1 - 9999. On other systems, the value must be in the range 1 - 65535.
Max Channels The maximum number of channels that can be current (including server-connection channels with connected clients). The valid value is an integer. On z/OS systems, the value must be in the range 1 - 9999, with a default value of 200. On other systems, the value must be in the range 1 - 65535, with the a default value of 100.
Media Recovery Log The name of the oldest log extent that is required by the queue manager to perform media recovery. It is blank for nonlinear logging. The valid format is an alphanumeric string of up to 24 case-sensitive characters. This attribute is always blank for z/OS systems.
Not Being Read Queue Count The number of queues that are not being read as defined by them having one or more messages, being open for output by a writing application, but not being open for input by a reading application.
Oldest Active UOW Log Dataset Name The name of the oldest active UOW log data set. The valid format is an alphanumeric string of up to 44 case-sensitive characters. This attribute is always blank for distributed systems.
Open Queue Count The number of queues that are open for input or output.
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.
Page Set Recovery Log Dataset Name The name of the log data set that contains the oldest restart Relative Byte Address (RBA) of any page set for the queue manager. The valid format is an alphanumeric string of up to 44 case-sensitive characters. This attribute is always blank for distributed systems.
Permit Standby Indicates whether the queue manager permits standby queue manager instances. This attribute has the following valid values:
- n/a = -1 (z/OS systems only)
- No = 0
- Yes =1
Put Inhibited Queue Count The number of queues that are put-inhibited.
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 Status The current execution status of the queue manager. The valid values are as follows:
- n/a = -1
- Stopped = 0
- Starting = 1
- Running = 2
- Quiescing = 3
- Stopping = 4
- Standby=5
QMgr Type Type of the operating system where this queue manager is running. Valid values are as follows:
- MVS = M
- AIX = A
- OS2 = O
- NT = N
- HPUX = H
- OS400 = 4
- Solaris = S
- Guardian = G
- Windows = W
- Linux = L
- UNIX = U
- VMS = V
- NSK = K
- VSE = E
- n/a = R
Queue Health Indicator of the queue health. Possible values are as follows:
- 15 (Critical)
- If there is one or more queues exceeding the high depth threshold (default of QHDPC)
- If there are more than 15 messages on transmission queues (default of QXQMC)
- 10 (Warning)
- If the current depth of the dead letter queue is greater than 1 (default of QDLQW)
- If there is one or more put-inhibited queues (default of QPIHW)
- If there is one or more get-inhibited queues (default of QGIHW)
- If there is one or more messages on transmission queues (default of QXQMW)
- 5 (OK)
- 0 (Unknown) If the queue manager is stopped
Queue Health Thresholds The threshold value that is used to evaluate the queue health indicator and queue manager health indicator. For performance considerations, you can disable the evaluation or change the threshold value by customizing the associated queries. Use one of the following syntaxes in the query:
- QTHRESH = 'NONE'
- QTHRESH = 'QDLQW= integer,QHDPC= integer,QGIHW= integer,QPIHW= integer,QXQMC= integer,QXQMW= integer'
where:
- NONE
- Disables the data collection of realtime queue metrics. The queue health status and the queue manager health status are not evaluated.
- QDLQW
- Specifies the warning threshold for the number of total messages on dead letter queues. If the number of total messages on dead letter queues (DLQ Depth) is greater than the specified value, the Queue Health attribute is Warning. The default value is 1.
- QHDPC
- Specifies the threshold against which the number of messages on a queue is compared to determine whether the queue depth has become greater than or equal to the queue depth high limit. The value is expressed as percentage of the maximum queue depth. Valid value is 0 - 100. If the value is 0, the QDepthHighLimit parameter value is used as the high depth threshold. The queue that exceeds a queue depth of the QDepthHighLimit value is identified as a queue that reaches its queue depth high limit.
- If the value is greater than 0, the queue that exceeds a queue depth of the QHDPC value is identified as a queue that reaches the queue depth high limit.
- If there is one or more queues that reach the queue depth high limit (High Depth Queue Count > 0), the Queue Health attribute is Critical.
- The default value is 0.
- QGIHW
- Specifies the warning threshold for the number of get inhibited queues. If the number of get inhibited queues (Get Inhibited Queue Count) is greater than the specified value, the Queue Health attribute is Warning. The default value is 0.
- QPIHW
- Specifies the warning threshold for the number of put inhibited queues. If the number of put inhibited queues (Put Inhibited Queue Count) is greater than the specified value, the Queue Health attribute is Warning. The default value is 0.
- QXQMC
- Specifies the critical threshold for the number of total messages on transmission queues. If the number of total messages on transmission queues (Total Messages on XMIT Queues) is greater than the specified value, the Queue Health attribute is Critical. The default value is 15.
- QXQMW
- Specifies the warning threshold for the number of total messages on transmission queues. If the number of total messages on transmission queues (Total Messages on XMIT Queues) is greater than the specified value, the Queue Health attribute is Warning. The default value is 1.
Queue Manager Health Indicator of the queue manager health. Possible values are as follows:
- 15 (Critical) if the queue manager status is quiescing, stopping, stopped, or n/a
- 10 (Warning)
- If the queue manager status is starting
- If the channel initiator status is not running
- If the command server status is not running
- If the Queue Health or Channel Health attribute value is Critical
- 5 (OK)
- If the queue manager, the channel initiator, and the command server are all running
- If the queue manager status is standby
Recovery Log Path Location of the recovery log extents. The valid format is an alphanumeric string of up to 1024 case-sensitive characters. This attribute is always blank for z/OS systems.
Restart Recovery Log The name of the oldest log extent that is required by the queue manager to perform restart recovery. It is blank if not linear logging. This attribute is always blank for z/OS systems.
Server Connections The number of server connections.
Start Date The date when this queue manager is started. This attribute is not displayed on the portal by default. To display it, create a query to customize the workspace.
Start Time The time when this queue manager is started. This attribute is not displayed on the portal by default. To display it, create a query to customize the workspace.
Sysplex Name The sysplex name that is used for debugging. This attribute is for z/OS systems and is retrieved from the extended communications vector table (ECVT).
Total Messages The number of messages that are on all queues.
Total Messages on XMIT Queues The number of messages that are on transmission queues.