EXTRACTPERFORMANCE - Performance data extract
The EXTRACTPERFORMANCE operand requests that a performance extract data set is to be created as a delimited text file from the CMF performance class data.
A more flexible alternative is the extract capability provided by the LIST and SUMMARY operands. For more information, see LIST - Performance List report and SUMMARY - Performance Summary report.
A Recap report containing processing statistics is always printed at the end of extract processing.
The command format for the Performance Data extract
is:
CICSPA EXTRACTPERFORMANCE(
[OUTPUT(ddname),]
[DDNAME(ddname),]
[DELIMIT('field-delimiter'),]
[LABELS|NOLABELS,]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),
...))])
The options are:
- OUTPUT
- Controls the report output DDname for the Recap report. If not specified, CICS PA assigns a DDname in the format EXPTnnnn where nnnn is the report sequence number 0001-9999
- DDNAME
- Specifies the DDname of the output data set where the performance extract is written. If not specified, the default DDname is CPAOEXPT. The CICS PA dialog, however, assigns DDnames in the format CPAOEXnn where nn is the extract sequence number 01-99. (See the sample JCL in Figure 1).
- DELIMIT
- Specifies the field delimiter, enclosed in quotes, to be used to separate each data field in the performance extract data set. The default is a semicolon DELIMIT(';').
- LABELS|NOLABELS
- LABELS indicates that the first record to be written to the performance
extract data set is to be a field labels record. This is the default.
NOLABELS indicates that CICS PA is not to write a field labels record to the performance extract data set.
- SELECT(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies what CMF performance data to include or exclude from the extract based on data field values. See Using SELECT statements for an explanation and examples.