Trace entries produced by CICS for DBCTL activity

Use the CICS®-supplied transaction CETR to trace DBCTL activity. CETR traces DL/I requests until they leave DFHDBAT. Trace entries are produced at connection to and disconnection from DBCTL, for successful or failed PSB schedule, when CICS tasks issue DL/I requests, and at thread termination. Trace examples are provided in this topic with annotations to help you with CICS-DBCTL problem determination.

For details of the general format of CICS trace entries, how to select trace options for component and task tracing, whether to use standard or special tracing, how to start and stop tracing selectively, and how to format and print trace entries, see Using CICS trace for problem determination.

The remainder of this topic gives examples of CICS trace entries produced for DBCTL activity.

In the example traces, numbers in the margin indicate things that might be useful to correlate CICS and DBCTL activity. These additional numbers are not part of the trace output. Also, some trace entries are omitted for brevity, as indicated by the following symbol:

  .
  .

Example: Trace entries produced when CICS connects to DBCTL

Figure 1. CICS trace entries produced during connection to DBCTL 1 of 2

1                                                      .
                                                       .
2     00028 1 AP 00E1 EIP   ENTRY LINK                                                  0004,07301464 ....,08000E02 ....
      00028 1 PG 1101 PGLE  ENTRY LINK_EXEC             DFHDBCON,07301088 , 00000014
      00028 1 DD 0301 DDLO  ENTRY LOCATE                06D08F80,07301698,PPT,DFHDBCON
      00028 1 DD 0302 DDLO  EXIT  LOCATE/OK             D7D7E3C5 , 06D89858
      00028 1 LD 0001 LDLD  ENTRY ACQUIRE_PROGRAM       06D8BF50
                                                       .
                                                       .
3     00028 1 XM 1101 XMAT  ENTRY ATTACH                CDBO,07302E38 , 00000004,0,NONE,C,NO,YES,NO,0
      00028 1 XM 0401 XMLD  ENTRY LOCATE_AND_LOCK_TRANDEF CDBO
      00028 1 DD 0301 DDLO  ENTRY LOCATE                06D00040,07303314,TXD,CDBO
      00028 1 DD 0302 DDLO  EXIT  LOCATE/OK             06D86B78 , D7000000
                                                       .
                                                       .
4     00028 1 LD 0001 LDLD  ENTRY ACQUIRE_PROGRAM       DFHDBSPX,YES
      00028 1 LD 0002 LDLD  EXIT  ACQUIRE_PROGRAM/OK    870A0020,070A0000
                                                       .
                                                       .
5     00028 1 AP 00E1 EIP   ENTRY ENABLE                                                0004,07302AD4 ...M,08002202 ....
                                                       .
6    1CICS/ESA - AUXILIARY TRACE FROM 07/20/95 - APPLID CICSKPG1 - TIME OF FIRST ENTRY ON THIS PAGE 11:26:58.7144860002
                                                       .
7     00028 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00028 1 AP 0310 DBAT  ENTRY APPLICATION           REQUEST
8     00028 1 AP 0314 DBAT  EVENT DRA-ROUTER-LOAD       , LOAD-RESPONSE-CODE (00000000)
9     00028 1 AP 0315 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR INTERFACE REQUEST , 0100
10    00028 1 AP 0316 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR INTERFACE REQUEST , 00000000
      00028 1 AP 0313 DBAT  EXIT  DBAT-RESPONSE-CODE    (00000000)
11    00028 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
      00028 1 AP 2521 ERM   EXIT  APPLICATION-CALL-TO-TRUE(DBCTL   )
12    00028 1 ME 0301 MEME  ENTRY SEND_MESSAGE          1FB4,073D642C , 00000004,073D5060 , 00000002,DB
      00028 1 ME 0501 MEIN  ENTRY INQUIRE_MESSAGE_DATA  86BB5AE0,DFHMET1E,1FB4,073039CD , 00000000 , 0000001C,07303967 , 00000000
      00028 1 KE 0101 KETI  ENTRY INQ_LOCAL_DATETIME_DECIMAL
      00028 1 KE 0102 KETI  EXIT  INQ_LOCAL_DATETIME_DECIMAL/OK 07201995,095757,097993,MMDDYYYY
      00028 1 KE 0401 KEGD  ENTRY INQUIRE_KERNEL
      00028 1 KE 0402 KEGD  EXIT  INQUIRE_KERNEL/OK     CICSKPG1,CIA1
      00028 1 ME 0502 MEIN  EXIT  INQUIRE_MESSAGE_DATA/OK 06BB5D7C,06BC5E07,06BC5E1D,06BC5E7C,,I,095757,20071995,M,CIA1,CICSKPG1
      00028 1 ME 0312 MEME  EVENT ISSUE-MVS-GETMAIN
      00028 1 ME 0313 MEME  EVENT MVS-GETMAIN-COMPLETE
