Cross-System Work extract

The Cross-System Work Extract is created for the purpose of correlating performance class data from one or more regions. The extract records are based on a single network unit-of-work, as opposed to a single transaction. All performance class records contained in a single network unit-of-work are added, or combined. These records are then written to the extract data set as one record which represents all the work done on behalf of the network unit-of-work. A Recap report containing processing statistics is always printed at the end of extract processing.

The extract records have the same format as CMF performance class records written by the latest CICS® release supported by CICS PA (VRM 670), regardless of the CICS releases of the input records.

You can use the extract data set as input to CICS PA for further processing, just like an SMF data set that contains CMF performance class records; for example, to run the Performance List, Performance List Extended, Performance Summary, and Performance Totals reports.

To request the extract, enter line action S against the Cross-System Work Extract on the Report Set panel. If extracts of this type have been previously specified, the list of Cross-System Work Extracts is displayed. Otherwise, the Cross-System Work Extract panel is displayed for you to define your first extract of this type.
Figure 1. Cross-System Work Extracts
   File  Filter  Edit  Systems  Options  Help
 ------------------------------------------------------------------------------
                      SAMPLE - Cross-System Work Extracts          Row 1 from 2
 Command ===> ________________________________________________ Scroll ===> ____
 
         ---- System Selection -----               Selection
 /  Exc  APPLID +  Image +  Group +     Recap      Criteria
 _       ________  ________ MROPROD_    CROX0001     NO
         Output Data Set . .  'MROPROD.CROSSWK'_____________________________
 -----------------------------------------------------------------------------
 _       ________  ________ AORPROD_    CROX0002     NO
         Output Data Set . .  'AORPROD.CROSSWK'_____________________________
 -----------------------------------------------------------------------------
 ******************************* End of list *********************************
 

This panel displays the list of Cross-System Work Extracts in this Report Set. You can edit, select (edit), delete, or include/exclude any extract, insert new ones, or rearrange them (move/copy).

The options are:
Exc
The report or extract is marked by an asterisk * if it is to be Excluded from reporting. Enter the line action X to reverse the Exclude status.
System Selection
Identifies the CICS APPLID(s) whose data you want to select for processing.

You can specify any combination of APPLID, Image, or Group, but these must be defined in your System Definitions. If you do not specify System Selection here or in the Global Options, then you are prompted at run time to specify the System Selection. This will apply globally to all reports and extracts without their own System Selection. This is recommended as it allows you to run your Report Sets against any of your defined Systems. Press the Prompt key (F4) to select from a list of defined Systems, Images, or Groups. To modify your System Definitions, select Systems in the action bar.

Specify one of the following:
  • A CICS APPLID. An APPLID that matches a defined System's name pattern is also allowed. For example, CICSP1 can be specified if CICSP* is a defined system.
  • An APPLID and an MVS™ Image. This identifies the MVS Image where your CICS system runs.
  • An MVS Image. All CICS systems executing on this MVS Image is selected.
  • An APPLID and Image combination plus a Group. This is useful for uniquely identifying a CICS system when there are multiple CICS systems with the same name defined.
  • A Group alone. CICS PA will select all CICS APPLIDs defined to the Group. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.

CICS PA uses the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.

System Selection can also be specified either:
  • In Global Options. The report-level specification takes precedence over the global.
  • At run time. The run-time System Selection overrides the Global Options and optionally the report-level specification.
Recap
The DDname for the Recap report which prints at the end of extract processing to provide processing statistics. The DDname is mandatory.

CICS PA assigns a default DDname CROXnnnn where nnnn is a sequential number 0001-9999 to ensure each Recap report has a unique DDname.

This option generates the OUTPUT(ddname) operand.

Selection Criteria Indicator
This indicator is generated by CICS PA.

YES indicates that Selection Criteria are activated for this extract.

