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).
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 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.
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.
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.