13    00028 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8116
      00028 1 DU 0600 DUTM  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8116
      00028 1 DU 0601 DUTM  EXIT  INQUIRE_SYSTEM_DUMPCODE/EXCEPTION DUMPCODE_NOT_FOUND,0,0,,,,
      00028 1 DU 0501 DUDT  EXIT  INQUIRE_SYSTEM_DUMPCODE/EXCEPTION DUMPCODE_NOT_FOUND,0,0,,,,
      00028 1 ME 0401 MEBU  ENTRY BUILD_MESSAGE         06BC5E07,06BB5D7C,20071995,M,095757,CIA1,CICSKPG1,0730369D , 00000009,073
      00028 1 ME 0402 MEBU  EXIT  BUILD_MESSAGE/OK      0
      00028 1 ME FF35 MEFO  ENTRY -FUNCTION(FORMAT_MESSAGE) 0698B390 , 0000006F,1,78,073039EB , 00000001,YES
      00028 1 ME FF36 MEFO  EXIT  -FUNCTION(FORMAT_MESSAGE) OK
14    00028 1 AP F600 TDA   ENTRY WRITE_TRANSIENT_DATA  CDBC,073039FB , 00000001,NO
                                                       .
                                                       .
15    00028 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8210
                                                       .
                                                       .
16    00028 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8292
                                                       .
17                                                     .
      00038 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
18    00038 1 AP 0306 DBCT  EVENT POSTED                FOR CONNECTION COMPLETE
19    00038 1 ME 0301 MEME  ENTRY SEND_MESSAGE          1FA5,0698B240 , 00000004,073D5060 , 00000002,DB
                                                       .
                                                       .
      00038 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8101
                                                       .
                                                       .
20    00038 1 GC 2010 CCCC  ENTRY WRITE                 00108194 , 00000008,DBCTL,STATUS
                                                       .
                                                       .
      00038 1 GC 2050 CCCC  EXIT  WRITE/OK
21    00038 1 PG 0A01 PGLU  ENTRY LINK_URM              DFHDBUEX,001081F0 , 0000000B,NO
      00038 1 DD 0301 DDLO  ENTRY LOCATE                06D08F80,00108220,PPT,DFHDBUEX
      00038 1 DD 0302 DDLO  EXIT  LOCATE/OK             D7D7E3C5 , 06D89A50
                                                       .
                                                       .
22    00038 1 AP 0064 USER  EVENT APPLICATION-PROGRAM-ENTRY CONNECT DBCTL HAS JUST BEEN CONNECTED
                                                       .
                                                       .
      00038 1 AP 1941 APLI  EXIT  START_PROGRAM/OK      ....,DFHDBUEX
      00038 1 LD 0001 LDLD  ENTRY RELEASE_PROGRAM       0732B450,86D5B028
      00038 1 LD 0002 LDLD  EXIT  RELEASE_PROGRAM/OK    06D5B000,3A8,ECDSA
      00038 1 PG 0A02 PGLU  EXIT  LINK_URM/OK
      00038 1 AP 00E1 EIP   ENTRY RESYNC                                                0004,001087C4 ..gD,08001604 ....

Figure 2. CICS trace entries produced during connection to DBCTL 2 of 2

22    00038 1 AP 0064 USER  EVENT APPLICATION-PROGRAM-ENTRY CONNECT DBCTL HAS JUST BEEN CONNECTED
                                                       .
                                                       .
      00038 1 AP 1941 APLI  EXIT  START_PROGRAM/OK      ....,DFHDBUEX
      00038 1 LD 0001 LDLD  ENTRY RELEASE_PROGRAM       0732B450,86D5B028
      00038 1 LD 0002 LDLD  EXIT  RELEASE_PROGRAM/OK    06D5B000,3A8,ECDSA
      00038 1 PG 0A02 PGLU  EXIT  LINK_URM/OK
      00038 1 AP 00E1 EIP   ENTRY RESYNC                                                0004,001087C4 ..gD,08001604 ....
                                                       .
                                                       .