NO indicates that Selection Criteria are not activated for this extract. This is because no Selection Criteria have been specified, all Select Statements are Excluded, or the Selection Criteria have been deactivated.

Output Data Set
The name of the data set where the extract records are written. If CICS PA is to create the data set at run time, the default allocation attributes specified on the Reporting Allocation Settings panel are used in generating the JCL. If the data set is already cataloged, then CICS PA will use DISP=OLD or DISP=MOD according to your request to overwrite or append to the existing data set.

When generating the JCL, CICS PA assigns a default DDname CPAOXSnn where nn is a sequential number 01-99 to ensure uniqueness.

When specifying the data set name, standard TSO conventions apply.

Line Actions: The line actions that can be performed against the list of extracts are:
Display the menu of line actions.
S
Select this row to review or modify.
I
Insert a row.
R
Repeat this row.
C
Copy this row.
M
Move this row.
A
Move⁄Copy after this row.
B
Move⁄Copy before this row.
D
Delete this row.
X
Reverse the Exclude status.

To display the Cross-System Work Extract panel, enter line action S against the Cross-System Work Performance Extract on the Report Set panel, then if the list of previously specified extracts is displayed, enter line action S against a particular extract in the list.

Figure 2. Cross-System Work Extract
   File  Systems  Options  Help
 ------------------------------------------------------------------------------
                      SAMPLE - Cross-System Work Extract
 Command ===> _________________________________________________________________
 
 System Selection:                       Extract Recap:
  APPLID . . ________  +                  DDname  . . . CROX0001
  Image  . . ________  +
  Group  . . MROPROD_  +
 
 Output Data Set
  Data Set Name  . . 'MROPROD.CROSSWK'_____________________________
  Disposition  . . . 1  1. OLD            Record Compression  . . 1   1. No
                        2. MOD                                        2. Yes
 
 Processing Options:                            Record Formatting Options:
 1  1. UOWs with more than one record            APPLID . . MULTIPLE
    2. UOWs with a single record                 Image  . . CICS
    3. All UOWs
 
  Selection Criteria:                            Additional User Fields:
  _  Performance                                 _  User Fields  *
 
  F1=Help      F3=Exit      F4=Prompt    F7=Backward  F8=Forward  F10=Actions
 F12=Cancel

Use this panel to specify extract options and record selection criteria for the Cross-System Work Extract. The mandatory options are the name and disposition of the Extract Data Set, the DDname for the Recap report, and the network unit-of-work (UOW) Processing Option. You can let the other options default.

System Selection
The APPLID(s) and SMF data files that apply to this extract.

You can specify any combination of APPLID, Image, or Group, but these must be defined in your System Definitions. If you do not specify System Selection here or in the Global Options, then you are prompted at run time to specify the System Selection. This will apply globally to all reports and extracts without their own System Selection. This is recommended as it allows you to run your Report Sets against any of your defined Systems. Press the Prompt key (F4) to select from a list of defined Systems, Images, or Groups. To modify your System Definitions, select Systems in the action bar.

Specify one of the following:
  • A CICS APPLID. An APPLID that matches a defined System's name pattern is also allowed. For example, CICSP1 can be specified if CICSP* is a defined system.
  • An APPLID and an MVS Image. This identifies the MVS Image where your CICS system runs.
  • An MVS Image. All CICS systems executing on this MVS Image is selected.
  • An APPLID and Image combination plus a Group. This is useful for uniquely identifying a CICS system when there are multiple CICS systems with the same name defined.
  • A Group alone. CICS PA will select all CICS APPLIDs defined to the Group. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.

CICS PA uses the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.

System Selection can also be specified either:
  • In Global Options. The report-level specification takes precedence over the global.
  • At run time. The run-time System Selection overrides the Global Options and optionally the report-level specification.

Optionally, user fields can be appended to the Cross-System Work Extract. The APPLID is used by CICS PA to initially populate the list of user fields which you can then modify using the User Fields option.

