The WebSphere® MQ report
processes WebSphere MQ
SMF accounting (SMF 116) records to produce a detailed view of WebSphere MQ usage by your CICS® systems.
The WebSphere MQ List
reports provide, depending on the WebSphere MQ
accounting traces that are active, details about:
- Transactions
- WebSphere MQ Queues
that were referenced
- WebSphere MQ global
(not Transaction-specific or Queue-specific) statistics
- WebSphere Queue-specific
commands issued by Transaction
These can be sorted and aggregated by Transaction ID or Queue
name or both.
To request the report, enter line action
S against the
WenSphere
MQ Subsystem Report on the Report Set panel. If reports of this
type have been previously specified, the list of WebSphere MQ Reports is displayed. Otherwise,
the WebSphere MQ panel
is displayed for you to define your first report of this type.
Figure 1. WebSphere MQ Reports File Filter Edit Systems Options Help
------------------------------------------------------------------------------
SAMPLE - WebSphere MQ Reports Row 1 from 2
Command ===> ________________________________________________ Scroll ===> ____
---- System Selection ----- Selection
/ Exc MQ SSID + Image + Group + Output Criteria
_ ____ ________ ________ MQ000001 NO
_ ____ ________ ________ MQ000002 NO
********************************* End of list *********************************
This panel displays the list of WebSphere MQ
reports in this Report Set. You can select (edit), delete, or include/exclude
any report, insert new ones, or rearrange them (move/copy).
The options are:
- System Selection
- System Selection identifies the MQ Subsystems and associated SMF
files that you want to report against. MQ System Selection can be
specified here or on the WebSphere MQ
Report panel. For details, see the description of this option following
the next figure.
- Output
- CICS PA provides
a default Report Output DDname in the format MQ00nnnn where
nnnn is 0001-9999.
The line actions are the same as on similar Reports list panels.
See Performance List report.
Enter line action
S to select a report in the list.
Figure 2. WebSphere MQ Report File Systems Options Help
------------------------------------------------------------------------------
SAMPLE - WebSphere MQ Report
Command ===> _________________________________________________________________
MQ System Selection: Report Output:
SSID . . . ____ + DDname . . . . . . . . . MQ000001
Image . . ________ + Print Lines per Page . . ___ (1-255)
Group . . ________ +
Reports Required: Process Accounting Class Records:
_ List report 1 1. Class 1
/ Summary report 2. Class 3
Sort Summary by:
1 1. Transaction 2. Queue 3. Transaction/Queue 4. Queue/Transaction
Report Filter:
Queue Name ___________________________________________
Report Format:
Title . . ________________________________________________________________
________________________________________________________________
Selection Criteria:
_ Performance
F1=Help F3=Exit F4=Prompt F7=Backward F8=Forward F10=Actions
F12=Cancel
Use this panel to specify report options and record selection criteria
for the WebSphere MQ report.
The only mandatory option is the Report Output DDname. You can let
the other options default.
The options are:
- MQ System Selection
- System Selection identifies the MQ Subsystems and associated SMF
files that you want to report against. Any combination of MQ SSID,
Image, or Group can be specified but must be defined in System Definitions.
You can use Prompt (F4) to select from a list. To link directly
to System Definitions, select Systems in the action bar.
Specify
either:
- An MQ SSID.
- An MQ SSID for a particular Image. This identifies a particular
MQ Subsystem when there is more than one with the same ID.
- An Image. CICS PA will
report on all MQ systems running on this Image using the SMF files
defined for the Image.
- An MQ SSID and Image combination plus a Group. This is useful
to uniquely identify a system when there is more than one of the same
name defined in System Definitions.
- A Group alone. CICS PA will
report on all MQ systems in the Group to produce a single consolidated
report.
CICS PA uses
the System Selection in JCL generation to build the SSID(ssid1,ssid2,ssid3,...)
and INput(SMFIN001,SMFIN002,SMFIN003,...) operands,
and corresponding //SMFINnnn DD statements.
- Report Output DDname
- The DDname for the report output which CICS PA uses
when generating the JCL to run the Report Set. The DDname is mandatory
and should be unique to separate the output of multiple reports.
CICS PA assigns
a default DDname MQ00nnnn where nnnn is a sequential number 0001-9999 to
ensure each report has a unique DDname.
This option generates
the OUTPUT(ddname) operand.
- Print Lines per Page
- The maximum number of lines, including headings, to print on each
page of the report. Valid values are from 1 to 255. The default is 60.
The
global value applies to all reports. If a value is specified on this
report panel, the report value takes precedence over the global for
this report only.
CICS PA JCL
generation translates this field to the LINECount(nnn) operand.
- Reports Required
- Enter / to select the reports you want produced.
- Select List to request the WebSphere MQ List report. This selection
generates the LIST operand.
- Select Summary to request the WebSphere MQ Summary report. This selection
generates the SUMMARY operand and is the default.
- Process Accounting Class Records
- Select the type of MQ accounting data to process. Select either:
- Class 1 to request that the reports process MQ Class 1
records only. This is the default. This selection generates the CLASS1 operand.
- Class 3 to request that the reports process MQ Class 3
records only. This selection generates the CLASS3 operand.
If you need to report both Class 1 and Class 3 data, define another
MQ report. CICS PA will
produce both reports in a single pass of the data.
- Sort Summary by
- Specify the required sorting sequence of the Summary report. You
can order the Summary report by one of the following:
- Transaction ID. This generates the SORT(TRAN) operand
and is the default.
- WebSphere Queue name.
This generates the SORT(QUEUE) operand.
- Transaction ID, then Queue name. This generates the SORT(TRAN,QUEUE) operand.
- Queue name, then Transaction ID. This generates the SORT(QUEUE,TRAN) operand.
- Report Filter
- Specify a Queue name to select 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.
This option generates the QNAME(name) operand.
- Title
- Title of the report. Specify up to 128 characters of text to describe
the report. CICS PA concatenates
the two lines of 64 exactly as entered to make one line which prints
at the top of each page of the report below the heading. The default
is blank (no title).
This option generates the TITLE1('left-half') and TITLE2('right-half') operands.
- Performance Selection Criteria
- 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
- MQ Thread Begin Time
- STOP
- MQ Thread End Time
- ACTIVE
- MQ Thread Begin-End Time
Line Actions:
Valid line actions are:- ⁄
- Display the menu of line actions.
- S
- Select to display the subpanel where Selection Criteria can be
specified for this report. For details, see Specifying Selection Criteria.
- A
- Activate the Selection Criteria so they are generated for this
report when the Report Set is submitted. Selection Criteria can only
be activated if one or more Select Statements are specified and not
all are excluded. An asterisk * indicates they are active.
- D
- Deactivate the Selection Criteria. Any you have specified here
will not be used.