Control Trace (QWTCTLTR) API
Required Parameter:
| 1 | Control value | Input | Char(10) |
Optional Parameter:
| 2 | Error code | I/O | Char(*) |
Default Public Authority: *EXCLUDE
Threadsafe: No
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.
Authorities and Locks
None.
Required Parameter
- Control value
- INPUT; CHAR(10)
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.
Optional Parameter
- Error code
- I/O; CHAR(*)
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.
Error Messages
| 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. |
API introduced: V2R3