QUERY TRACE

Read syntax diagramSkip visual syntax diagram Query TRace ACTiveALLnameRETurnsSETS

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

  1. 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:
  1. The parenthesized word ACTIVE appears in the NAME setname ... header line for the set that is currently active.
  2. 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.

    Start of changeIt 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. End of change

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}