Managers attributes

The Managers attributes provide performance statistics and summary information for all of your queue managers. Use this attribute group to query dead-letter queue usage and in-doubt channels. You can also use this group to detect performance problems with the log manager, buffer manager, or message manager components of a queue manager on a z/OS system. For example, you can create situations for detecting unavailable log manager buffers or a shortage of buffer pools. Managers is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.

# of ApplIDS The number of entries in the trace data set for this object. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer. This attribute is for z/OS systems only.

# of Page Sets The number of page sets that are defined. The valid format is an integer in the range 0 - 100. This attribute is for z/OS systems only.

# of Pools In Use Number of buffer pools that are in use by this queue manager. The valid format is an integer in the range 0 - 4. This attribute is for z/OS systems only.

# of Queues The number of queues that are accessed by an application, transaction, or program running on this queue manager. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer. This attribute is for z/OS systems only.

# of Qs Get-Inhib The number of monitored queues that belong to this queue manager that are get-inhibited. Users cannot issue the MQ API routine MQGET for these queues. The valid format is an integer.

# of Qs Put-Inhib The number of monitored queues that belong to this queue manager that are put-inhibited. Users cannot issue the MQ API routines MQPUT and MQPUT1 for these queues. The valid format is an integer.

# Qs with High Depth The number of monitored queues that belong to this queue manager that are marked as having too many messages (that is, their number of messages exceeds the high-depth threshold defined for each queue). The valid format is an integer.

# of Task IDs The number of task IDs that are associated with this queue manager, application, program, or CICS transaction that are active at the time of the last data sample. This information is only available if Application Queue Statistics are collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer.

# of Tran/Pgms The number of unique CICS transactions or program names. This information is only available if Application Queue Statistics are collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer. This attribute is for z/OS systems only.

% Current Active Log Full The percent full of the first copy of the current active log. The valid format is an integer.

% Failed Look ahead Tape Mounts The percentage of attempted look ahead tape mounts that fail. The valid format is an integer.

% GetPg Outside Pool The percentage of get-page requests that are not resolved from the buffer pool. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

% of Busy Tape Units The percentage of maximum allowable allocated tape units (MAXRTU) that are currently busy. The valid format is an integer.

% Qs with High Depth The percentage of monitored queues that belong to this queue manager that are marked as having too many messages (that is, their message depths exceed the high-depth threshold defined for each queue). The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0.

% Rd Log Delayed The percentage of log-read requests that were delayed because the MAXRTU data sets were already allocated. A nonzero value indicates that the queue manager has long running tasks that are backing out and having to read archive logs. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

Active Log Data set Name The name of the current active log data set, first copy. The valid format is an alphanumeric string of up to 44 case-sensitive characters.

Active Logs Available The number of active log data sets that are available for use; that is, the number of active log data sets that are not full. The valid format is an integer.

Alias Queues The number of alias queues that are monitored for this queue manager. The valid format is an integer.

Alter Date & Time The date and time that the queue manager definition is last altered. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:

C
Century (0 for 20th, 1 for 21st)
YY
Year
MM
Month
DD
Day
HH
Hour
MM
Minute
SS
Second
mmm
Millisecond

Arch Log Read % The percentage of log-read requests that must be resolved from an archive log data set. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

Archive Delay Due to Max Tape The number of read log requests that are delayed because the maximum number of tape units that can be allocated for archive data sets is reached. This limiting value is determined by the MAXRTU value in the CSQ6LOGP system parameter macro. It can be modified by issuing the SET LOG command. The valid format is an integer.

Archive Delay Unavail Resource The number of read log requests that are delayed because of an unavailable resource that is not related to the MAXRTU limit, such as tape unit availability or WTOR delay. The valid format is an integer.

Archiving Quiesced Indicates that all user update activity is currently suspended to perform archive of the active log. This occurs if the ARCHIVE LOG MODE(QUIESCE) command is issued. Possible values are as follows:

  • No = 0
  • Yes = 1
  • Unknown = 255

Auto-Defined Cluster Channels The number of automatically defined cluster-sender channels that are currently being monitored for this queue manager. The valid format is an integer.

Avg % In Use The average percentage of allocated pages that are in use across all page sets. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

Avg Extents The average number of DASD extents per page set for this queue manager. Valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

Avg Pages Allocated The average number of pages that are allocated per page set. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

Busy Archive Tapes The number of tape units that are currently busy actively processing an archive log data set. The valid format is an integer.

Checkpoints The number of checkpoints that are issued during the sampling interval. The valid format is an integer. This attribute is for z/OS systems only.

Close Hndl Per Sec The number of times per second MQ closed an object (such as a queue) independently of a call to the MQCLOSE API routine. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

Cluster QMgr Auto Clussdr The current number of cluster queue manager entries for automatically defined cluster sender channels. The valid format is an integer.

Cluster QMgr Clusrcvr The current number of cluster queue manager entries for cluster receiver channels. Valid format is an integer.