23    00038 1 AP E161 EXEC  EXIT  RESYNC                'DBCTL   ' AT X'0713F062','JB1A    ' AT X'8698B270',AT X'00000000',0 AT X
      00038 1 AP E111 EISR  EXIT  TRACE_EXIT/OK
      00038 1 AP 00E1 EIP   EXIT  RESYNC                OK                              00F4,00000000 ....,00001604 ....
      00038 1 AP 00E1 EIP   ENTRY SYNCPOINT                                             0004,001087C4 ..gD,08001602 ....
                                                       .
                                                       .
      00038 1 AP E161 EXEC  EXIT  SYNCPOINT             0,0,ASM,09490000
                                                       .
                                                       .
24    00028 1 ME 0301 MEME  ENTRY RETRIEVE_MESSAGE      2065,000550A7 , 00000000 , 00000033,E,DB
      00028 1 ME 0501 MEIN  ENTRY INQUIRE_MESSAGE_DATA  86BB5AE0,DFHMET1E,2065,07301F95 , 00000000 , 0000001C,07301F2F , 00000000
                                                       .
                                                       .
      00028 1 ME 0502 MEIN  EXIT  INQUIRE_MESSAGE_DATA/OK 06BB5D7C,06BC7416,06BC742C,06BC744D,I,,095759,20071995,M,CIA1,CICSKPG1
      00028 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8293

Annotations:

