Previous Topic: DBUG Trace Entries PanelNext Topic: Open Transaction Environment


DBUG Example - Reviewing an Online Application

In the following example, the Debugging Facility (DBUG) is used to review an online application.

Step 1

Initiate the Debugging Facility by clearing the screen on terminal D028 and entering the DBUG transaction ID. The Debugging Facility acknowledges this transaction with the Interception Specifications panel, where the intercept is specified to occur both before and after every CA Datacom/DB request. Specify a different terminal ID D107.

DBUG INTERCEPTION SPECIFICATIONS CA DATACOM THE INTERCEPT WILL APPEAR ON THIS TERMINAL WHEN : both (BEFORE, AFTER OR BOTH) TERMID : D107 (REMOTE TERMINAL ID OR **** FOR MONITOR MODE)

The Debugging Facility acknowledges this input with the following message:

DC03027I - REQUEST SERVICED

Step 2

On terminal D107, enter the transaction ID for the application to be debugged. The Debugging Facility acknowledges that the transaction is being intercepted and displays the message:

dbac***YOUR TRANSACTION IS INTERCEPTED BY TERMINAL - D028

Step 3

Since the Debugging Facility was initiated specifying BOTH, the Debugging Facility intercepts the transaction before it accesses CA Datacom/DB, and presents the following screen on terminal D028.

DBUG 20 PRIMARY INTERCEPTION CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +00C8 TASK NR: 0000299 DISPLAY: CUR CALL: DBNTRY TERM ID: D107 INTERCEPTED BEFORE EXECUTION CMD: LOCKY TBL: PMF DBID: 00001 KEYNAME: STZIP URT: MUF: REC LEN: SIDNAME: MUFN/SUB: SIO: UID AREA : DCCACPR DB/CICS 14.0 SAMPLE ....................... AT 386FD428 REQ AREA : LOCKYPMFSTZIP.. .. AT 379106AF KEY VALUE: TX00000............................................... AT 379106FB WORK AREA: ...................................................... AT 00000000 ELEMENTS : AT 00000000 RQA AREA : ...................................................... AT 00000000 RETURN CODE: INTERNAL CODE: DBUG CMD: BOTH REFRESH: NR OF CALLS TO SKIP: 000 PF1 : PF2 : SWITCH HEX/CHAR PF3 : END DBUG SESSION PF4 : PF5 : STORAGE AREAS PF6 : USERS DISPLAY PF7 : PF8 : PF9 : INTERCEPT CRITERIA PF10: PF11: REVIEW TRACE PF12: ABEND USER TASK

Step 4

Press PF2 to change the display to hexadecimal mode, and the Debugging Facility responds with the following display:

DBUG 20                     PRIMARY INTERCEPTION                     CA Datacom  TRAN ID: DBAC    PROGRAM: DCCACPR  +00A0      TASK NR: 0000299     DISPLAY: CUR  CALL: DBNTRY     TERM ID: D107        INTERCEPTED BEFORE EXECUTION    CMD: LOCKY TBL: PMF DBID: 00001 KEYNAME: STZIP URT:      MUF:    REC LEN:                                  SIDNAME:    MUFN/SUB:   SIO:    UID AREA : C4C2C3C1D4D7D940C4C261C3C9C3E240F24BF24BF040E2C1D4D7D3   AT 21D61A28    REQ AREA : D3D6C3D2E8D7D4C6E2E3E9C9D7F3F6400001404040404040404040   AT 2130067F    KEY VALUE: E3E7F0F0F0F0F00000000000000000000000000000000000000000   AT 213006CB    WORK AREA: ......................................................   AT 00000000    ELEMENTS :                                                          AT 00000000    RQA AREA : ......................................................   AT 00000000                      RETURN CODE:    INTERNAL CODE:  DBUG CMD: BOTH           REFRESH:                   NR OF CALLS TO SKIP: 000  PF1 :                    PF2 : SWITCH HEX/CHAR      PF3 : END DBUG SESSION  PF4 :                    PF5 : STORAGE AREAS        PF6 : USERS DISPLAY  PF7 :                    PF8 :                      PF9 : INTERCEPT CRITERIA  PF10:                    PF11: REVIEW TRACE         PF12: ABEND USER TASK

