gtpi1m5f | System Installation Support Reference |
The trace-by-terminal user exit, CDBUXT, is part of the TPF Assembler
Debugger for VisualAge Client and TPF C Debugger for VisualAge Client and
allows you to verify additional information in the entry control block (ECB)
against a user token field that is stored in the trace entry. The user
token data is supplied by the user on the TPF Registration Window.
CDBUXT is called from segment CDBTBT, which is the entry point function for
CDB0.
Input
- itbtentry
- The structure that maps the trace entry that will be attached to the
active ECB. The definition of the itbtentry structure is contained in
the c$term.h header file.
Programming Considerations
- IBM ships this user exit as a C function coded with a return value of
TRUE.
- CDBUXT is an object file that is linked into CDB0, which is a C dynamic
load module (DLM). The interface to CDBUXT is a C function call;
the user exit code can be written in assembler if the TMSPC and TMSEC macros
are used for the corresponding prolog and epilog.
Return Values
- TRUE
- Attach the trace entry to the ECB.
- FALSE
- Do not attach the trace entry to the ECB. On return from CDBUXT,
CDBTBT continues searching its tables for another trace entry that matches
this ECB. CDBUXT is called again if another match is found.