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.