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 680), 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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
CICS PA JCL generation translates the settings to the SYSID(applid,mvsimage) operand.