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
- Select option 0 from the IPCS Primary Option menu to specify the generation data group (GDG) to analyze.
- 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'). - Select option 2.6 from the IPCS Primary Option menu to display a list of the dump component analysis tools.
- Select option DFSAAMPR from the IPCS MVS Dump Component Data Analysis menu to display options for the IMS Dump Formatter.
- Select option 6 from the IMS Dump Formatting Primary menu to display formatting for other IMS components, such as BPE.
- 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.
- 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.
- 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.
//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'
/*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 |