Step 5

Press PF2, then Enter; the Debugging Facility allows the transaction to continue with its CA Datacom/DB access. After the transaction has accessed CA Datacom/DB, the Debugging Facility intercepts it and presents the following display:

DBUG 20 PRIMARY INTERCEPTION CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +00C8 TASK NR: 0000299 DISPLAY: CUR CALL: DBNTRY TERM ID: D107 INTERCEPTED AFTER EXECUTION CMD: LOCKY TBL: PMF DBID: 00001 KEYNAME: STZIP URT: 0001 MUF: 01 REC LEN: 00000 SIDNAME: DBDVM5 MUFN/SUB: DBDVMUF5 SIO: 0000 UID AREA : DCCACPR DB/CICS 14.0 SAMPLE ....................... AT 386FD428 REQ AREA : LOCKYPMFSTZIP .........A.......H...... . .. AT 379106AF KEY VALUE: TX75243............................................... AT 379106FB WORK AREA: ...................................................... AT 00000000 ELEMENTS : AT 00000000 RQA AREA : ...................................................... AT 00000000 RETURN CODE: INTERNAL CODE: DBUG CMD: BOTH REFRESH: NR OF CALLS TO SKIP: 000 PF1 : PF2 : SWITCH HEX/CHAR PF3 : END DBUG SESSION PF4 : PF5 : STORAGE AREAS PF6 : USERS DISPLAY PF7 : PREVIOUS DISPLAY PF8 : PF9 : INTERCEPT CRITERIA PF10: REVIEW URT PF11: REVIEW TRACE PF12: ABEND USER TASK

Step 6

At this point, it is decided that only the data needs to be examined after CA Datacom/DB access. Therefore, AFTER is entered in the DBUG CMD field.

                   RETURN CODE: __  INTERNAL CODE: ___  DBUG CMD: AFTER                           NR OF CALLS TO SKIP  ___  PF1 :                    PF2 : SWITCH HEX/CHAR      PF3 : END DBUG SESSION  PF4 : REGISTERS          PF5 : WORKING STORAGE      PF6 : USERS DISPLAY  PF7 : PREVIOUS DISPLAY   PF8 :                      PF9 : INTERCEPT CRITERIA  PF10: REVIEW URT         PF11: TRACE ENTRIES        PF12: ABEND PROGRAM

Step 7

The Debugging Facility accepts this request with another primary intercept as follows:

DBUG 20                     PRIMARY INTERCEPTION                     CA Datacom  TRAN ID: DBAC    PROGRAM: DCCACPR  +012A      TASK NR: 0000299     DISPLAY: CUR  CALL: DBNTRY     TERM ID: D107        INTERCEPTED AFTER EXECUTION    CMD: REDLE TBL: PMF DBID: 00001 KEYNAME: STZIP URT: 0001 MUF: 01 REC LEN: 00075                                  SIDNAME: DBSIDPR  MUFN/SUB: DBDVMUF5 SIO:  0000

Step 8

Place the cursor in the Request Area and press PF5 to take a closer look at the Request Area. In response, the Debugging Facility presents the following display:

