BTS Trace

The BTS trace feature logs DL/I API calls and parameters issued by an IMS application. You enable BTS trace from JCL. When JCL SSTM support is enabled, you can use the BTS trace feature to also trace IMS transactions, CICS transactions, and batch programs from CRUN.

Enable BTS Trace

You enable BTS trace from JCL using the following DD specifications:

IMSTRACE

Defines the output data set for the BTS trace. SYSOUT=* directs BTS output to the job. You can also direct output to a data file by specifying DCB=(RECFM=LSEQ,LRECL=80,DSORG=PS).

BTSCONFG

Enables control of BTS trace output options, and takes the following keywords:

`SSA`	Include segment search arguments, if any
PCB	Include the PCB area
PCBHELP	Include help text in the trace for invalid SSAs (AJ DL/I status code)
`IOAREA`	Include input-output buffer
`JESLOG`	Include trace output in the job log
STATS	Include call statistics
`TIMES`	Include call timings for performance measurement
`CONSOLE`	Include trace output in the Enterprise Server console and in the job logs
DIAG	Include detailed diagnostic information
`LISTFILE`	In addition to the specified output data set, write BTS trace output to a compressed file named BTS-`nnn`.LST, where `nnn` is the process ID in decimal
`STAYOPEN`	When used with SSTM, BTS trace will keep trace output file open between transactions for efficiency.

These specifications apply to the current job step only, and override any BTS trace flags stored in the IMSCONFG.DAT configuration file.

Examples

Sample JCL

This sample JCL enables BTS trace in an IVP program named DEMO001B:

//S01       EXEC PGM=DFSRRC00,REGION=4M,
//          PARM='BMP,DEMO001B,DEMO001T,,,,,,,,,CDLI,,N,N'
//REPORT1   DD SYSOUT=*
//IMSERR    DD SYSOUT=*
//PRINTDD   DD SYSOUT=*
//SYSOUT    DD SYSOUT=*
//SYSPRINT  DD SYSOUT=*
//IMSTRACE  DD SYSOUT=*
//BTSCONFG  DD *
SSA
PCB
IOAREA
/* 
//

Sample BTS output

This sample BTS output is from the DEMO001B program, and shows the DL/I call function, SSAs, PCB, and I/O area:

CBLTDLI:  ~~~~~~~~----+----1----+----2----+----3----+----4----+----5 
CBLTDLI:  CALL   :GN 
CBLTDLI:          4422 
CBLTDLI:          7E00 
CBLTDLI:  SSAS   : NONE 
CBLTDLI:  PCB-003:DEMO03DD01  AP  ....DEMOHDRS...(............TEST 
CBLTDLI:          44443344332245220000444444550002000000000000545522 
CBLTDLI:          45DF034401001000000045DF84230008000200000000453400 
CBLTDLI: 
CBLTDLI:          22222222222222222222222222 
CBLTDLI:          00000000000000000000000000 
CBLTDLI:  IO AREA:........TEST                            Element Ta 
CBLTDLI:          00000000545522222222222222222222222222224666667256 
CBLTDLI:          00000000453400000000000000000000000000005C5D5E4041 
CBLTDLI:          ble - Metals 
CBLTDLI:          66622246766722222222222222222222222222222222222222 
CBLTDLI:          2C50D0D541C300000000000000000000000000000000000000 
CBLTDLI:                              ......N          .`0. 
CBLTDLI:          22222222222222222222000000422222222220631222 
CBLTDLI:          000000000000000000001C5C0CE0000000000000F000 
CBLTDLI:  ~~~~~~~~----+----1----+----2----+----3----+----4----+----5 
CBLTDLI:  CALL   :GN 
CBLTDLI:          4422 
CBLTDLI:          7E00 
CBLTDLI:  SSAS   : NONE 
CBLTDLI:  PCB-003:DEMO03DD02  AP  ....DEMOELES...F............TEST 
CBLTDLI:          44443344332245220000444444450004000000000000545522 
CBLTDLI:          45DF034402001000000045DF5C530006000200000000453400 
CBLTDLI:                                    ..........Ag 
CBLTDLI:          22222222222222222222222222000000000046222222222222 
CBLTDLI:          00000000000000000000000000000000000017000000000000 
CBLTDLI: 
CBLTDLI:          222222 
CBLTDLI:          000000 
CBLTDLI:  IO AREA:..........Ag                  Silver 
CBLTDLI:          00000000004622222222222222222256676722222222222222 
CBLTDLI:          00000000001700000000000000000039C65200000000000000 
CBLTDLI: 
CBLTDLI:          22222222222222222222222222222222222222222222222222 
CBLTDLI:          00000000000000000000000000000000000000000000000000 
CBLTDLI:                    (    1 line(s) same as above ) 
CBLTDLI:                       ........ 
CBLTDLI:          22222222222220000000022222222222222222222222222222 
CBLTDLI:          00000000000000000000C00000000000000000000000000000 
CBLTDLI: 
CBLTDLI:          222222222222222222222222 
CBLTDLI:          000000000000000000000000