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.