Cluster QMgr Explicit Clussdr The current number of cluster queue manager entries for explicitly defined cluster sender channels. The valid format is an integer.

Cluster Queues The number of cluster queue definitions. The valid format is an integer.

Command Server Queue Name The name of the command server queue. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Current Channels The number of currently active channels that are monitored for this queue manager. The valid format is an integer.

Current Receivers The number of currently active receiver channels that are monitored for this queue manager. The valid format is an integer.

Current Requesters The number of currently active requester channels that are monitored for this queue manager. The valid format is an integer.

Current Senders The number of currently active sender channels that are monitored for this queue manager. The valid format is an integer.

Current Servers The number of currently active server channels that are monitored for this queue manager. The valid format is an integer.

DLQ Depth The number of messages that are currently stored in the dead-letter queue (DLQ) of this queue manager. The valid format is an integer.

DLQ Maximum The maximum number of messages that can be stored in the dead-letter queue (DLQ) of this queue manager. The valid format is an integer.

DLQ Name The name that is assigned to the dead-letter queue of this queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Dynamic Perm Qs The number of monitored, permanent dynamic queues that are created for this queue manager. The valid format is an integer.

Dynamic Temp Qs The number of monitored temporary dynamic queues that are created for this queue manager. The valid format is an integer.

Event Count The total number of occurrences of all MQ events that are reported to the event queue of this queue manager. Informational only.

Full Logs To Offload The number of full active logs that are waiting to be offloaded. Valid format is an integer.

Full Page Sets The number of page sets that are full. When a page set is full, all calls to MQPUT or MQPUT1 for queues associated with that page set fail. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

GetPg I/O % The percentage of get-page requests that resulted in I/O. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

High % In Use The highest percentage of allocated pages that are in use across all page sets. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

High Extents The highest number of DASD extents across all page sets for this queue manager. The valid format is an integer. This attribute is for z/OS systems only.

Host Jobname The name of the started task or batch job that is running this queue manager. The valid format is an alphanumeric string of up to 8 case-sensitive characters. This attribute is for z/OS systems only.

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.

Inactive Channels The number of currently inactive channels that are monitored for this queue manager. The valid format is an integer.

Inactive Receivers The number of currently inactive receiver channels that are monitored for this queue manager. The valid format is an integer.

Inactive Requesters The number of currently inactive requester channels that are monitored for this queue manager. The valid format is an integer.

Inactive Senders The number of currently inactive sender channels monitored for this queue manager. The valid format is an integer.

Inactive Servers The number of currently inactive server channels that are monitored for this queue manager. The valid format is an integer.

In-Doubt Channels The number of monitored channel connections that are currently in doubt for this queue manager. A sender channel is in doubt when a logical unit of work (LUW) has been sent and the channel is waiting for an acknowledgment that the LUW has been successfully received (in other words, when a syncpoint has been requested but not yet performed). The valid format is an integer.

Interval Time The length of interval. Informational only.

Local Queues The number of local queues that are monitored for this queue manager. The valid format is an integer.

Log Write Buffer Pagein The number of times that a log write buffer needs to be paged in before it can be used. The valid format is an integer.

Log Write Threshold The number of times that a log write request is scheduled because the log write threshold is reached. This threshold is determined by the WRTHRSH value in the CSQ6LOGP system parameter macro. It can be modified by issuing the SET LOG command. The valid format is an integer.

Logging Suspended Indicates whether logging is suspended. Logging is suspended if the SUSPEND QMGR LOG command is issued. All logging and update activity for the queue manager is suspended until the RESUME QMGR LOG command is issued. The valid format is an integer. Possible values are as follows:

  • No = 0
  • Yes = 1
  • Unknown = 255

Look ahead Tape Mounts The number of look ahead tape mounts for archive data sets that are attempted. Valid format is an integer.

Low # Avail The lowest number of available (unused) buffers across all buffer pools that belong to this queue manager. The valid format is an integer. This attribute is for z/OS systems only.

Low % Avail The lowest percentage of available (unused) buffers across all buffer pools that belong to this queue manager. The valid format is an integer (formatted to one decimal place) in the range 0.0 - 100.0. This attribute is for z/OS systems only.

Message Security Indicates whether message security is active and thus whether message functions are allowed for this manager. A value of Y for Yes means message functions are not allowed. A value of N for No means message functions are allowed for this manager. The valid format is an alphanumeric string of up to 4 case-sensitive characters.

Monitored Queues The number of active queues that are monitored for this queue manager. You specify which queues to monitor when customizing the IBM MQ Monitoring agent. The dead-letter queue is always monitored. Valid format is an integer.

MQCLOSE Per Sec The number of calls or starts per second of the MQ API routine MQCLOSE for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

MQGET Per Sec The number of calls or starts per second of the MQ API routine MQGET for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

MQINQ Per Sec The number of calls or starts per second of the MQ API routine MQINQ for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

