gtpi1m0zSystem Installation Support Reference

Debugger Trace Selection

User exit routine UCCDBTS is called when the TPF Assembler Debugger for VisualAge Client is about to assign a trace-by-program entry to the application entry control block (ECB). This user exit permits you to verify additional information in the ECB against a user token field that is stored in the trace entry. You supply the user token data on the TPF registration window. UCCDBTS is called if the DBTS exit point is active. Exit point DBTS is located in CSECT CCENBK.

General Conditions at Entry

The registers at entry to UCCDBTS are:

R1
IPROG trace entry that will be assigned to the ECB.

R6
Pointer to page 2 of the ECB.

R7
Pointer to the name of the program that will be entered.

R9
Pointer to page 1 of the ECB.

R11-R15
See User Exit Routines - Common Entry Conditions.

System Conditions at Entry

System state
Supervisor

System mask
Inherited from the application

Protect key
0

Address Space
SVM or EVM.

Programming Considerations at Entry

See User Exit Routines - Common Programming Considerations for considerations.

Programming Considerations on Return

See User Exit Routines - Common Return Conditions.

General Conditions on Return

  1. Register 5 (R5) must contain a return code.

    0
    Returning a value of 0 causes the trace entry to be attached to the ECB.

    1
    If you decide that the trace entry that was passed to the user exit should not be attached to the ECB, return a value of 1. Segment CCED continues to search its tables for another trace entry that matches this ECB. The user exit is called again if another match is found.
  2. See User Exit Routines - Common Return Conditions.