MQ - WebSphere MQ report

The MQ operand requests the WebSphere® MQ report.

Note: WebSphere MQ accounting records are produced when the Accounting Trace component of WebSphere MQ is activated. If the MQ accounting trace is active, CLASS(1) subtype 0 records are always produced, but subtypes 1 and 2 are only produced if CLASS(3) is specified when the trace is activated.

See the WebSphere MQ for z/OS® System Setup Guide for more information on accounting for WebSphere MQ resources and the setup required.

The command format is:
CICSPA MQ(
         [OUTPUT(ddname),]
         [LIST,]
         [SUMMARY,]
         [CLASS1|CLASS3,]
         [SORT([TRAN,][QUEUE]),]
         [QNAME(name),]
         [SSID(id1,id2,...),]
         [LINECount(nnn),]
         [TITLE1('...sub-heading left ...'),]
         [TITLE2('...sub-heading right...'),]
         [SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),
                            ...))])
The options are:
OUTPUT
Controls the report output DDname. If not specified, CICS PA assigns a DDname in the format MQ00nnnn where nnnn is the report sequence number 0001-9999. See OUTPUT for further information.
LIST
Requests the WebSphere MQ List report.
SUMMARY
Requests the WebSphere MQ Summary report.
CLASS1|CLASS3
CLASS1 requests the reports to process MQ Class 1 records. This is the default.

CLASS3 requests the reports to process MQ Class 3 records.

If the List report is requested, CLASS1 and CLASS3 cannot both be specified because of the different report formats.

SORT
Specifies the required sorting sequence of the Class 3 Summary report. The choices are:
  1. SORT(TRAN) sorts by Transaction ID. This is the default.
  2. SORT(QUEUE) sorts by WebSphere Queue name.
  3. SORT(TRAN,QUEUE) sorts by Transaction ID, then Queue name.
  4. SORT(QUEUE,TRAN) sorts by Queue name, then Transaction ID.
QNAME
Selects records for a particular WebSphere MQ queue name. You can specify a pattern such as CICSMQ* to include more than one queue name. The queue name is case-sensitive.
SSID
Requests reporting to be limited to the MQ Subsystem IDs that match the specified IDs or patterns. Masking characters are supported: % for one and only one character, and * for many or none.
LINECount
Controls the number of lines per page. See LINECount for further information.
TITLE1, TITLE2
Controls the report title (left and right half of subheading line). See TITLE1 and TITLE2 for further information.
SELECT(PERFORMANCE(INCLUDE|EXCLUDE
Specifies what data to include or exclude from the report based on data field values. See Using SELECT statements for a detailed explanation and examples.
The fields that can be specified in Selection Criteria for filtering MQ accounting (SMF 116) records are:
APPLID
CICS® APPLID
TRAN
CICS Transaction ID
TASKNO
CICS Task ID
START
Thread Start Time
STOP
Thread End Time
ACTIVE
Thread Begin-End Time