The Record Selection Extract is a facility that allows you to create a small extract file containing only the records of interest to you. The extract file can then be used as input to CICS PA, allowing more efficient reporting.
A Recap report containing processing statistics is always printed at the end of extract processing.
File Filter Edit Systems Options Help
------------------------------------------------------------------------------
SAMPLE - Record Selection Extracts Row 1 from 2
Command ===> ________________________________________________ Scroll ===> ____
---- System Selection ----- ————— Selection Criteria —————
/ Exc APPLID + Image + Group + Recap Performance Exception Logger
_ CICSP001 ________ ________ RSEL0001 NO NO NO
Output Data Set . . 'CICSP001.DB2P.RECSEL'________________________
-----------------------------------------------------------------------------
_ DEVT____ MVS1____ ________ RSEL0002 YES NO NO
Output Data Set . . 'DEVTMVS1.RECSEL'_____________________________
-----------------------------------------------------------------------------
******************************** End of list ********************************
This panel displays the list of Record Selection Extracts in this Report Set. You can select (edit), delete, or include/exclude any extract, insert new ones, or rearrange them (move/copy).
The options and line actions are the same as on the Cross-System Work Extracts panel. See Cross-System Work extract.
File Systems Options Help
------------------------------------------------------------------------------
SAMPLE - Record Selection Extract
Command ===> _________________________________________________________________
System Selection:
CICS APPLID . . CICSP001 + Image . . ________ + Group . . ________ +
DB2 SSID . . . ____ + Image . . ________ + Group . . ________ +
MQ SSID . . . ____ + Image . . ________ + Group . . ________ +
Logger . . . . ________ + Image . . ________ + Group . . ________ +
Required CICS Record Types: Extract Recap:
/ Performance _ Exception DDname . . . RSEL0001
_ Resource _ Statistics
_ OMEGAMON _ DB2
_ WebSphere MQ _ System Logger
_ Identity
Output Data Set:
Data Set Name . . 'CICSP001.DB2P.RECSEL'________________________
Disposition . . . 1 1. OLD Record Compression . . 1 1. No
2. MOD 2. Yes
Selection Criteria:
_ Performance
_ Exception
Logger Selection Criteria:
_ Logger
Logstream Name . . . __________________________
Structure Name . . . ________________
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 Record Selection extract. The mandatory options are the name and disposition of the Extract Data Set and the DDname for the Recap report. You can let the other options default, although it is recommended that you specify Selection Criteria to reduce the volume of data.
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 uses the DB2 System Selection in JCL generation to build the SSID(ssid1,ssid2,ssid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.
DB2 System Selection can also be specified as a global option. The report-level specification takes precedence over the global. When you submit your Report Set, you can also specify DB2 System Selection at that time and it takes precedence over the global for that run only.
CICS PA uses the MQ System Selection in JCL generation to build the SSID(ssid1,ssid2,ssid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.
MQ System Selection can also be specified as a global option. The report-level specification takes precedence over the global. When you submit your Report Set, you can also specify MQ System Selection at that time and it takes precedence over the global for that run only.
CICS PA uses the Logger System Selection in JCL generation to build the INput(SMFIN001,SMFIN002,SMFIN003,...) operand and corresponding //SMFINnnn DD statements. It also generates the LOGGER operand to request Logger records for the extract.
Logger System Selection can also be specified as a global option. The report-level specification takes precedence over the global. When you run your Report Set, you can also specify Logger System Selection at run time to override the global and optionally the report-level specification.
Note that APPLIDs, DB2 SSIDs, MQ SSIDs, and Logger data are included in the extract according to your specified System Selection.
CICS PA assigns a default DDname RSELnnnn where nnnn is a sequential number 0001-9999 to ensure each Recap report has a unique DDname.
This option generates the OUTPUT(ddname) operand.
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.
CICS PA generates the DDNAME(ddname) operand and assigns a default DDname CPAORSnn where nn is a sequential number 01-99 to ensure uniqueness.
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.
To filter data for Exception Class record selection, specify Exception Selection Criteria.
To filter data for System Logger record selection, specify any combination of Logger Selection Criteria, Logstream Name, and Structure Name.
Selection Criteria are not applicable to Statistics records.