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:
- SORT(TRAN) sorts by Transaction ID. This is the
default.
- SORT(QUEUE) sorts by WebSphere Queue name.
- SORT(TRAN,QUEUE) sorts by Transaction ID, then
Queue name.
- 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