Formatting a BPE trace entry

You can format a BPE trace entry by using either the Interactive Problem Control System (IPCS) or a batch job.

Before you begin to format BPE trace entries, ensure that the user ID that you use to format and print the external BPE trace records is authorized by RACF® to access the external trace data sets.

To format BPE trace entries by using the IPCS:

Procedure

  1. Select option 0 from the IPCS Primary Option menu to specify the generation data group (GDG) to analyze.
  2. Specify the data set name for the GDG in the Source field of the IPCS Default Values menu. For example, specify: DSNAME('BPEEXTRC.GDG01.G0001V00').
  3. Select option 2.6 from the IPCS Primary Option menu to display a list of the dump component analysis tools.
  4. Select option DFSAAMPR from the IPCS MVS Dump Component Data Analysis menu to display options for the IMS Dump Formatter.
  5. Select option 6 from the IMS Dump Formatting Primary menu to display formatting for other IMS components, such as BPE.
  6. Select one of the options from the IMS Component Selection Dump Formatting menu to display formatting options for an IMS component (BPE, CQS, DBRC, ODBM, OM, REPO, RM, SCI, or IMS Connect). For example, select option B to display general BPE formatting options.
  7. Select option 4 from the component subsystem dump formatting menu, for example the IMS BPE Subsystem Dump Formatting menu, to display the options for external trace formatting.
  8. Specify the various formatting options for the external trace data from the subsystem's external trace formatting menu, for example the BPE External Trace Formatting menu.

You can also format BPE external trace records by using a batch job. The following figure shows sample JCL for formatting the BPE external trace records from a batch job.

Figure 1. Batch JCL for formatting BPE external trace records
//BPEEXTPR JOB ... 
//*************************************************************/
//* Job to print all traces in a BPE external trace data set. */
//************************************************************//
//JOBLIB   DD   DSN=IMS.SDFSRESL,DISP=SHR
//IPCSDMP  EXEC PGM=IKJEFT01,REGION=8M
//SYSTSPRT DD   SYSOUT=*
//IPCSPRNT DD   SYSOUT=*
//INDEX    DD   SYSOUT=*
//SYSABEND DD   SYSOUT=*
//IPCSPARM DD   DSN=USER.PARMLIB,DISP=SHR
//         DD   DSN=SYS1.PARMLIB,DISP=SHR
//SYSTSIN  DD   *
DELETE 'SYS1.IPCSDDIR'
ALLOC SP(1) TRACK VOL(333333)
DEFINE CLUSTER (NAME('SYS1.IPCSDDIR') +
  VOLUMES(333333)) +
  INDEX(NAME('SYS1.IPCSDDIR.DDX') +
  TRACKS(1 1)) +
  DATA( NAME('SYS1.IPCSDDIR.DDD') +
  CYLINDERS(1 1) BUFSP(X'10000') KEYS(128 0) CISZ(X'1000'))
IPCSDDIR 'SYS1.IPCSDDIR'
ALLOC FILE(IPCSDDIR) +
  DA('SYS1.IPCSDDIR') +
  REUSE SHR
ALLOC FILE(INFILE) +
  DA('BPEEXTRC.GDG01.G0001V00') +
  REUSE SHR
IPCS NOPARM
SETDEF DSN('BPEEXTRC.GDG01.G0001V00') +
  NOPROBLEM PRINT NOTERMINAL
VERBX BPETRFM0 +                
 'COMP(HWS) +                   
  TRACE(TYPE(RCTR)) +           
SDATE(2008080) STIME(110909) +  
EDATE(2008090) ETIME(140000) +  
  UL(L) +                       
  CSTCK(Y)'                     
