| 1 | Control value | Input | Char(10) |
| 2 | Error code | I/O | Char(*) |
The Control Trace (QWTCTLTR) API turns the early trace function on and off. The value of *ON is passed to the program to turn the early tracing on, and *OFF is passed to turn the early tracing off.
When the early trace function is turned on, the jobs that are set up by the Set Trace (QWTSETTR) API begin tracing as soon as they are started. The tracing is stopped by turning it off with the Control Trace (QWTCTLTR) API. When *OFF or *RESET is passed to the program, this causes the trace information for the jobs to dump to spooled files.
The information set up by this API remains in effect during an initial program load (IPL).
This API should be used only when recommended by your IBM® service representative.
None.
The value passed to turn the early trace function on or off. The valid values are:
| *ON | Turns early tracing on. |
| *OFF | Turns early tracing off and stops any trace activity started by this API. |
| *RESET | Turns early tracing off, stops any trace activity started by this API, and clears the space that contains the information that was set up by the QWTSETTR API. |
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.
| Message ID | Error Message Text |
|---|---|
| CPF119D E | Value &1 specified for parameter not valid. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |