RECSEL - Record Selection extract

The RECSEL or RECORDSELECTION operand requests that a subset of CMF records be extracted from a larger SMF file. Optionally, DB2® and MQ accounting records and MVS™ System Logger records can also be extracted. This smaller file containing only those records of interest to you can then be used for more efficient CICS PA reporting.

A Recap report containing processing statistics is always printed at the end of extract processing.

The command format for the Record Selection extract is:
[CICSPA APPLID(applid1,applid2,...)]
 CICSPA RECSEL(
             [OUTPUT(ddname),]
             [DDNAME(ddname),]
             [PERFORMANCE,]
             [EXCEPTION,]
             [RESOURCE,]
             [IDENTITY,]
             [STATISTICS,]
             [LOGGER,]
             [OMEGAMON,]
             [DB2,]
             [MQ,]
             [SSID(id1,id2,...),]
             [COMPRESS|NOCOMPRESS,]
             [SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(value1),...),...),]
             [SELECT(EXCEPTION(INCLUDE|EXCLUDE(field1(value1),...),...))]
             [SELECT(LOGGER(INCLUDE|EXCLUDE(field1(values1),...), ...))]
             [LOGSTREAM('name.or.pattern'),]
             [STRUCTURE('name.or.pattern'),])
The options are:
OUTPUT
Controls the report output DDname for the Recap report. If not specified, CICS PA assigns a DDname in the format RSELnnnn where nnnn is the report sequence number 0001-9999.
DDNAME
Specifies the DDname of the output data set where the Record Selection extract is written. If not specified, the default DDname is CPAORSEL. The CICS PA dialog, however, assigns DDnames in the format CPAORSnn where nn is the extract sequence number 01-99. See the sample JCL in Figure 1.
PERFORMANCE
Include CMF Performance class records in the extract. This is the default.
EXCEPTION
Include CMF Exception class records in the extract.
RESOURCE
Include CMF Transaction Resource class records in the extract.
IDENTITY
Include CMF Identity class data records in the extract.
STATISTICS
Include CICS® Statistics and Server statistics class records in the extract.
LOGGER
Include MVS System Logger records in the extract.
OMEGAMON®
Include OMEGAMON XE for CICS records in the extract.
DB2
Include DB2 accounting records in the extract.
MQ
Include WebSphere® MQ accounting records in the extract.
SSID
Requests that the Record Selection extract include DB2 accounting (SMF 101) records for the specified DB2 Subsystem IDs, and MQ accounting (SMF 116) records for the specified MQ Subsystem IDs . Masking characters are supported: % for one and only one character, and * for many or none. If no DB2 SSIDs are specified, then no DB2 accounting records are extracted. If no MQ SSIDs are specified, then no MQ accounting records are extracted.
COMPRESS|NOCOMPRESS
Determines whether CICS PA writes CICS SMF records to the extract file in compressed or uncompressed format. This option applies whether the records in the input SMF file are compressed or not.

If you specify COMPRESS, CICS PA writes compressed CICS SMF records, regardless of the CICS release level that created the input records. 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 CICS 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.

SELECT(PERFORMANCE|EXCEPTION|LOGGER(INCLUDE|EXCLUDE
Specifies what CMF performance data, CMF exception data, or System Logger data to include or exclude from the extract based on data field values. See Using SELECT statements for an explanation and examples.