Specifying Report Set contents

The Report Set Edit panel is displayed when you do either of the following actions from the Report Sets panel:
  • Create a new Report Set.

    Use the NEW command or select File->New in the action bar.

  • Select an existing Report Set.

    Enter line action E or S against a Report Set or use the SELECT command

The Report Set panel describes the Report Set and lists all the reports and extracts that can be requested.

The Report Set description can be modified. Specify up to 32 characters of text to describe the purpose of the Report Set. The description is shown on the Report Sets panel to help you distinguish between the Report Sets displayed. It also appears as a comment in the JCL. The description is initially set to CICS PA Report Set.

The reports and extracts are grouped to indicate the type of output (report or extract) and the type of SMF data they process, either CMF data (performance, exception, transaction resource, or statistics class data), subsystem data (DB2®, WebSphere® MQ, OMEGAMON®), or MVS™ system data (System Logger). Also listed are three specifications which apply globally to all reports and extracts in the Report Set:
  • Global Options apply to all reports and extracts. They specify the global system selection (CICS® System, DB2 Subsystem, MVS System Logger, WebSphere MQ ID) and report formatting options (lines per page, time zone, date/time delimiters).
  • Performance Selection Criteria apply to all performance reports and extracts. They provide filtering of CMF performance records based on field values.
  • Exception Selection Criteria apply to all exception reports. They provide filtering of CMF exception records based on field values.
Note: You can override some of the global options by specifying them for individual reports or extracts. System Selection (System, Image, Group) and Selection Criteria are primary examples of this feature. Report-level specifications take precedence.

The reports, extracts, and global selection criteria can be activated (Active=Yes) or deactivated (Active=No). They are automatically activated when created, and can be explicitly deactivated or activated at any time. The global options are automatically activated if at least one report or extract is active, but they cannot be explicitly activated or deactivated.

Each Report Category can be activated or deactivated. Only active reports in active report categories are included in the Report Set at submit time. A Report Set can be submitted for processing if there is at least one active report in an active report category.

However, there is a convenient exception. You can use the RUN line action to temporarily override the active status of a report or report category.

Line Actions

Line Actions (** Reports **):

The line actions that are valid for ** Reports ** at the top of the Report Set tree are:
Display the menu of line actions.
S
Expand/Collapse all categories.
A
Activate all categories.
AA
Activate all categories and reports.
D
Deactivate all categories.
DD
Deactivate all categories and reports.
RUN
Run the Report Set. Only active reports within active categories are selected, together with any categories or reports selected by the RUN line action.
Line Actions (Global Options Category):
Display the menu of line actions.
S
Expand/Collapse category.
Line Actions (Global Options):
Display the menu of line actions.
S
Select (edit) the global options.
Line Actions (Selection Criteria Category):
Display the menu of line actions.
S
Expand/Collapse category.
A
Activate category.
AA
Activate category and all selection criteria.
D
Deactivate category.
DD
Deactivate category and all selection criteria.
Line Actions (Performance and Exception Selection Criteria):
Display the menu of line actions.
S
Select for edit or review.
A
Activate the Selection Criteria.
D
Deactivate the Selection Criteria.
Line Actions (Report and Extract Categories):
Display the menu of line actions.
S
Expand/Collapse the category.
A
Activate the category.
AA
Activate the category and all its reports and extracts.
D
Deactivate the category.
DD
Deactivate the category and all its reports and extracts.
RUN
Run the active reports and extracts in the category, plus any selected by the RUN line action.
Line Actions (Reports and Extracts):
S
Select for edit or review.
A
Activate the report or extract.
D
Deactivate the report or extract.
RUN
Run the report or extract, ignoring the active status.

Primary Commands

SAVE
This command is only available from Edit mode and saves any changes you have made. To save any changes made in View mode, use SAVEAS.

Also available from File in the action bar.

SAVEAS rsetname|datasetname(rsetname)
This command is available from both Edit and View mode to save the contents of this Report Set under another name, either in the current data set (assumed if no data set name is provided) or in another data set (if the name of a valid PDS is provided). If you then Cancel from this panel, the contents of the current Report Set remain unchanged.

Also available from File in the action bar.

RUN
Run the Report Set. Only active reports and extracts within active categories are selected. The Run Report Set panel is displayed for you to enter required run-time options before submission. See Running Report Sets for more information. Alternative RUN commands are:
SUB
After your run-time options are validated, JCL is submitted directly for batch processing.
JCL
After your run-time options are validated, JCL is presented in an Edit session. You can alter the JCL before submission or save it in your JCL library.

Also available from File in the action bar.

CONFIRM ON|OFF
CONFIRM ON (or CONFIRM) instructs CICS PA to prompt for confirmation when you request to Cancel from the Report Set panel when there have been updates.

With CONFIRM OFF, Cancel requests are actioned immediately, discarding any changes.

This command changes the setting only for the current Edit/View session. On exit, it reverts to the value set by Cancel Confirmation in CICS PA Settings

Also available from Confirm in the action bar.

Note: The SAVE and SAVEAS commands are only available on the Report Set panel, being at the top of the panel hierarchy. Changes made on the associated panels (global options, selection criteria, reports, extracts) are only saved when the Report Set is saved.