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.