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.
[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'),])
- 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.