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.
- 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:
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.SEQ=1-99,103,12345-12399If 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.