Previous Topic: Format Options for CriteriaNext Topic: DBUG Storage Panel


DBUG Primary Interception Panel

DBUG 20                     PRIMARY INTERCEPTION                     CA Datacom TRAN ID: DBAC    PROGRAM: DCCACPR  +00A0      TASK NR: 0000064     DISPLAY: CUR CALL: DBNTRY TERM ID: U047 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 

DBUG 20 PRIMARY INTERCEPTION CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +00C8 TASK NR: 0000104 DISPLAY: CUR CALL: DBNTRY TERM ID: U047 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

Function Key Assignments

Key

Function

PF2

SWITCH HEX/CHAR: Switches display from hexadecimal to character or from character to hexadecimal.

PF3

END DBUG SESSION: Terminates the interception of requests for any transaction on this terminal. Applications continue executing.

PF5

STORAGE AREAS: If the cursor is on one of five Request Areas, invokes Storage panel starting at the address of indicated area. Otherwise, displays application Request Area working storage.

PF6

USER DISPLAY: Displays full-screen containing the last user entry.

PF7

PREVIOUS DISPLAY: Displays up to ten previous panels.

PF9

INTERCEPT CRITERIA: Displays the Intercept Specifications panel.

PF10

REVIEW URT: Displays the URT nnnn Being Used panel, if it is invoked after the first intercept; otherwise, N/A.

PF11

REVIEW TRACE: Displays the Trace Entries panel, listing all traced CA Datacom/DB requests associated with this task.

PF12

ABEND USER TASK: With no message: Redisplays current panel with the following message:

ENTER ABEND CODE: ____ AND PRESS PF12

After making an entry in this four position field with your choice of code: abnormally ends task with specified abend code and terminates the Debugging Facility for any transaction on this terminal.

Enter

Edits the entered data. If any entry contains an error, returns an error message; otherwise, accepts the entered data and returns to the intercepted program.

Field Descriptions

This section describes each field on the Primary Intercept Panel. If you enter any data in a field on this panel, do not use the ERASE EOF key to clear out any extraneous data.

Note: All changes are case-sensitive. Use the proper case when entering data.

CMD

The CA Datacom/DB command at the time of the intercept.

TBL

The name of the table in the Request Area at the time of the intercept.

DBID

The CA Datacom/DB database ID in the Request Area at the time of the intercept.

KEYNAME

The CA Datacom/DB key name in the Request Area at the time of the intercept.

URT

The URT number associated with the request being executed.

MUF

The relative number of the DBCSID macro appended to the DBCVTPR (or 01 in a single MUF environment) which defines the connection to the MUF. For a non-global URT, this defaults to 1. For a global URT, it is the number of the MUF defined with the matching SID module.

REC LEN

The record length returned after the request is executed. If zeros, the address is unavailable.

SIDNAME

The value specified in the relative DBCSID macro (of the DBCVTPR generation) for the name of the DBSIDPR macro-generated module loaded and used for this MUF.

MUFN/SUB

This field displays the MUF name if the SIDNAME module is assembled with the MUFNAME= MUF name that matches the MUF name specified in the MUF startup option MUF. Otherwise, this field displays the number of the SVC and SVC sub-ID associated with this MUF, as defined in the SIDNAME module.

SIO

The number of physical I/O events required to satisfy the request. Returned only after the request is executed.

UID AREA

The first parameter of the CA Datacom/DB request is a 32-byte User Information Block. The trailing field, preceded by AT, is the address of the UID.

REQ AREA

Displays the first 54 bytes of the Request Area. The trailing field, preceded by AT, is the address of the Request Area.

KEY VALUE

Displays the first 54 bytes of the 360-byte Key Value field of the Request Area. The trailing field, preceded by AT, is the address of the key value area.

WORK AREA

Displays area provided by the program being intercepted, to receive data accessed from CA Datacom/DB. The trailing field, preceded by AT, is the address of the Work Area.

ELEMENTS

Displays the list of element names provided by the application. The trailing field, preceded by AT, is the address of the Element List.

RQA AREA

Displays the Request Qualification Area, if any. The trailing field, preceded by AT, is the address of the RQA.

RETURN CODE

Displays the 2-byte return code returned after a CA Datacom/DB access.

INTERNAL CODE

Displays a 3-byte decimal representation of the 1-byte binary Internal Return Code, which is associated with the displayed Return Code.

DBUG CMD

Displays current DBUG intercept:

AFTER

Intercept after the request has executed

BEFORE

Intercept before the request has executed

BOTH

Intercept before and after request execution

RELEASE

Release terminal from the Debugging Facility

NR OF CALLS TO SKIP

Displays a 3-byte number. This number is a count of DBUG interceptions desired to be skipped before an intercept screen is displayed.