gtpi1m5fSystem Installation Support Reference

Trace-by-Terminal

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

  1. IBM ships this user exit as a C function coded with a return value of TRUE.
  2. 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.