QUERY TRACECTL
Authorization
General User
Purpose
Use the QUERY TRACECTL command to display a list of the events enabled for CMS internal tracing, as well as a wrapsize to show how many trace events are retained in storage. This command is useful for problem diagnosis in the CMS multitasking environment.
Responses
TRACECTL WRAPSIZE -1 COMM ON DISP ON PROC ON LANG ON SYNC ON MISC ON
or
TRACECTL WRAPSIZE 0 COMM OFF DISP OFF PROC OFF LANG OFF SYNC OFF MISC OFF
or
a combination of the above:
TRACECTL WRAPSIZE 20 COMM ON DISP OFF PROC OFF LANG ON SYNC ON MISC OFF
Where:
- COMM ON or OFF
- indicates Communication event tracing is on or off.
- DISP ON or OFF
- indicates Dispatch event tracing is on or off.
- PROC ON or OFF
- indicates Process Management event tracing is on or off.
- LANG ON or OFF
- indicates Language-specific event tracing is on or off.
- SYNC ON or OFF
- indicates Synchronization event tracing is on or off.
- MISC ON or OFF
- indicates Miscellaneous event tracing is on or off.
- WRAPSIZE n
- indicates how many trace events are retained if no eligible trace event monitor exists at the
time the event is signaled.
- n
- A positive integer value greater than 0. When the wrapsize is exceeded, the oldest trace event is discarded to make room for the newest arrival.
- 0
- No trace events are being retained.
- -1
- Trace events continue to be retained until virtual storage is exhausted.
Options
For more information on the Options, Usage Notes, and Error Messages that apply to all operands of the QUERY command, see QUERY.
Usage Notes
Use the the TRACECTL command to change the settings of the CMS internal trace events and the wrapsize. For more information, see TRACECTL.