Overview of MQSeries data extractor

In order to use the MQSeries® Performance Analysis Reports, the MQSeries data extractor must be turned on when the Observation Request is entered. You must select the MQS data extractor in the Enter an Observation Request panel.

This data extractor provides the ability to observe/sample and report on MQSeries interface calls (both dynamic and static) in Batch, IMS™ and CICS® programs. More specifically, to show the CPU and wait time spent in MQSeries interface calls and to attribute the time spent to a particular MQSeries interface call.

When the MQSeries data extractor is selected, Application Performance Analyzer will record the following information in the sample file for each MQSeries call that it observes:

Environment (Batch, IMS or CICS)
Load module that issued the call
Offset within the load module of the return address from the MQ call
Type of MQI call (MQOPEN, MQGET, etc.)
Queue Manager name
Object name (for example, the queue name)
Message size (actual length for MQPUT/MQPUT1, buffer length for MQGET)
MQ Options (for MQOPEN, MQGET, MQPUT MQCLOSE)
Message type, priority and persistence
Transaction ID (CICS and IMS)

Note: In an IMS environment, Application Performance Analyzer might not be able to determine the default Queue Manager name for some samples if the Application Performance Analyzer task has not previously sampled any. This might result in the MQ object name being unknown for the first few calls. Subsequent sampling runs will obtain the MQ object name for each sample.

The MQ+ extractor

MQ+ is a measurement option where the precise number of MQ calls, the exact MQ service time, and CPU time by MQ call are counted. When you select the MQ+ option, Application Performance Analyzer captures the data that is required to produce the MQ+ timeline and service time reports Q11 through Q14.

Selecting the MQ+ option has a small impact on the performance of the target address space. Be careful when you use the MQ+ feature with other products that also intercept MQ calls because unpredictable results might occur. Your installer can choose to limit access to this feature.