Trace formatting options on the host

The EYU9XZUT trace format utility has options that allow you to select the specific trace records to be formatted.

You specify the formatting options you want to use on the SYSIN statement of the program's JCL, as described in Trace formatting JCL.

When no options are specified, all trace records in the trace data set are formatted.

EYU9XZUT supports the following options:
ABBREV
Provides an abbreviated trace, which has one line per trace record with a sequence number at the far right. Use the sequence number to select full trace formatting of specific records.

The abbreviated trace is written to a SYSOUT file named TRCEABB. You must provide a DD statement for this file when you request an ABBREV trace. If you do not provide the DD statement, an error message is produced and processing stops.

COMPID=xxx,…|ALL
Specify the three-character identifier of the components whose trace entries you want to format, or ALL for all CICSPlex SM components. For a list of component identifiers, see Major components of CICSPlex SM.
EXCEPTION=ONLY|ALL
ONLY formats only those exception trace records that match all other criteria. ALL formats all exception trace records, as well as any other trace records that match all other criteria.
FULL
Provides full trace formatting of trace records meeting all selection criteria.

The trace is written to the SYSOUT file named TRCEOUT. You must provide a DD statement for this file when you request a FULL trace. If you do not provide the DD statement, an error message is produced and processing stops.

METHOD=xxxx,…|ALL
Specify the four-character identifier of specific methods whose trace entries you want to format, or ALL for all the methods for a component.

If the trace entries for one or more specific methods are required, customer support personnel will provide you with the appropriate method IDs.

NAME=
Specify the 1- to 8-character name of a CMAS or MAS whose trace entries you want to format.

The name appears on the trace heading, following the heading NAME.

RECOVERY=ONLY|ALL
ONLY formats only abend trace records, regardless of any other criteria that may be specified. ALL formats all abend trace records, as well as all trace records that match any other specified criteria.
SEQ=
Specify one or more sequence numbers to select specific trace records.

The sequence number for each trace record appears at the far right of the formatted trace heading. Sequence numbers can be from 1 to 9 characters in length. A sequence number of zero is not valid.

Sequence numbers can be specified as a single entry or as a range of entries separated by a hyphen. For example:
SEQ=1-99,103,12345-12399
You can use up to 50 SYSIN cards with the SEQ= option. Each SYSIN data set can have up to 200 specific sequence entries, as either individual numbers or ranges. Any additional entries are ignored.

If you rerun the trace format utility using SEQ=, in order to get the same trace records you must specify all of the same options that you specified on the first run.

SORT=TIME | TASK
Specifies whether TIME (defsult), or TASK ID, is the major sort key when the output is formatted.
TASKID=tasknum1,tasknum2,tasknum3...
Specify the task ID number for each task for which you want trace records. Up to 20 task IDs can be specified.
TRANID=trn1,trn2,trn3...
Specify the transaction ID of each transaction for which you want trace records.

The transaction ID appears in the formatted trace header, after TRANID.

USER=
Specify a TSO user ID.

The TSO user ID appears in the formatted trace header, after USER. Note that the USER= option is valid only for records that include an end-user interface unit of work.

You can request both an ABBREV and a FULL trace formatting in one run, by including both keywords in your SYSIN file and including the appropriate DD statements in the JCL.



eyus1b3.html | Timestamp icon Last updated: Monday, 5 June 2017