DBUG 33                     CALL-REQUEST AREA                        CA Datacom  TRAN ID: DBAC    PROGRAM: DCCACPR  +0012A     TASK NR: 0000299     DISPLAY:  03  CALL: DBNTRY     TERM ID: D107    2130067F +0000   D9C5C4D3 C5D7D4C6 E2E3E9C9 D7404040   * REDLEPMFSTZIP    *  2130068F +0010   00010002 00000009 00C30000 00050000   * .........C...... *  2130069F +0020   00C80517 05230107 40404040 40404040   * .H......         *  213006AF +0030   40484040 0000004B 00000040 00000002   *  .  ....... .... *  213006BF +0040   40404040 40404040 40070002 E3E7F7F5   *          ...TX75 *  213006CF +0050   F2F4F3F0 F0F0F0F9 D3E4E3C8 C5D940C7   * 24300009LUTHER G *  213006DF +0060   C1D9E840 40404040 40404040 40404040   * ARY              *  213006EF +0070   F1F3F4F1 F040D6D5 E8E74040 40404040   * 13410 ONYX       *  213006FF +0080   40404040 40404040 C4C1D3D3 C1E24040   *         DALLAS   *  2130070F +0090   40404040 404040E3 E7F7F5F2 F4F30040   *        TX75243.  *  2130071F +00A0   40404040 40404040 40404040 40404040   *                  *  2130072F +00B0   40404040 404040C5 D4D7D3D6 E8C5C5E2   *        EMPLOYEES *  2130073F +00C0   40C9D540 E3C8C540 E2E3C1E3 C540D6C6   *  IN THE STATE OF *  2130074F +00D0   40E3C5E7 C1E24040 40404040 40404040   *  TEXAS           *  2130075F +00E0   40404040 40404040 40404040 40404000   *                . *  2130076F +00F0   00000000 00000000 00000000 00000000   * ................ *  PF1 :                    PF2 : REMEMBER             PF3 : FORMATTED  PF4 : CALL-UID AREA      PF5 : WORKING STORAGE      PF6 : CALL-KEY AREA  PF7 : BACKWARD           PF8 : FORWARD              PF9 : CALL-WORK AREA  PF10: CALL-ELEMENT AREA  PF11:                      PF12: RETURN TO PRIMARY

Step 9

From this panel, you can see storage used by the Request Area, but individual fields are hard to determine. Press PF3 to get a formatted Request Area. In response, the Debugging Facility presents the following display:

DBUG 34                     REQUEST AREA FORMATTED                   CA Datacom  TRAN ID: DBAC    PROGRAM: DCCACPR  +0012A     TASK NR: 0000299     DISPLAY:  CALL: DBNTRY     TERM ID: D107        INTERCEPTED AFTER EXECUTION    DB CMD                    RQA FEEDBK  |    TABLE   RTN CDE      |                                  BLK  |    |  KEYN | INTRNL     SECTION                            |  |    |  |    | |DBID 0001 |ENTRY                             | SKP CNT 016448  |    |  |    | ||         |                                  |         |  ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+.  REDLEPMFSTZIP   .........C.......H......         .  ....... ....         ...  DCCDCDDCEEECD444000000000C0000000C010200444444444444000400040000444444444000  9543574623997000010200090300050008575317000000000800000B00000002000000000702  ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+.                 |  | |   |               |   |     | |                 |  | BLK RECD            |   |     | I/O CNT 00000                 |  TID                   |   |     MAX CNT                 |  RECID..               |   SET NUMBER 000164480                 UPDATE INTENT            SET REC CNT    PF1 :                    PF2 : REMEMBER             PF3 :  PF4 : CALL-UID AREA      PF5 : CALL-REQUEST AREA    PF6 : CALL-KEY AREA  PF7 :                    PF8 :                      PF9 : CALL-WORK AREA  PF10: CALL-ELEMENT AREA  PF11:                      PF12: RETURN TO PRIMARY

Step 10

Since no problems are seen in the Request Qualification Area, press PF6 to examine the call key area. The Debugging Facility responds with the following display.