Output Data Set
The name of the data set where the extract records are written. If CICS PA is to create the data set at run time, the default allocation attributes specified in Reporting Allocation Settings are used when generating the JCL. If the data set is already cataloged, then CICS PA will use DISP=OLD or DISP=MOD according to your request to overwrite or append to the existing data set. Alternatively, you can use a GDG to create a new data set each time the extract is run.

When generating the JCL, CICS PA assigns a default DDname CPAOXSnn where nn is a sequential number 01-99 to ensure uniqueness.

When specifying the data set name, standard TSO conventions apply. For example, if the TSO option PROFILE PREFIX is in effect, the prefix is appended as the high-level qualifier unless the data set name is enclosed in quotes.

Disposition
The DISP value that you want the generated JCL to use for the output data set if it is already cataloged:
OLD
Overwrites the data set contents with the new extract data.
MOD
Appends the new extract data.

You must specify one of these dispositions regardless of whether the output data set is cataloged. If the output data set is not cataloged when CICS PA generates the JCL, then CICS PA generates the JCL using DISP=(NEW,CATLG) to catalog it.

Record Compression
Select whether you want the SMF records in the extract file to be in compressed or uncompressed format. This option applies whether the records in the input SMF file are compressed or not.

If you select Yes, CICS PA writes CICS monitoring (SMF type 110, subtype 1) and OMEGAMON® XE for CICS (SMF type 112) records in compressed format, regardless of the CICS release level of the input records. Other records are not compressed. Although CICS only introduced support for writing compressed SMF records in CICS Transaction Server Version 3.2, you can use CICS PA to create an extract file of compressed SMF records for any CICS release supported by CICS PA. You can use extract files containing compressed SMF records as input to CICS PA, just like any other SMF file, even though the CICS product level that originally created those SMF records cannot write them in compressed format.

Selecting this option generates the COMPRESS operand.

Processing Options:
Select option 1 - UOWs with more than one record to report only the transaction performance records whose network unit-of-work spans multiple CMF records. This is the default. This selection generates the WRITEMultiple operand.

Select option 2 - UOWs with a single record to report only the transaction performance records consisting of network units-of-work that include only a single CMF record. This selection generates the WRITESingle,NOWRITETMultiple operand.

Select option 3 - All UOWs to report all the transaction performance records. This selection generates the WRITESingle,WRITEMultiple operand.

Record Formatting Options:
The APPLID and MVS Image that CICS PA is to write in all extract records.

CICS PA JCL generation translates the settings to the SYSID(applid,mvsimage) operand.

The extract records contain composite data from multiple CICS systems. For CICS PA to later process the extract file as input, you must define the file and this APPLID/MVS Image combination in System Definitions.
APPLID
The APPLID that CICS PA is to write in all extract records. Specify up to eight alphanumeric (A-Z,0-9) or special (@,#,$) characters. The default is MULTIPLE.
Image
The MVS Image that CICS PA is to write in all extract records. Specify up to four alphanumeric (A-Z,0-9) or special (@,#,$) characters, with the first alphabetic or special. The default is CICS.
Performance Selection Criteria
You can specify Selection Criteria to filter the CMF records on time period and field values to restrict reporting to the data that is of interest to you.
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.
Additional User Fields
User fields can be specified for inclusion in the Cross-System Work Extract records. CICS PA uses the specified APPLID to locate the MCT and initially populate the list of user fields. See Figure 1.
Line Actions: The valid line actions are:
Display the menu of line actions.
S
Select to display the subpanel where user fields are specified. When selected for the first time, an APPLID must be specified so the appropriate user fields can be found from the MCT.
A
Activate the User Fields so they are included for this extract when the Report Set is submitted. User Fields can only be activated if at least one has been specified and not all are excluded. An asterisk * indicates they are active.
D
Deactivate the User Fields. Although you might have specified user fields for this extract, they will not be included when the Report Set is submitted.