QUERY TRACE
Authorization
Privilege Class: G
Purpose
Use QUERY TRACE to display the TRACE settings.
Operands
- ACTive
- identifies the default option and displays attributes of all traps within the active trace set. This is the default.
- ALL
- displays attributes of all traps within all trace sets.
- name
- displays attributes of all traps within the trace set specified by the 1- to 8-character name.
- RETurns
- displays TRACE CALL return path. No trap attributes are displayed.
- SETS
- displays all trace set names. No trap attributes are displayed.
Usage Notes
- QUERY PER is accepted as a synonym for QUERY TRACE.
Responses
Response 1:
TRACE COUNT IS nnnnnnnn
precedes the
display of trace traps if TRACE COUNT is active.Response 2:
The following response is to QUERY TRACE SETS.
SETS: name1, name2,…
- name1…
- identifies trace set names.
Response 3:
The following response is to QUERY TRACE RETURNS.
RETURNS: name1, name2,…
- name1…
- identifies trace sets in the trace return path.
Response 4:
No trace sets defined
is the response for any form of the
QUERY TRACE command if no trace sets have been defined.Response 5:
No trace calls active
is the response for QUERY TRACE RETURNS
if no trace calls are active; therefore, there are no return paths.Response 6:
The following responses are to QUERY TRACE ALL, QUERY TRACE ACTIVE, and QUERY TRACE name.
The current status of all defined trace sets, of trace traps within the active trace set, or of a
specifically identified trace set, is displayed by QUERY TRACE. Each trace trap has a specific
format as shown below where ident is the trace trap identifier for each trap within the trace
set. A common header exists for these responses.
NAME setname (ACTIVE+[NO]TXSUSPEND)
(ACTIVE+SUSPEND+[NO]TXSUSPEND)
([NO]TXSUSPEND)
Notes:
- The parenthesized word ACTIVE appears in the
NAME setname ...
header line for the set that is currently active. - TXSUSPEND indicates that traps in this trace set will be suspended while the virtual CPU is in
transactional-execution mode.
For more information, see
TRACE TXSUSPEND/NOTXSUSPEND.
It is model-dependent whether transactional-execution mode is entered. For more information, see z/VM support for the IBM z17 family in the z/VM: Migration Guide.
Trace entries can be displayed as STO raddr ASN xxx
or as ASCE
raddr
; the STO or ASCE information may be on a line by itself, depending on the length of
the FROM and INTO information.
Query Trace Examples:
1 BRANCH FROM 0000000000000000-1111111111111111
INTO 0000022222222222-0000555555555555
TERM NOPRINT NORUN SIM
SKIP 00000 PASS 00000 STOP 00000 STEP 00000
CMD NONE
2 BRANCH FROM 0000000000000000-1111111111111111
STO 00000000 ASN 0000
INTO 0000022222222222-0000555555555555
STO 00000000 ASN 0000
TERM NOPRINT NORUN SIM
SKIP 00000 PASS 00000 STOP 00000 STEP 00000
CMD NONE
3 BRANCH FROM 00000000-00000011 STO 00000000 ASN 0000
INTO 00000222-00005555 STO 00000000 ASN 0000
TERM NOPRINT NORUN SIM
SKIP 00000 PASS 00000 STOP 00000 STEP 00000
CMD NONE
4 STORE FROM 00000000-00000011 STO 00000000 ASN 0000
INTO 0000000000000222-0000055555555555
STO 00000000 ASN 0000
TERM NOPRINT NORUN SIM
SKIP 00000 PASS 00000 STOP 00000 STEP 00000
CMD NONE
Access Register Alteration Trap Format
ident AREG FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
DATA range
REG(S) n1 n2… MASK hexstring
{TERM } {PRINT } {RUN } {SIM } [DAT ] [SUPER]
{NOTERM} {NOPRINT} {NORUN} [NODAT] [PROB ]
SKIP n PASS n STOP n STEP n
CMD…CP command…
Instruction Trap Format
ident INSTR PSWA hexloc[-hexloc] {[STO sto [ASN xxxx]]}
{[ASCE radddr] }
{TERM } {PRINT } {RUN } {SIM } [DAT ] [SUPER]
{NOTERM} {NOPRINT} {NORUN} [NODAT] [PROB ]
SKIP n PASS n STOP n STEP n
CMD…CP command…
Note: hexloc (-hexloc) is the
“range” specified on the trace instruction.
Store Trap Format
ident STORE FROM hexloc[-hexloc] {[STO sto [ASN xxxx]]}
{[ASCE radddr] }
INTO hexloc[-hexloc] {[STO sto [ASNxxxx]]}
{[ASCE radddr] }
[ASIT asit] [SPACE owner:space_name]
[DATA hexstring]
[MASK hexstring]
{TERM } {PRINT } {RUN } {SIM } [DAT ] [SUPER]
{NOTERM} {NOPRINT} {NORUN} [NODAT] [PROB ]
SKIP n PASS n STOP n STEP n
CMD…CP command…
Branch Trap Format
ident BRANCH FROM hexloc[-hexloc] {[STO sto [ASN xxxx]]}
{[ASCE radddr] }
INTO hexloc[-hexloc] {[STO sto [ASNxxxx]]}
{[ASCE radddr] }
{TERM } {PRINT } {RUN } {SIM } [DAT ] [SUPER]
{NOTERM} {NOPRINT} {NORUN} [NODAT] [PROB ]
SKIP n PASS n STOP n STEP n
CMD…CP command…
General Register Alteration Trap Format
ident GREG FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
DATA range
REG(S) n1 n2… MASK hexstring
{TERM } {PRINT } {RUN } {SIM } [DAT ] [SUPER]
{NOTERM} {NOPRINT} {NORUN} [NODAT] [PROB ]
SKIP n PASS n STOP n STEP n
CMD…CP command…
I/O Trap Format
ident typename FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
HEX n[-m]
{TERM }{PRINT }{RUN }{SIM } [DAT ] [SUPER] [INST] [CCW]
{NOTERM}{NOPRINT}{NORUN}{NOSIM} [NODAT] [PROB] [INT ] [IODATA n]
SKIP n PASS n STOP n STEP n
CMD…CP command…
Mnemonic Trap Format
ident typename FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
{TERM } {PRINT } {RUN } {SIM } [DAT ] [SUPER]
{NOTERM} {NOPRINT} {NORUN}{NOSIM} [NODAT] [PROB ]
SKIP n PASS n STOP n STEP n
CMD…CP command…
TRACE MCH Format
ident typename FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
{TERM } {PRINT } {RUN } {SIM }
{NOTERM} {NOPRINT} {NORUN}
SKIP n PASS n STOP n STEP n
CMD…CP command
External/Program
ident typename FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
HEX n[-m]
{EXT }
{PROG}
{TERM } {PRINT } {RUN } {SIM }
{NOTERM} {NOPRINT} {NORUN}
SKIP n PASS n STOP n STEP n
CMD…CP command
Monitor Call/DIAGNOSE/SVC
ident typename FROM hexloc[-hexloc] {[STO raddr [ASN xxxx]]}
{[ASCE radddr] }
HEX n[-m]
{MC }
{DIAG}
{SVC }
{TERM } {PRINT } {RUN } {SIM }
{NOTERM} {NOPRINT} {NORUN} {NOSIM}
SKIP n PASS n STOP n STEP n
CMD…CP command
For additional response information, see TRACE: Command Responses.
Messages
- HCP002E Invalid operand - operand
- HCP003E Invalid option - {option|command contains extra option(s) starting with option}