DBUG 35 CALL-KEY AREA CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +00152 TASK NR: 0000299 DISPLAY: 03 CALL: DBNTRY TERM ID: D107 379206FB +0000 E3E7F7F5 F2F4F3F0 F0F0F0F9 D3E4E3C8 * TX7524300009LUTH * 3792070B +0010 C5D940C7 C1D9E840 40404040 40404040 * ER GARY * 3792071B +0020 40404040 F1F3F4F1 F040D6D5 E8E74040 * 13410 ONYX * 3792072B +0030 40404040 40404040 40404040 C4C1D3D3 * DALL * 3792073B +0040 C1E24040 40404040 404040E3 E7F7F5F2 * AS TX752 * 3792074B +0050 F4F30040 40404040 40404040 40404040 * 43. * 3792075B +0060 40404040 40404040 404040C5 D4D7D3D6 * EMPLO * 3792076B +0070 E8C5C5E2 40C9D540 E3C8C540 E2E3C1E3 * YEES IN THE STAT * 3792077B +0080 C540D6C6 40E3C5E7 C1E24040 40404040 * E OF TEXAS * 3792078B +0090 40404040 40404040 40404040 40404040 * * 3792079B +00A0 40404000 00000000 00000000 00000000 * ............. * 379207AB +00B0 00000000 00000000 00000000 00000000 * ................ * 379207BB +00C0 00000000 00000000 00000000 00000000 * ................ * 379207CB +00D0 00000000 00000000 00000000 00000000 * ................ * 379207DB +00E0 00000000 00000000 00000000 00000000 * ................ * 379207EB +00F0 000000C3 C9E3E840 40404040 40404040 * ...CITY * PF1 : PF2 : REMEMBER PF3 : FORMATTED PF4 : CALL-UID AREA PF5 : CALL-REQUEST AREA PF6 : WORKING STORAGE PF7 : BACKWARD PF8 : FORWARD PF9 : CALL-WORK AREA PF10: CALL-ELEMENT AREA PF11: PF12: RETURN TO PRIMARY

Step 11

Since no problems are seen in the Request Qualification Area, press PF6 to examine the formatted key area. The Debugging Facility responds with the following display:

DBUG 36 KEY AREA FORMATTED CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +0012A TASK NR: 0000299 DISPLAY: CALL: DBNTRY TERM ID: D107 INTERCEPTED AFTER EXECUTION KEY VALUE ONE TX7524300009LUTHER GARY 13410 ONYX 1...+....10...+....20...+....30...+....40...+....50...+....60 DALLAS TX75243. EMPLOYEES IN 61..+....70...+....80...+....90...+....100..+....110..+....120 THE STATE OF TEXAS ................. 121.+....130..+....140..+....150..+....160..+....170..+....180

Step 12

Review the Formatted Key Area and press PF12 to return to the primary intercept panel:

DBUG 20 PRIMARY INTERCEPTION CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +012A TASK NR: 0000299 DISPLAY: CUR CALL: DBNTRY TERM ID: D107 INTERCEPTED AFTER EXECUTION CMD: REDLE TBL: PMF DBID: 00001 KEYNAME: STZIP URT: 0001 MUF: 01 REC LEN: 00075 SIDNAME: DBSIDPR MUFN/SUB: DBDVMUF5 SIO: 0000

Step 13

Press PF10 to review the specifications in the URT, and the Debugging Facility responds with:

DBUG 52 URT 0001 BEING USED CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +0338 TASK NR: 0000299 DISPLAY: 03 CALL: DBNTRY TERM ID: D107 INTERCEPTED AFTER EXECUTION TYPE: STD WHEN TO OPEN: AUTO STATUS: OPEN MUF: 01 ABEND= NO CBSIO= 000000 PRTY= 07 TXUNDO= YES TIMEMIN= 000 TIMESEC= 000 USRINFO= DBSAMPLE-ONL-URT AUTHID= AB TABLE DBID SYNONYM BYPOPEN UPDATE AUTODXC MDBID PAY 00001 YES NO YES NO PMF 00001 YES NO YES NO POH 00001 YES NO YES NO POL 00001 YES NO YES NO PNC 00001 YES NO YES NO PNM 00001 YES NO YES NO PF1 : PF2 : REMEMBER PF3 : PF4 : PF5 : STORAGE AREAS PF6 : USERS DISPLAY PF7 : BACKWARD PF8 : FORWARD PF9 : PF10: PF11: REVIEW TRACE PF12: RETURN TO PRIMARY