MQOPEN Per Sec The number of calls or starts per second of the MQ API routine MQOPEN for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

MQPUT Per Sec The number of calls or starts per second of the MQ API routine MQPUT for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

MQPUT1 Per Sec The number of calls or starts per second of the MQ API routine MQPUT1 for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

MQSeries Release The release level of MQ under which this queue manager is executing. The valid format is an alphanumeric string of up to 8 case-sensitive characters.

MQSET Per Sec The number of calls or starts per second of the MQ API routine MQSET for this queue manager. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

Object Creates The object create rate of the data manager per second. Informational only.

Object Deletes The data manager object delete rate of the data manager per second. Informational only.

Object Gets The data manager object get rate of the data manager per second. Informational only.

Object Locates Data manager object locate rate per second. Informational only.

Object Puts The object put rate of the data manager per second. Informational only.

Offload Task Status The current status of the offload task. Possible values are Available, Busy Allocating Archive Data set, Busy Copying Active Log, and Busy Copying BSDS. The valid format is an integer.

Open Queues The number of monitored queues that are currently open for this queue manager. The valid format is an integer.

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.

Predefined Queues The number of predefined queues that are monitored for this queue manager. Valid format is an integer.

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 status of this queue manager. The following values are valid:

Table 1. Queue manager status
Status Definition
Inactive = 0 The IBM MQ Monitoring agent is online, but the queue manager is not currently active.
Active = 1 The IBM MQ Monitoring agent is online and the queue manager is active.
Unknown = 3 The IBM MQ Monitoring agent is online, but the status of the queue manager is unknown.
QueueManager_Not_Available = 4 The IBM MQ Monitoring agent is online, but the queue manager is not available for connection.
CommandServer_Not_Responding = 5 The IBM MQ Monitoring agent is online, but is not receiving responses from the command server.
Dynamic_Queue_Allocation_Error = 6 The IBM MQ Monitoring agent is online, but is not able to dynamically allocate its reply-to queue.
Cluster_Repository_Unavailable = 7 The IBM MQ Monitoring agent is online, but the cluster repository is unavailable.
Standby = 8 The IBM MQ Monitoring agent is online, but the queue manager is now running as a standby instance and ready to become active if the existing active instance fails.
Running_Elsewhere = 9 The IBM MQ Monitoring agent is online, but the queue manager is running elsewhere.

QMgr Subsys The subsystem ID that is associated with this queue manager. The valid format is an alphanumeric string of up to 4 characters. This attribute is for z/OS systems only.

QMgr Type 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

QSG Name The name of the queue sharing group. The valid format is an alphanumeric string of up to 4 case-sensitive characters. This attribute is for QSG environment on z/OS systems only.

Queue Messages The total number of messages on all monitored queues. The valid format is an integer.

Read Log Per Min The number of read-log requests per minute. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

Remote Queues The number of remote queues that are monitored for this queue manager. The valid format is an integer.

Server Connections The total number of active server connections. Valid format is an integer.

Start Date & Time The time and date that this queue manager or channel is last started. This attribute is not applicable to remote queue managers. This information is available only for UNIX and Linux systems. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:

C
Century (0 for 20th, 1 for 21st)
YY
Year
MM
Month
DD
Day
HH
Hour
MM
Minute
SS
Second
mmm
Millisecond

StorClass Changes The storage class change rate of the data manager per second. Informational only.

Synch Writes The number of times that the synchronous page processor needs to be started because the synchronous write threshold is reached. The valid format is an integer. This attribute is for z/OS systems only.

Timeout Count The number of system command reply timeouts that occur during the most recent sampling cycle for the current queue manager. If the queue manager does not respond to an information request from the IBM MQ Monitoring agent within 30 seconds, the agent considers it a timeout and stops waiting for a response. In this case, data is missing from the last sample.

For a non z/OS queue manager, it is the number of consecutive timeouts, which indicates the number of samples missed. If this parameter is nonzero, there might be a serious performance or availability problem with this queue manager. The valid format is an integer.

Total Channels The total number of active channels and inactive channels. The valid format is an integer.

Transmit Queues The number of transmission queues that are monitored for this queue manager. The valid format is an integer.

Unavailable Page Sets The number of defined page sets that are not available for use. The valid format is an integer in the range 0 - 100. This attribute is for z/OS systems only.

Write Log Per Min The number of write-log requests per minute. The valid format is an integer (formatted to one decimal place). This attribute is for z/OS systems only.

Write Requests Suspended The number of times that a request to write data to buffers is suspended. The valid format is an integer.

Zero Bufr Waits The number of times that an application has to wait because no buffers are available in buffer pool of this queue manager. The valid format is an integer. This attribute is for z/OS systems only.

Zero Bufrs Count The number of times that an MQ application cannot get an available buffer from the buffer pool of this queue manager. The valid format is an integer. This attribute is for z/OS systems only.