Formatting CMAS and MAS trace entries

Start of changeThe 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).End of change

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.

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.

Hierarchy of formatting options

The combination of trace formatting options you select affects the output you receive. When you select:

COMPID or METHOD
Records for the specified component or method are printed.
USER or NAME
Records for the specified TSO user or system are printed.
(COMPID or METHOD) and (USER or NAME)
Only those records for the specified component or method that are also associated with the specified TSO user or system are printed.
EXCEPTION
When you specify ALL, all exception records are printed regardless of the other options you specify.

When you specify ONLY, exception records are printed for only the specified component, method, name, or user.

SEQ
Selected records are printed, depending on the sequence of records you specify.
TRANID
Selected records are printed, depending on what you specify for all other options.

Trace formatting JCL

Figure 8 is an example of the JCL needed to run the host version of EYU9XZUT trace format utility.

Figure 8. Example of JCL to execute the 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
  /*
 

Notes:
  1. The PARM='NARROW' parameter on the TRCLST EXEC statement causes the trace records to be printed in an 80-character format for display on a terminal. If you omit this parameter, the trace records are printed in their normal 132-character format.
  2. The data set specified by the TRCEIN DD statement is the CICS® auxiliary trace data set from a CMAS or a MAS.

Figure 9. Example of output from the EYU9XZUT trace format utility
                         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
 

[[ Contents Previous Page | Next Page Index ]]