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.
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.

Information Information

Feedback


Timestamp icon Last updated: Thursday, 7 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//users-guide/cpaug178.htm