Application Queue Long-Term History attributes (z/OS systems only)

Use the Application Queue Long-Term History attributes to detect a high number of messages that are put or read, or a high number of opens per second. These attributes are informational only; they cannot be used to create situations.

The Application Queue Long-Term History attributes are available on z/OS systems only.

Appl ID The application identifier of the MQ application that accesses the specific queue. On z/OS systems, this is the JOBNAME; in CICS, it is the VTAM Application ID; in IMS, it is the IMS subsystem ID. The valid format is an alphanumeric string of up to 12 case-sensitive characters.

Appl Type The type of monitored application. 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

Avg Appl Time Between Calls The average elapsed time between MQI calls for any instances of the selected application ID, transaction, or program. The value is expressed in seconds, accurate to the third decimal place. The valid format is a decimal (formatted to 3 decimal places).

Avg MQ Resp Time The average time that it takes for MQ to respond to all MQI calls. The value is expressed in seconds, accurate to the third decimal place. The valid format is a decimal (formatted to 3 decimal places).

Avg MQGET Resp Time The average time that it takes for MQ to respond to MQGET requests. The value is expressed in seconds, accurate to the third decimal place. The valid format is a decimal (formatted to 3 decimal places).

Avg MQPUT Resp Time The average time that it takes for MQ to respond to MQPUT requests. The value is expressed in seconds, accurate to the third decimal place. The valid format is a decimal (formatted to 3 decimal places).

Input Msg Size Avg The average size of all input messages that belong to this queue, transaction, program, or application. The valid format is an integer.

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.

Interval Length The interval time over which statistics are taken. It is in the form MMM:SS where M = Minute, S = Second.

Interval Time The size of the current sampling interval, in hundredths of seconds. For example, .50 is half a second. This value is determined by the control parameters that are set when configuring the IBM MQ Monitoring agent; it is usually specified as 60.00 (60 seconds). The valid format is a decimal (formatted to 2 decimal places).

Msgs Browsed The number of messages that belong to this queue, transaction, program, or application that are successfully browsed. The valid format is an integer.

Msgs Put The number of successfully put messages that belong to this transaction, program, or application. The valid format is an integer.

Msgs Read The number of messages belonging to this queue, transaction, program, or application that are successfully read and removed from the queue. The valid format is an integer.

Opens Per Sec The number of opens per second that this application, transaction, or program is performing or has performed during the sampling interval. This number includes MQOPEN and MQPUT1 calls. The valid format is a decimal (formatted to 2 decimal places).

Origin Node The name of the node that is assigned by the IBM MQ Monitoring agent. The data for the queue manager originates from this node.

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.

Output Msg Size Avg The average size of all output messages that belong to this queue, CICS transaction, program, or application. The 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.

Queue Name The name of the queue that is specified in the MQOPEN call of the application (MQOD_ObjectName). The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Remote QMgr Name The queue manager that is used when an application opens a queue, and the MQOD_QmgrName value is different from the local queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Sample Date & Time The date and time of the sample. 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

Tran Pgm The CICS transaction or the program name. The valid format is an alphanumeric string of up to 8 case-sensitive characters.