DL/I call trace listing

When the DL/I call trace option is used, IMS Batch Terminal Simulator prints the call trace information for DL/I calls that were issued by the application.

Subsections:

DL/I call trace options for printing DL/I call trace listing

To manage the DL/I call trace listing, specify the following options:

  • ./O DB= to print DL/I database call traces
  • ./O MSG= to print DL/I message call traces
  • ./T DLITRACE= to print a DL/I call trace for each PCB for the specified PSB

Examples of the DL/I call trace listing

The following example shows the DL/I database call trace and DL/I message call trace in the default format.

Figure 1. Example of the DL/I call trace listing
MBR=DFSSAM07 PSB=DFSSAM07 EDIT=         SPA=0     PLC=1     LANG=CBL TYPE=MSG                                              
****  MSG CALL- FUNC=GU  , PCB=IOPCB   , STATUS=  , MESSAGE NUMBER=000001         LENGTH=000020, PCBN=001       -MSG-    GU
             ----.----1----.----2----.----3----.----4----.----5----.----6----.----7----.----8----.----9----.---10          
      IOAREA=    DSPALLI AN960C10                                                                                          
             0100CEDCDDC4CDFFFCFF                                                                                          
             04004271339015960310                                                                                          
****** DB CALL- FUNC=GU  , PCB=DI21PART, STATUS=  , LEVEL=01, SEGMENT=PARTROOT  IOLENGTH=000050, PCBN=002        -DB-    GU
                                                                                                                           
         KFB=02AN960C10                                                                                                    
             FFCDFFFCFF4444444                                                                                             
             02159603100000000                                                                                             
        SSA1=PARTROOT(PARTKEY  =02AN960C10       )                                                                         
             DCDEDDDE4DCDEDCE447FFCDFFFCFF44444445                                                                         
             71939663D719325800E02159603100000000D                                                                         
             ----.----1----.----2----.----3----.----4----.----5----.----6----.----7----.----8----.----9----.---10          
      IOAREA=02AN960C10                WASHER                                                                              
             FFCDFFFCFF4444444444444444ECECCD444444444444444444                                                            
             02159603100000000000000000612859000000000700000000                                                            
****** DB CALL- FUNC=GN  , PCB=DI21PART, STATUS=  , LEVEL=02, SEGMENT=STANINFO  IOLENGTH=000085, PCBN=002        -DB-    GN
                                                                                                                           
         KFB=02AN960C10       02                                                                                           
             FFCDFFFCFF4444444FF                                                                                           
             0215960310000000002                                                                                           
      NO SSAS                                                                                                              
             ----.----1----.----2----.----3----.----4----.----5----.----6----.----7----.----8----.----9----.---10          
      IOAREA=02                742                          1200  14      06C      06C                                     
             FF4444444444444444FFF44444444444444444444444444FFFF44FF444444FFC444444FFC444444444444                         
             0200000000000000007420000000000000000000000000012000014000000063000000063000000000000

The following example shows the DL/I database call trace and DL/I message call trace in the single-line message format. This format is helpful in identifying each call. You can display the call trace in this format by specifying ./O DB=SGL, ./O MSG=SGL, and ELAPTIME=YES.

Figure 2. Example of the DL/I call trace listing (single-line messages)
****  MSG CALL- FUNC=GU  , PCB=IOPCB   , STATUS=  , MESSAGE NUMBER=000001         LENGTH=000020, PCBN=001       -MSG-    GU         ELAPSED SEC=0.000950
                                                                                                                           
****** DB CALL- FUNC=GU  , PCB=DI21PART, STATUS=  , LEVEL=01, SEGMENT=PARTROOT  IOLENGTH=000050, PCBN=002        -DB-    GU         ELAPSED SEC=0.271055
                                                                                                                           
****** DB CALL- FUNC=GN  , PCB=DI21PART, STATUS=  , LEVEL=02, SEGMENT=STANINFO  IOLENGTH=000085, PCBN=002        -DB-    GN         ELAPSED SEC=0.000007
                                                                                                                           
****** DB CALL- FUNC=GN  , PCB=DI21PART, STATUS=GK, LEVEL=02, SEGMENT=STOKSTAT  IOLENGTH=000160, PCBN=002        -DB-    GN   GK    ELAPSED SEC=0.000002
                                                                                                                           
****  MSG CALL- FUNC=ISRT, PCB=IOPCB   , STATUS=  , MESSAGE NUMBER=000001         LENGTH=000063, PCBN=001       -MSG-    ISRT       ELAPSED SEC=0.00000

Description of the fields

The following table summarizes the information that is available for each DL/I call.

Table 1. DL/I call trace listing fields
Field Description
TYPE= The type of the DL/I call.
PCB= The PCB name that is used for this call.
STATUS= The status code that is returned as a result of this call.
PCBN= The number of the PCBs that are used by this call.
MESSAGE NUMBER= The number of the current handling message. This information is available only for message calls.
LENGTH= The length of the I/O area. This information is available only for message calls in the I/O area.
LEVEL= The level of the segment. This information is available only for successful database calls.
SEGMENT= The segment name. This information is available only for successful database calls.
IOLENGTH= The length of the I/O area. This information is available only for database calls or system calls.
IOAREA= The content of the I/O area. This information is available only for calls with the I/O area.
WORK= The content of the I/O area. This information is available only for XRST calls or Symbolic CHKP calls.
I/O LENGTHx = The length of the area, where x is a serial number for the area length name. This information is available only for XRST calls or Symbolic CHKP calls.
I/O AREAx = The content of the area, where x is a serial number for the area name. This information is available only for XRST calls or Symbolic CHKP calls.
KFB= The key feedback area. This information is available only for successful database calls.
SSA= The SSA. This information is available only for database calls.
AIB= The AIB information. This information is available only when the AIB interface is used.
OPTLIST= The option list for the DL/I call.
FEEDBACK= The feedback area for the DL/I call.
ELAPSED SEC= The elapsed seconds of the DL/I call. This information is available only when ./O ELAPTIME=Y is specified.
REQUEST= The content of the request area for the ICAL DL/I call. This information is available only when the AIB interface is used with a function code of ICAL.
RESPONSE= The content of the response area for the ICAL DL/I call. This information is available only when the AIB interface is used with a function code of ICAL.
CONTROL DATA= The content of the control data area for the ICAL DL/I call. This information is available only when the AIB interface is used with a function code of ICAL and control data.