z/VM: CP Commands and Utilities Reference - z/VM - IBM

Usage Notes
Responses
Examples
1. The SET CPTRACE command determines which events are recorded. QUERY
CPTRACE lets you know what tracing events have been set on or off.
To check for only NONSPECIFIC categories, enter query cptrace.
To check for only SPECIFIC categories, enter query cptrace for specific.
2. You can use the QUERY CPTRACE response to recreate the CPTRACE setting
at some later point. For each response line, in the order displayed, the indicated
code or category is set to ON if ENABLED or ENABLED EXCEPT, and is set to
OFF if DISABLED or DISABLED EXCEPT. In some cases (see Example 4) the
CPTRACE setting can be recreated by entering the following:
set cptrace for nonspecific off allcodes
set cptrace for nonspecific on svc
set cptrace for nonspecific off 0200
set cptrace for nonspecific off 3600
set cptrace for nonspecific on realios
set cptrace for nonspecific off ssch
Response 1:
The QUERY CPTRACE response shows an indented hierarchy of trace categories
describing, as concisely as possible, the current CPTRACE setting. The output
takes the form:
FOR qualifier
category ENABLED/DISABLED EXCEPT
subcategory DISABLED/ENABLED EXCEPT
subcategory ENABLED/DISABLED
subcategory DISABLED/ENABLED
Response 2:
For categories not specifically traced, the output is:
FOR qualifier NO SPECIFIC TRACE SET
Response 3:
For a query on the SPECIFIC qualifier, when no specific tracing is in effect, the
output is NO SPECIFIC TRACE SET. This response is repeated for each qualifier for
which the trace setting is to be displayed. In the following examples, no specific
tracing is assumed unless otherwise indicated.
Note: For further information on trace categories, see “SET CPTRACE” on page
1216.
Example 1:
If all TRACE entries were enabled through the command SET CPTRACE ON (or all
TRACE entires were disabled through the command SET CPTRACE OFF), you
receive the following response:
FOR NONSPECIFIC
ALLCODES ENABLED or (DISABLED)
Example 2:
QUERY CPTRACE
Chapter 2. CP Commands 747