DBUG Review URT Panel

Debugging Facility (DBUG) › DBUG Panel Descriptions › DBUG Review URT Panel

DBUG Review URT Panel

The URT panel provides a synopsis of the contents of the URT used to fulfill the application CA Datacom/DB request. The body of this panel is divided into the following three parts:

The first line displays how the URT is defined to CA Datacom CICS Services
The second line displays the DBURSTR parameter values which define the URT identified in the heading.
The remaining lines display the DBURTBL parameter values which define the tables referenced in the URT.

DBUG 52 URT 0001 BEING USED CA Datacom TRAN ID: DBAC PROGRAM: DCCACPR +0200 TASK NR: 0000099 DISPLAY: 01 CALL: DBNTRY TERM ID: U003 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= xxxxxxxxxxxxxxxxxx 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

Function Key Assignments

Key	Function
PF2	REMEMBER: Saves panel for review from Primary Interception panel.
PF5	STORAGE AREAS: Displays application Request Area working storage.
PF6	USERS DISPLAY: Displays full-screen containing the last user entry.
PF7	BACKWARD: Scrolls backward through the trace table.
PF8	FORWARD: Scrolls forward through the trace table.
PF11	REVIEW TRACE: Displays the Trace Entries panel, listing all traced CA Datacom/DB requests associated with this task.
PF12	RETURN TO PRIMARY: Returns the Primary Interception panel.
Enter	No function.

Field Descriptions

TYPE

Displays a code for the type of URT as follows:

STD: URT you defined for applications issuing CA Datacom/DB commands DBSQL=NO in the DBUREND macro of the URT definition.
SQL: URT you defined for applications issuing SQL statements; DBSQL=YES in the DBUREND macro of the URT definition.
DYN: URT dynamically built by another CA product.

WHEN TO OPEN

Identifies when the URT is opened as follows:

PLT: CA Datacom CICS Services opens the URT at startup time.
AUTO: URT is opened automatically by CA Datacom CICS Services when an application program request needs it.
DEFER: URT can be opened only with an explicit DBEC or DBOC command.

STATUS

Display the status of the URT as follows:

UNOPENED: Not yet opened by a program call or a DBOC or DBEC transaction.
CLOSED: Explicitly closed with a DBEC or DBOC CLOSE=.
CLOSING: Close pending completion of a read in progress or a transaction having exclusive control.
OPEN: Opened by CA Datacom CICS Services.
OPENING: Open requested but not yet open, possibly pending connection to MUF.

MUF

Displays 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.

ABEND

This value is ignored in CA Datacom/DB r11 and higher. Specify as NO for a release of the URT before CA Datacom/DB r11.

CBSIO

Displays the value specified in URT generation for I/O limit interrupt for all SELxx commands except SELPR.

PRTY

Displays the value specified in URT generation for priority level within MUF using this URT, where 1 is lowest priority and 15 is highest priority.

TXUNDO

Specifies that the transaction backout option is in effect for all update transactions using this URT.

TIMEMIN

Specifies the TIMEMIN value in URT generation which defines the exclusive control wait time limit in minutes.

TIMESEC

Specifies the TIMESEC value in URT generation which defines the exclusive control wait time limit in seconds. If no value is displayed in MIN or SEC field, there is no limit on the time a task can hold a record under exclusive control.

USRINFO

Specifies the USRINFO value specified in the URT generation macro.

AUTHID

Specifies the AUTHID specified in the URT generation macro or has been specified in Services using the DBCVTPR macro or dynamic plan switching.

TABLE

Displays the name of the CA Datacom/DB table within the URT.

DBID

Displays ID of the database where the corresponding table resides.

SYNONYM

One of the following values:

YES: Indicates that SYNONYM=YES is specified in the DBURTBL macro for this URT.
NO: Indicates that SYNONYM=NO is specified in the DBURTBL macro for this URT.

BYPOPEN

One of the following values:

YES: When the URT is opened, the designated table is bypassed from the opening. Any attempt to access this table, using this URT, results in a CA Datacom/DB return code of 05.
NO: When the URT is opened, the designated table is opened during the opening.

UPDATE

One of the following values:

YES: This URT permits applications to update the named table.
NO: Updates on the named table are not permitted using this URT.

AUTODXC

One of the following values:

NO: Indicates that CA Datacom/DB does not automatically drop exclusive control for this table when a second command is issued from the same Request Area.
YES: Indicates that CA Datacom/DB automatically drops exclusive control for this table when a second command is issued from the same Request Area.

MDBID

Blank for a non-global URT. For a global URT using DBID remapping, it is the DBID that is remapped from the request and passed to the MUF.