END            
DELETE 'SYS1.IPCSDDIR'
/*
Read syntax diagramSkip visual syntax diagramCOMP(ALLBPEcomponent name)TRACE(TYPE(,ALLtrace table name))SDATE( yyyyddd)STIME( hhmmss)EDATE( yyyyddd)ETIME( hhmmss)CSTICK(YN)UL(UL)

BPETRFM0 Parameter Keywords

COMP()
Specify ‘ALL' to format all trace records, ‘BPE' to format BPE trace records, or a specific component name (BPE, CQS, DBRC, ODBM, OM, REPO, RM, SCI, or HWS) to format trace records for only that component.
TYPE()
Specify ‘ALL' to format trace records for all trace tables or specify a specific trace table name to format records only for that trace table type.
SDATE()
Specify a starting date for the trace entries in Julian format (yyyyddd). Trace entries with a store clock (STCK) value prior to the specified date are filtered and not printed.
STIME()
Specify a starting time for the trace entries in 24 hour format (hhmmss). Trace entries with an STCK value prior to the specified time are filtered and not printed. SDATE() is required with STIME().
EDATE()
Specify an ending date for the trace entries in Julian format (yyyyddd). Trace entries with an STCK value after the specified date are filtered and not printed.
ETIME()
Specify an ending time for the trace entries in 24 hour format (hhmmss). Trace entries with an STCK value after the specified time are filtered and not printed. EDATE() is required with ETIME().
CSTCK()
Specify ‘Y' to have the value for each trace entry printed in JDAYTIME format (DDD HHMMSS.thmiju).
UL()
Specify ‘L' if the specified filtering time is based on the local time in the trace record or ‘U' if the specified filtering time is based on UTC.

BPETRFM0 formatted BPE external trace record header output

 -----------------------------
 --- BPE  ERRV Trace Table ---
  -----------------------------

 ETHD: 00000000
    +0000  LL....... 4010      ZZ....... 0000      TYPE..... 01        SUBTYPE.. 02        VERSION.. 0001      RESERVED. 00000000
    +000C  NAME..... ERRV      LENGTH... 00000080  UDATALEN. 00000000  TDATALEN. 00003F80  NUMPGS... 0008      ENTLEN... 0020
    +0020  ENTSKPD.. 00000000  BVERS.... 010700    RESERVED. 00        UTYPE.... HWS       UVERS.... 0B0100    RESERVED. 00
    +0030  USYSNAME.           UTRMOD... 00000000  00000000            FLG1..... 48        FLG2..... 00        LEVEL.... 04
    +0043  IDX...... CB        CYCLECT.. 00000000  OFFSET... 00000000  BYTELOST. 00000000  LDTO..... FFFFA21F  68400000
    +0058  LSO...... 00000000  00000000            STCK..... C233AA77  1692DF60            RESERVED. 00000000  NEXT..... 00000000
    +0070  FIRST.... 0BC01C60  TOKVAL... 00000000  ID....... ETHD END
    Flag analysis for ethd_flg1:
      ethd_f1_system   (40x) - Trace table is a BPE system table
      ethd_f1_var      (08x) - Trace type creates variable length entries
    Trace level for this table is: HIGH

 ETSF: 00004000
    +0000  STCK..... C233AA7D  AE68F180            SEQNUM... 00000000  00000004

Variable trace table entries follow with oldest entry printed first

Formatted BPE external trace variable trace entry

ERRV trace table entry:
          Code:     SSRV                Record #: 1
          Subcode: *BPEDYA10 ERROR      Continue: 0
          TimeStmp: 096 183544.830765

  TTVE: 00000000

          Variable entry prefix:
          LL....... 1FC0                REC#..... 00000001
          ZZ....... 0000                CONT..... 00000000
          VLEN..... 00001F90

  TTE: 00000010

          Variable entry fixed section:
          CODE..... C6                  WD02..... 00000002
          SCDE..... 1B                  WD03..... 00000003
          B1B2..... C1C2                WD04..... 00000004
          WD01..... 00000001            WD05..... 00000005
          STCK..... C233AA77  1692DF60
          Data +00: |F.AB............|  Data +10: |........B....k.-|

  Data: 00000030  Length: 8080

          Variable entry variable section:
  Offset  0        4        8        C         0        4        8        C          EBCDIC Data
  ------  -----------------------------------  -----------------------------------  ----------------------------------
 +000000  81818181 81818181 81818181 81818181  81818181 81818181 81818181 81818181  |aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa|
   LINES +000020 TO +001F7F SAME AS ABOVE
 +001F80  81818181 81818181 81818181 81818181                                       |aaaaaaaaaaaaaaaa                |