Phase 1 of connection begins.
Locating DFHDBCON and loading if not already loaded. (In this example, CICS and DBCTL have already been connected during this CICS session, so DFHDBCON has already been loaded.)
The control transaction, CDBO, is attached. CDBO enables the DRA to pass information from itself and DBCTL independently of CICS. It is invoked whenever the DRA needs to determine whether to continue processing, which is when:
- The DRA has successfully connected to DBCTL
- DBCTL has been terminated normally using /CHECKPOINT FREEZE or /CHECKPOINT PURGE
- Connection to DBCTL has failed
- A CICS request to connect to DBCTL has been canceled
- The DRA fails
- DBCTL fails
Loading programs needed: DFHDBSPX (shown in example), plus DFHDBCX, DFHDBMOX, DFHDBREX, DFHDBSTX, DFHDBSSX, DFHDBTOX, and DFHDBAT.
DFHDBCON enables DFHDBAT.
A timestamp is included in the header line of every page of CICS abbreviated auxiliary trace output to help you match trace entries with external events.
DFHERM invokes DFHDBAT for connection request.
DRA router module DFSPRRC0 loaded.
DRA is invoked for interface request. The type of interface request is indicated by request type from the PAPL: 0100 is a CONNECT request. (See PAPL request and return codes.)
DBCTL return code (00000000). See Return codes in DBCTL.
Control is passed back to DFHERM.
Phase 1 of connection has ended at this point. Message DFHDB8116 is issued confirming that connection is proceeding. The message includes the DBCTL identifier and the DRA suffix used.
When a message has been issued, the CICS dump domain checks to see if the user has requested any action for that message (using the CEMT SET SYDUMPCODE, or the EXEC CICS SET SYSDUMPCODE commands, (In this case, no dump has been requested, as indicated by DUMPCODE_NOT_FOUND.) However, when you are using abbreviated trace, entries such as INQUIRE_SYSTEM_DUMPCODE DB8116 (in which the system dump code is the message number without the characters DFH) are useful in indicating which messages have been issued. (Complete message numbers are included in full trace.)
Message DFHDB8116 is sent to transient data destination CDBC.
Message DFHDB8210 is issued confirming that connection to DBCTL is proceeding.
Message DFHDB8292 is issued indicating that CICS is in phase 2 of connecting to DBCTL.
At this point, DBCTL exits are loaded, which causes I/O activity. The task is suspended, and the control transaction, CDBO, starts. This is indicated by the task number changing (from 00031 to 00032). Control transaction enters a series of waits. CDBO invokes the CICS-DBCTL interface control program (DFHDBCT).
DBCTL notifies CICS that CICS-DBCTL connection is complete.
Message DFHDB8101 is issued.
A record is written to the global catalog, indicating which DBCTL should be reconnected to if there is a CICS failure. (See Program list table (PLT) and Connecting DBCTL to CICS automatically.)
DFHDBUEX, the CICS-supplied user replaceable program for use with DBCTL, is linked. Trace entries following invocation of DFHDBUEX depend on what you have coded in your own version. (See DFHDBUEX.)
In this example, the user has coded DFHDBUEX to issue a trace entry stating that DBCTL has just been connected.
CICS issues an EXEC CICS RESYNC command to resynchronize any outstanding DBCTL indoubt UOWs. (See Recovery and restart operations for DBCTL.)
Control transaction waits have ended: task number changes back again (from 00032 to 00031). Message DFHDB8293 is issued confirming that DBCTL is connected and ready.

Example: Trace entries produced when CICS disconnects from DBCTL

Figure 3. CICS trace entries produced during disconnection from DBCTL

1    1CICS/ESA - AUXILIARY TRACE FROM 07/20/95 - APPLID CICSKPG1 - TIME OF FIRST ENTRY ON THIS PAGE 11:26:58.7144860002
                                                       .
2                                                      .
      00047 1 AP 00E1 EIP   ENTRY START                                                 0004,07301464 ....,08001008 ....
3     00047 1 XM 0401 XMLD  ENTRY LOCATE_AND_LOCK_TRANDEF CDBT
      00047 1 DD 0301 DDLO  ENTRY LOCATE                06D00040,07301820,TXD,CDBT
      00047 1 DD 0302 DDLO  EXIT  LOCATE/OK             06D86C10 , D7000000
                                                       .
                                                       .
4     00047 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8211
                                                       .
                                                       .
5     00047 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8294
                                                       .
                                                       .
6     00048 1 PG 0901 PGPG  ENTRY INITIAL_LINK          DFHDBDSC
                                                       .
                                                       .
7     00048 1 AP 00E1 EIP   ENTRY ADDRESS                                               0004,0005B010 ....,08000202 ....
                                                       .
                                                       .
8     00048 1 PG 0A01 PGLU  ENTRY LINK_URM              DFHDBUEX,0005B0C4 , 0000000B,NO
      00048 1 DD 0301 DDLO  ENTRY LOCATE                06D08F80,0005B3A4,PPT,DFHDBUEX
      00048 1 DD 0302 DDLO  EXIT  LOCATE/OK             D7D7E3C5 , 06D89A50
      00048 1 LD 0001 LDLD  ENTRY ACQUIRE_PROGRAM       0732B450
      00048 1 LD 0002 LDLD  EXIT  ACQUIRE_PROGRAM/OK    86D5B028,06D5B000,3A8,0,REUSABLE,ECDSA,OLD_COPY
9     00048 1 AP 1940 APLI  ENTRY START_PROGRAM         DFHDBUEX,NOCEDF,FULLAPI,URM,NO,07309828,0005B0C4 , 0000000B,2
                                                       .
                                                       .
      00048 1 AP 0065 USER  EVENT APPLICATION-PROGRAM-ENTRY DISCONN DBCTL HAS JUST BEEN DISCONNECTED
                                                       .
                                                       .
10    00048 1 LD 0001 LDLD  ENTRY RELEASE_PROGRAM       0732B450,86D5B028
      00048 1 LD 0002 LDLD  EXIT  RELEASE_PROGRAM/OK    06D5B000,3A8,ECDSA
      00048 1 PG 0A02 PGLU  EXIT  LINK_URM/OK
      00048 1 AP 2520 ERM   ENTRY APPLICATION-CALL-TO-TRUE(DBCTL   )
                                                       .
                                                       .
      00048 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00048 1 AP 0310 DBAT  ENTRY APPLICATION           REQUEST
11    00048 1 AP 0315 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR INTERFACE REQUEST , 0400
12    00048 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR DISCONNECTION REQUEST
      00048 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0005B444,NO,OTHER_PRODUCT
      00048 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00048 1 AP 0305 DBSPX EVENT POSTED                FOR DISCONNECTION REQUEST
13    00048 1 AP 0316 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR INTERFACE REQUEST , 00000000
                                                       .
                                                       .
14    00048 1 ST 0003 STST  ENTRY RECORD_STATISTICS     072F7618 , 00000054,USS
                                                       .
                                                       .
      00048 1 ST 0004 STST  EXIT  RECORD_STATISTICS/OK
      00048 1 AP 0313 DBAT  EXIT  DBAT-RESPONSE-CODE    (00000000)
      00048 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
      00048 1 AP 2521 ERM   EXIT  APPLICATION-CALL-TO-TRUE(DBCTL   )
15    00048 1 GC 2010 CCCC  ENTRY WRITE                 0005B0BC , 00000008,DBCTL,STATUS
16                                                     .
                                                       .
      00048 1 DS 0004 DSSR  ENTRY WAIT_MVS              ASYNRESP,CCVSAMWT,06C8D5C0,NO,IO
      00038 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
17    00038 1 AP 0306 DBCT  *EXC* EVENT                 POSTED FOR DFHDBCT SHOULD TERMINATE
      00038 1 AP 00E1 EIP   ENTRY START                                                 0004,001087C4 ..gD,08001008 ....
                                                       .
                                                       .
      00038 1 XM 0401 XMLD  ENTRY LOCATE_AND_LOCK_TRANDEF CDBD
      00038 1 DD 0301 DDLO  ENTRY LOCATE                06D00040,0730C078,TXD,CDBD
      00038 1 DD 0302 DDLO  EXIT  LOCATE/OK             06D86918 , D7000000
                                                       .
                                                       .
      00038 1 AP 00F3 ICP   ENTRY INITIATE              CDBD                            4003,0000000C ....,00000000 ....,CDBD
                                                       .
                                                       .
18    00049 1 LD 0001 LDLD  ENTRY RELEASE_PROGRAM       DFHDBSSX,8711A910
      00049 1 LD 0002 LDLD  EXIT  RELEASE_PROGRAM/OK
                                                       .
                                                       .
      00049 1 ME 0502 MEIN  EXIT  INQUIRE_MESSAGE_DATA/OK 06BB5D7C,06BC56B8,06BC56CE,06BC5710,,I,100011,20071995,M,CIA1,CICSKPG1
19    00049 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8102

Annotations:

Timestamp.
Phase 1 of disconnection begins at this stage.
The CICS-DBCTL interface disconnection transaction, CDBT, is attached.
Message DFHDB8211 is issued to confirm that orderly disconnection is proceeding. This message is issued in response to the user pressing PF5 on the CDBC screen. (For an immediate disconnection, message DFHDB8212 is issued.)
Message DFHDB8294 is issued confirming that orderly disconnection is in progress. (If immediate disconnection had been requested, message DFHDB8295 would have been issued.)
CDBT invokes CICS-DBCTL interface disconnection program, DFHDBDSC. A wait is entered (task number changes, from 00034 to 00035).
The EXEC interface program, DFHEIP, links to the CICS-DBCTL user-replaceable program, DFHDBUEX.
DFHDBUEX is loaded.
Trace entries at this point depend on what, if anything, you have coded in your own version of DFHDBUEX. (See DFHDBUEX.) In this example, DFHDBUEX has been coded to issue a trace entry stating that DBCTL has just been disconnected.
DFHDBUEX is released and control is passed back to DFHDBDSC.
The DRA is invoked for an interface request. (PAPL request type 0400 indicates the request is a DISCONNECT. See PAPL request and return codes.)
If there is DL/I activity at the time of the disconnect, and the disconnect is orderly (not immediate) DFHDBAT links to DFHDBSPX (the CICS-DBCTL suspend exit) to wait for all DL/I activity to complete. In this example, there was no DL/I activity at the time the disconnect was issued.
The DRA links to DFHDBSPX to cause the CICS task to wait while the DRA processes the disconnect request.
DBCTL return code (00000000). (See Return codes in DBCTL.)
Statistics for this session are recorded. (See DBCTL statistics.)
DFHDBDSC writes a record to the CICS global catalog, to indicate that CICS is no longer connected to DBCTL.
Phase 2 of disconnection begins.
DFHDBDI’s associated transaction, CDBD, runs and disables DFHDBAT to make it unavailable. (The transaction number changes from 00035 to 00032.)
Programs loaded at startup are disabled. This example shows DFHDBSPX. A complete trace should also include similar entries for other programs loaded at startup, as listed in Example: Trace entries produced when CICS connects to DBCTL.
Message DFHDB8102 is issued confirming that disconnection from DBCTL is complete.

Example: Trace entries produced for successful PSB schedule

Figure 4. CICS trace entries produced for successful PSB schedule

                                                       .
                                                       .
1    1CICS/ESA - AUXILIARY TRACE FROM 07/20/95 - APPLID CICSKPG1 - TIME OF FIRST ENTRY ON THIS PAGE 11:26:58.7144860002
                                                       .
                                                       .
      00039 1 AP 00E1 EIP   ENTRY CALLDLI                                               0004,00182718 ....,00004000 .. .
2,3   00039 1 AP 0328 DLI   ENTRY FUNCTION_CODE(PCB )   000C7526,TDLRA1
                                                       .
                                                       .
      00039 1 AP 0330 DLIDP ENTRY DBCTL
                                                       .
                                                       .
      00039 1 AP 2520 ERM   ENTRY APPLICATION-CALL-TO-TRUE(DBCTL   )
                                                       .
                                                       .
      00039 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00039 1 AP 0310 DBAT  ENTRY APPLICATION           REQUEST
4,5   00039 1 AP 0311 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,0301
6     00039 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR THREAD REQUEST
      00039 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0732001C,NO,OTHER_PRODUCT
      00039 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00039 1 AP 0305 DBSPX EVENT POSTED                FOR THREAD REQUEST
4,7   00039 1 AP 0312 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,00000000
      00039 1 AP 0313 DBAT  EXIT  DBAT-RESPONSE-CODE    (00000000)
      00039 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
                                                       .
                                                       .
      00039 1 AP 2521 ERM   EXIT  APPLICATION-CALL-TO-TRUE(DBCTL   )
      00039 1 AP 0331 DLIDP EXIT  DBCTL
      00039 1 AP 0329 DLI   EXIT  IMS_PCB_FORMAT        0000,0000,PCB
8     00039 1 AP 00E1 EIP   EXIT  CALLDLI               OK                              00F4,00000000 ....,00004000 .. .

Annotations:

Timestamp
DL/I command or call type: PCB indicates a schedule request using the DL/I call interface.
PSB name (TDLRA1).
Recovery token (C3C9C3E2D2D7C7F1AB6538123994CA01).
The DRA is invoked for a thread request: 0301 is a PSB schedule request. (See PAPL request and return codes.)
DFHDBAT must wait, because the request has entered IMS code.
The DFHDBAT wait ends and DBCTL return code (00000000) is issued. The DBCTL return code is 00000000 because the PSB was successfully scheduled. See Figure 5 for an example of the DBCTL return code in the case of a PSB scheduling failure. See Return codes in DBCTL for an explanation of DBCTL return codes.
00 in the UIBFCTR, and 00 in the UIBDLTR (underscored in this example) indicate that the PSB was scheduled successfully. See Example: Trace entries produced for failed PSB schedule for an example of the contents of these fields, PSB scheduling fails. See Summary of DBCTL abends and return codes for information on the UIBFCTR and UIBDLTR.

Example: Trace entries produced for failed PSB schedule

Figure 5. CICS trace entries produced for failed PSB schedule

1    1CICS/ESA - AUXILIARY TRACE FROM 07/20/95 - APPLID CICSKPG1 - TIME OF FIRST ENTRY ON THIS PAGE 11:26:58.7144860002
                                                       .
                                                       .
      00064 1 AP 00E1 EIP   ENTRY CALLDLI                                               0004,00182718 ....,00004000 .. .
2,3   00064 1 AP 0328 DLI   ENTRY FUNCTION_CODE(PCB )   000C8946,TXLRA1
                                                       .
                                                       .
      00064 1 AP 0330 DLIDP ENTRY DBCTL
                                                       .
                                                       .
      00064 1 AP 2520 ERM   ENTRY APPLICATION-CALL-TO-TRUE(DBCTL   )
                                                       .
                                                       .
      00064 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00064 1 AP 0310 DBAT  ENTRY APPLICATION           REQUEST
4,5   00064 1 AP 0311 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB654BD5E4F07E04,0301
6     00064 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR THREAD REQUEST
      00064 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0732001C,NO,OTHER_PRODUCT
      00064 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00064 1 AP 0305 DBSPX EVENT POSTED                FOR THREAD REQUEST
      00064 1 AP 0312 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB654BD5E4F07E04,880001AC
      00064 1 AP 0313 DBAT  EXIT  DBAT-RESPONSE-CODE    (00000000)
      00064 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
      00064 1 AP 2521 ERM   EXIT  APPLICATION-CALL-TO-TRUE(DBCTL   )
      00064 1 ME 0301 MEME  ENTRY SEND_MESSAGE          1FAD,00051230 , 00000004,0011F5D0 , 00000005,0011F5D5 , 00000008,0011F3CC
      00064 1 ME 0501 MEIN  ENTRY INQUIRE_MESSAGE_DATA  86BB5AE0,DFHMET1E,1FAD,073017ED , 00000000 , 0000001C,07301787 , 00000000
                                                       .
                                                       .
7     00064 1 DU 0500 DUDT  ENTRY INQUIRE_SYSTEM_DUMPCODE DB8109
                                                       .
                                                       .
      00064 1 AP 0331 DLIDP EXIT  DBCTL
8     00064 1 AP 0329 DLI   EXIT  IMS_PCB_FORMAT        0805,0000,PCB
      00064 1 AP 00E1 EIP   EXIT  CALLDLI               OK                              00F4,00000000 ....,00004000 .. .

Annotations:

Timestamp.
DL/I command or call: PCB indicates a schedule request using the DL/I call interface.
PSB name (TXLRA1).
Recovery token (C3C9C3E2D2D7C7F1AB654BD5E4F07E04).
The DRA is invoked for a thread request: 0301 is a PSB schedule request. (See PAPL request and return codes.)
The reason for the PSB scheduling failure is in the DBCTL return code (880001AC). In this case, it is X'1AC', indicating an IMS user abend U0428 (decimal), which was issued because the PSB was not defined to DBCTL.
Message DFHDB8109 is issued. It contains the IMS user abend, the recovery token, and the DBCTL ID. (For an example and explanation of how messages are displayed in abbreviated trace, see Example: Trace entries produced when CICS connects to DBCTL.)
0805 (underscored in this example) indicates that a PSB scheduling failure has occurred. 08 is in the UIBFCTR, and 05 in the UIBDLTR. (See Summary of DBCTL abends and return codes for information on the UIBFCTR and UIBDLTR.)

Example: Trace entries produced for a DL/I request

Figure 6. CICS trace entries produced for a DL/I request

1    1CICS/ESA - AUXILIARY TRACE FROM 07/20/95 - APPLID CICSKPG1 - TIME OF FIRST ENTRY ON THIS PAGE 11:26:58.7144860002
      00040 1 AP 00E1 EIP   ENTRY CALLDLI                                               0004,00183718 ....,00004000 .. .
2,3   00040 1 AP 0328 DLI   ENTRY FUNCTION_CODE(GU  )   0001A8AC,DLIDBDR
      00040 1 AP 0330 DLIDP ENTRY DBCTL
      00040 1 AP 2520 ERM   ENTRY APPLICATION-CALL-TO-TRUE(DBCTL   )
      00040 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00040 1 AP 0310 DBAT  ENTRY APPLICATION           REQUEST
4,5   00040 1 AP 0311 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB653817A31F9000,0303
      00040 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR THREAD REQUEST
      00040 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0739501C,NO,OTHER_PRODUCT
      00041 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00041 1 AP 0305 DBSPX EVENT POSTED                FOR THREAD REQUEST
4,6   00041 1 AP 0312 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB653817A6C96600,00000000
      00041 1 AP 0313 DBAT  EXIT  DBAT-RESPONSE-CODE    (00000000)
      00041 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
      00041 1 RM 0301 RMLN  ENTRY SET_LINK              01050000,073D69D4 , 00000000 , 00000008,NECESSARY,
      00041 1 RM 0302 RMLN  EXIT  SET_LINK/OK
      00041 1 AP 2521 ERM   EXIT  APPLICATION-CALL-TO-TRUE(DBCTL   )
      00041 1 AP 0331 DLIDP EXIT  DBCTL
7     00041 1 AP 0329 DLI   EXIT  IMS_PCB_FORMAT        0000,0000,PCB
      00041 1 AP 00E1 EIP   EXIT  CALLDLI               OK                              00F4,00000000 ....,0     0004000 .. .

Annotations:

Timestamp.
DL/I command or call: GU indicates a GET UNIQUE request. (See Comparing EXEC DLI commands and DL/I calls and DL/I requests supported.)
DBD name (DLIDBDR).
Recovery token (C3C9C3E2D2D7C7F1AB653817A31F9000).
The DRA is invoked for a thread request: 0303 is a DL/I request. (See PAPL request and return codes.)
DBCTL return code (00000000). (See Return codes in DBCTL.)
Status code in the DIBSTAT (underscored in this example) is 0000, indicating that the request was successful. See Summary of DBCTL abends and return codes for the contents of DIBSTAT in the case of an unsuccessful request.

Example: Trace entries produced during thread termination

Example trace entries produced during PREPARE, COMMIT, and TERMINATE request processing. See Two-phase commit for DBCTL for a description of PREPARE and COMMIT request processing.

Figure 7. CICS trace entries produced during thread termination after DL/I request

                                                       .
                                                       .
1    1CICS/ESA - AUXILIARY TRACE FROM 07/20/95 - APPLID CICSKPG1 - TIME OF FIRST ENTRY ON THIS PAGE 09:59:09.1299476250
2     00039 1 AP 2520 ERM   ENTRY SYNCPOINT-MANAGER-CALL-TO-TRUE(DBCTL   )
      00039 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00039 1 AP 0310 DBAT  ENTRY SYNCPOINT-MANAGER     REQUEST
3,4   00039 1 AP 0311 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,0304
      00039 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR THREAD REQUEST
      00039 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0732001C,NO,OTHER_PRODUCT
      00039 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00039 1 AP 0305 DBSPX EVENT POSTED                FOR THREAD REQUEST
3,5   00039 1 AP 0312 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,00000000
      00039 1 AP 0313 DBAT  EXIT  DBAT-RESPONSE-CODE    (00000004)
      00039 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
      00039 1 AP 2521 ERM   EXIT  SYNCPOINT-MANAGER-CALL-TO-TRUE(DBCTL   )
                                                  .
                                                  .
      00039 1 AP 2520 ERM   ENTRY SYNCPOINT-MANAGER-CALL-TO-TRUE(DBCTL   )
      00039 1 AP 2522 ERM   EVENT PASSING-CONTROL-TO-TRUE(DBCTL   )
      00039 1 AP 0310 DBAT  ENTRY SYNCPOINT-MANAGER     REQUEST
3,6   00039 1 AP 0311 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,0307
      00039 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR THREAD REQUEST
      00039 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0732001C,NO,OTHER_PRODUCT
                                                  .
                                                  .
      00039 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00039 1 AP 0305 DBSPX EVENT POSTED                FOR THREAD REQUEST
3,5   00039 1 AP 0312 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,00000000
      00039 1 MN 0201 MNMN  ENTRY MONITOR               1,DBCTL,7320090,100
      00039 1 MN 0202 MNMN  EXIT  MONITOR/OK
3,7   00039 1 AP 0311 DBAT  EVENT ABOUT-TO-INVOKE-DRA   FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,030F
      00039 1 AP 0304 DBSPX EVENT ABOUT-TO-ISSUE-WAIT   FOR THREAD REQUEST
      00039 1 DS 0004 DSSR  ENTRY WAIT_MVS              DLSUSPND,DBCTL,0732001C,NO,OTHER_PRODUCT
                                                  .
                                                  .
      00039 1 DS 0005 DSSR  EXIT  WAIT_MVS/OK
      00039 1 AP 0305 DBSPX EVENT POSTED                FOR THREAD REQUEST
3,5   00039 1 AP 0312 DBAT  EVENT RECEIVES-CONTROL-FROM-DRA FOR THREAD REQUEST , C3C9C3E2D2D7C7F1AB6538123994CA01,00000000
      00039 1 AP 2523 ERM   EVENT REGAINING-CONTROL-FROM-TRUE(DBCTL   )
8     00039 1 AP 2521 ERM   EXIT  SYNCPOINT-MANAGER-CALL-TO-TRUE(DBCTL   )

Annotations:

Timestamp.
Enters syncpoint manager.
Recovery token (C3C9C3E2D2D7C7F1AB6538123994CA01).
The DRA is invoked for a thread request: 0304 is a PREPARE request. See PAPL request and return codes.
DBCTL return code (00000000), one for each of the requests PREPARE, COMMIT, and TERMINATE THREAD.
The DRA is invoked for a thread request: 0307 is a COMMIT request. See PAPL request and return codes.
The DRA is invoked for a thread request: 030F is a TERMINATE THREAD request. See PAPL request and return codes.
Leaves syncpoint manager. (See Return codes in DBCTL.)