Exit routine processing

The display routine receives control to provide status information about the component trace for the DISPLAY TRACE operator command. The CTSSDSPI bit indicates that trace display information is to be provided.

When the display routine receives control it should:
  • Set one of the following bits in the CTSS to indicate trace mode:
    • CTSSDON - to indicate that the trace mode is ON.
    • CTSSDOFF - to indicate that the trace mode is OFF.
    • CTSSDMIN - to indicate that the trace mode is MIN.
  • Parse the options in the OPTIONS parameter passed to the routine. These are the options that were specified by the operator on a previously issued TRACE CT command either by operator reply or in a CTncccxx parmlib member. If the options being traced are different than those passed to the routine, the routine should update the CTSS with the trace options in effect.
  • If the routine detects errors, it can issue a WTO using the console ID and CART specified in field CTSSBUFS, and set a failing return code.
  • Set the trace buffer size in the CTSS.
  • Use the 16 bytes of user data in the CTSSUSRD field. The application can specify this user data on CTRACE DEFINE with the USERDATA parameter, or in the CTSSUSRD field when the start/stop routine gets control.
  • If the routine detects no errors, set the return code to zero.
  • Establish the returned general purpose registers. See Return specifications for the return specifications.
  • Return control to component trace.
Parent topic: Coding a display trace exit routine