Step 14

Press PF11 to review the internal CA Datacom/DB trace table to see what commands this task has performed and the Debugging Facility responds with:

DBUG 54                     TRACE ENTRIES                            CA DATACOM  TRAN ID: DBAC    PROGRAM: DCCACPR  +0298      TASK NR: 0000299     DISPLAY:  03  CALL: DBNTRY     TERM ID: D107        INTERCEPTED AFTER EXECUTION    SEQ   TIME    TASK TERM TRAN PROGRAM  TCB CMMD TBL KEY   RTN  MUF URT DBID  OPR  NR  HH:MM:SS    ID   ID   ID NAME      ID          NAME  CODE ID    ID       ID  001  1:42:60   299 D107 DBAC DCCACPR  001 LOCKYPMFSTZIP       01  0001 00001                            PF1 :                    PF2 : REMEMBER             PF3 :  PF4 :                    PF5 : STORAGE AREAS        PF6 : USERS DISPLAY  PF7 : BACKWARD           PF8 : FORWARD              PF9 :  PF10: REVIEW URT         PF11: REVIEW TRACE         PF12: RETURN TO PRIMARY

Step 15

When PF6 is pressed to review the User's display showing on remote terminal D107, the Debugging Facility responds with:

DBAC

Step 16

Press any key to return to the previous DBUG display, which is the Trace Table, or in this case, press PF12 to go back to the primary intercept panel.

DBUG 20                     PRIMARY INTERCEPTION                     CA DATACOM  TRAN ID: DBAC    PROGRAM: DCCACPR  +012A      TASK NR: 0000299     DISPLAY: CUR  CALL: DBNTRY     TERM ID: D107        INTERCEPTED AFTER EXECUTION    CMD: REDLE TBL: PMF DBID: 00001 KEYNAME: STZIP URT: 0001 MUF: 01 REC LEN: 00075                                  SIDNAME: DBSIDPR  MUFN/SUB: DBDVMUF5 SIO:  0000

Step 17

Press PF3 to terminate Debugging Facility intercept for terminal D107 and the Debugging Facility returns control to the application which finishes the task with the following on terminal D028.

                        EMPLOYEES IN THE STATE OF TEXAS   CITY               NAME                            TOTAL COMP             TAXES   DALLAS             LUTHER GARY                      10,392.00            700.00 DALLAS             PATTERSON AL                     11,400.00            850.00 DALLAS             EVERS DANNY                      34,350.00          5,500.00 DALLAS             SEAGRAVES ROBERT                 28,100.00          5,300.00 DALLAS             MOORE VICTOR                     21,590.00          4,650.00 DALLAS             HAWKINS ANDREW                   19,540.00          2,650.00 DALLAS             KELLY EUGENE                     10,860.00          1,000.00 DALLAS             WHITE PAUL                       19,070.00          2,500.00 DALLAS             ERWIN ROY                        17,690.00          2,200.00 DALLAS             HOYLE RUTH                       18,340.00          2,400.00 DALLAS             ROCKWELL SUSAN                   16,410.00          1,900.00 DALLAS             FLYNN GARY                       16,920.00          2,000.00 DALLAS             WEIR HARVEY                      10,600.00            800.00 DALLAS             BEACH MARCUS                     10,704.00            800.00 DALLAS             LONG ROY                         13,460.00          1,150.00 DALLAS             FIELDS BEN                       13,210.00          1,200.00 DALLAS             BICKMAN FRANK                    12,880.00          1,000.00 DALLAS             EVERTS PRICE                     12,460.00          1,000.00 DALLAS             GRIER BRAD                       12,040.00            950.00