MQ Series - add support for the WebSphere MQ v.6 monitoring functions for Queues and Channels.

TPFUG_Req_Number: MQ07001F
Contact Originator Id: bryan.alison@worldspan.com
Abstract: This MQ Series enhancement will add support for providing statistical information related to real-time queue and channel usage, in conjunction with the local Queue Manager as well as with connections to remote Queue Managers.
Description: MQ series on distributed platforms provides the ability to turn on monitoring for specific queues and channels, as well as at the Queue Manager level. These levels of monitoring allow the user to display, using the DISPLAY QSTATUS and DISPLAY CHSTATUS entries, information such as:

DIS QSTATUS fields:
MONQ(MEDIUM) - can specify a level of monitoring (sampling) to be done on the queue
QTIME(11892157,24052785) - the time in microsecs. msgs remain on queue before being destructively read
MSGAGE(37) - the age, in seconds, of the oldest message on the queue
LPUTDATE(2005-03-02) - last date when a message was put to this queue
LPUTTIME(09.52.13) - last time when a message was put to this queue
LGETDATE(2005-03-02) - last date when a message was retrieved from this queue
LGETTIME(09.51.02) - last time when a message was retrieved from this queue






DIS CHSTATUS fields:
MONCHL(MEDIUM) - can specify a level of monitoring (sampling) to be done on the channel
XQTIME(755394737,755199260) - the time in microsecs. msgs remain on the xmitq before being retrieved
NETTIME(13372,13372) - amt of time, in microsecs. to send a msg to remote end of chl & rcv a response
EXITTIME(0,0) - amt of time in microsecs. spent processing user exits per msg.
XBATCHSZ(50,50) - size of the batches transmitted over the channel (short term, longer term)

*Note: Where two values are displayed, the first is a short-term view and the second is a longer-term view.
Additional information can be gleaned from IBM Manuals WebSphere MQ Script (MQSC) Command Reference (SC34-6597-00) and WebSphere MQ Monitoring WebSphere MQ (SC34-6593-00), "Part 5. Real-time monitoring".

Some of this information is already available on TPF. For instance, the ZMQSC
DIS CHS command today provides the LST MSG TIM and LST MSG DAT information for
messages going across the channel. The ZMQSC DIS QL-… STAT command provides
some helpful statistics on the GET COUNT, RATE & RATEHIGH levels for the
queue. The added features noted above would be very helpful additions to what
TPF MQ provides today. Additionally, the NETTIME feature on the channel status
display should be tied into the remote end of the channel connection, so that
both SENDER and RECEIVER channels, on both sides of the channel connection,
will communicate the necessary information to each other for display purposes.
Critical Success Factors: Do the changes emulate, interoperate with and/or support existing MQ v.6 monitoring on remote systems?
Solution Considerations: The Systems/MQ Administrator should be able to update the Queue and Channel parameters to enable real-time monitoring by specific channel and/or queue as well as by setting the monitor parm on each object to QMGR, and be able to turn on monitoring at the Queue Manager level for all objects so defined. This is reflected well in the documentation previously cited. It is supported in both Distributed and z/OS MQ processing. I can provide further detail, if needed.

Additionally, it would be helpful to be able to monitor/access the statistical information both via command line status inputs/displays and programmatically, for those who would like to write applications to access and use the information.
The following TPF operator commands should be enhanced/updated to support this functionality:
ZMQSC DIS/ALTER QMGR-
ZMQSC DIS/ALTER QL-
ZMQSC DIS QL-queue.name STAT
ZMQSC DIS/ALTER CHL-
ZMQSC DIS CHS-