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 700), 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.
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).
- 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 APPLIDs 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
- ⁄
- 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 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.
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 APPLIDs 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, 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 are 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:
- ⁄
- Display the menu of line actions.
- S
- 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.