Extract options

Options applicable to the Cross-System Work extract (and not the report) are:
DDNAME
This operand specifies the DDname of the output data set where the Cross-System Work extract is written. If not specified, CICS PA assigns the default DDname CPAOXSYS. The CICS PA dialog, however, assigns DDnames in the format CPAOXSnn where nn is the extract sequence number 01-99. (See the sample JCL in Figure 1).
SYSID
This operand specifies the APPLID and MVS™ ID to be written in each record of the extract data set. If not specified, CICS PA uses the default APPLID MULTIPLE and default MVS ID CICS®.
WRITEMultiple
Write only the transaction performance records consisting of units-of-work that include multiple CMF records. This is the default for the extract.
NOWRITEMultiple
Do not write the transaction performance records consisting of units-of-work that include multiple CMF records.
WRITESingle
Write the transaction performance records consisting of units-of-work that include only a single CMF record. To get an extract containing these records only, you must suppress the default WRITEMultiple option by specifying NOWRITEMultiple as well.
NOPRINT
Do not print a Cross-System Work report. This operand can be used to create the Cross-System Work extract without the report.
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.

CHARACTER(OWNER(owner), LENGTH(nnn), HEADER(ufldname))
CLOCK(OWNER(owner), NUMBER(nnn), HEADER(ufldname))
COUNT(OWNER(owner), NUMBER(nnn), HEADER(ufldname))
Each user field to be included in the extract must be specified separately.
CHARACTER
A character type user field to be included in the extract.
CLOCK
A clock type user field to be included in the extract.
Note: A clock type field in a CMF record consists of two parts: elapsed time and a count of the number of times the condition occurred. When creating the Cross-System Work extract, CLOCK applies to both parts of the field.
COUNT
A count type user field to be included in the extract.
OWNER
The 1-8 character owner of the user field. This is the entry name in the DFHMCT ID= macro specification for the user field, or the CICS-assigned default name of 'USER'. CICS PA does not have a default owner name. Even if the owner name is USER, the OWNER operand must be specified.
LENGTH
Required with the CHARACTER operand. It specifies the length of the character user field on the Cross-System Work extract. If LENGTH is missing, the character user field will not be written. If the specified cross-system length is shorter than the original length, the value is truncated. If the cross-system length is longer than the original length, the value is padded with binary zeros. The maximum length that can be specified is 256.
NUMBER
The clock or count to be included in the extract (of the 256 clocks and 256 counts that can be defined for this owner).
HEADER
The eight-character informal field name. If not specified, CICS PA uses the default value USER. This is placed in the CMF dictionary of the Cross-System Work extract and can be used in subsequent reporting. For example, if you produce the CICS PA Performance List, Performance List Extended and Performance Summary reports from the Cross-System Work extract data set, ufldname is used as the column heading for the user fields in the reports.