The CICSPlex® SM trace format utility, EYU9XZUT, formats the raw trace
records produced for a CMAS or MAS. The host version of EYU9XZUT, formats
the AUXTRACE records produced for a CMAS or MAS (including trace records sent
to the CMAS).
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:
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.
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.
If the trace entries for one or more specific methods are required, customer support personnel will provide you with the appropriate method IDs.
The name appears on the trace heading, following the heading NAME.
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.
The transaction ID appears in the formatted trace header, after TRANID.
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.
The combination of trace formatting options you select affects the output you receive. When you select:
When you specify ONLY, exception records are printed for only the specified component, method, name, or user.
Figure 8 is an example of the JCL needed to run the host version of EYU9XZUT trace format utility.
//jobname JOB (acct),'name',CLASS=x,MSGCLASS=x
//TRCLST EXEC PGM=EYU9XZUT,REGION=2048K,PARM='NARROW'
//STEPLIB DD DSN=CICSTS31.CPSM.SEYULOAD,DISP=SHR
//SORTWK01 DD SPACE=(CYL,(3,2)),UNIT=SYSDA
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//TRCEIN DD DSN=cics.system.DFHTRACA,DISP=SHR
// DD DSN=cics.system.DFHTRACB,DISP=SHR
//TRCEOUT DD SYSOUT=*,COPIES=1
//TRCEABB DD SYSOUT=*,COPIES=1
//SYSIN DD *
ABBREVIATED
FULL
COMPID=MON
EXCEPTION=ONLY
METHOD=MSIN
RECOVERY=ALL
SEQ=1-55,77,999-1234567
TRANID=TRN1
/*
CVM.CICS.CVMSM2.DFHTRACB
CPSM Selective Trace Format Parameters:
ABBREVIATED=YES
FULL REPORT=YES
EXCEPTION=ALL
RECOVERY=ALL
TRANID=ALL
COMPID=WLM
METHOD=XCBA
NAME=ALL
USER=ALL
SEQ=ALL
EYU9XZUT - CICSPlex/SM Trace Formatter
PROCESSING DATASET:CVM.CICS.CVMSM2.DFHTRACB
TASK:00034 METHOD:XQLK PRIOR:XQGQ DEBUG:QLOKEXC POINTID: 2 TRANID:LP
MAJOBJ:QUE ENVRN:CMAS TYPE:EXCEPTION TOD:08:32:16.80730 CLO
UOW(CPSM): SYSTM:MVSH NAME:CICSCMH CICS-TASK: 34 TASK-STAR
MethName XQLK,XQGQ,CPTI,CPLT,XLOP
MAL LEN:0030 ALET:00000000 ADDR:0502DBD0
EYUQXQLK IN
*ENM FUNCTION( QUELOOK )
CHR DEBUG( )
*QID QTOKEN( 800C500600001920 )
SDT DELETE( FALSE )
OUT
*ENM RESPONSE( INVALID )
*ENM REASON( QUEUE_ID_NOT_FOUND )
*EPT CACHE_TOKEN( A= 00000000 O= 00000000 )
PROCESSING DATASETS: CVM.CICS.CVMSM2.DFHTRACA
TASK:00042 METHOD:XSWX ENVRN:CMAS TYPE:*ABEND* TRAN:MCCM TOD:05:24:31.48816
ABEND CODE: AEXY
PSW: 00000000 00000000
OFFSET: 6F6F6F6F
METHOD: XSWX
INTERUPT: 00000000 00000000
PROGRAM: EYU0XSWX
R04 06103D90 R05 00000008 R06 06104022 R07 06A37460
R08 06A36388 R09 05E64918 R10 05E65918 R11 06A3648C
R12 06A36080 R13 80045578 R14 85E6599E R15 85809080
ABEND ARREGS: AR00 00000000 AR01 00000000 AR02 00000000 AR03 00000000
AR04 00000000 AR05 00000000 AR06 00000000 AR07 00000000
AR08 00000000 AR09 00000000 AR10 00000000 AR11 00000000
AR12 00000000 AR13 00000000 AR14 00000000 AR15 00000000
ABEND STORAGE: -10 00000000 00000000 00000000 00000000
+00 00000000 00000000 00000000 00000000