QUERY TRSOURCE

Read syntax diagramSkip visual syntax diagram Query TRSOurce ALLIDtraceidSETtracesetTYPEDATAGTIOLANPCINONEUSERuserid*

Authorization

Privilege Class: A, C, E, G

Purpose

Use QUERY TRSOURCE to display the current status of those traces defined using TRSOURCE.

Operands

ALL
requests the status of all defined traces. ALL is the default.
ID traceid
requests the status of the specified trace ID.
SET traceset
requests the status of all defined traces of the specified set.
TYPE DATA
TYPE GT
TYPE IO
TYPE LAN
TYPE PCI
TYPE NONE
requests the status of all traces of the following types:
Type
Meaning
IO
IO
GT
GT
LAN
LAN
PCI
PCI
DATA
DATA
NONE
Unspecified.
USER userid
USER *
requests the status of all traces of type GT that are defined for the specified user's virtual machine. You can use asterisk (*) to specify your own virtual machine.

Usage Notes

  1. A trace of type NONE occurs when a trace has been defined by the TRSOURCE or TRSAVE command, but the TYPE xxx parameter of the TRSOURCE command is not specified.
  2. The class G user may not specify any parameters. The response to the class G user is that of the QUERY TRSOURCE USER * command.
  3. An IO trace may be defined for a nonexistent device—that is, a device that has no RDEVICE definition. If a trace with only such devices is enabled, message HCP477E is issued:
    Traceid (TRACE ID) not enabled;  incomplete definition
    Note, however, that a trace with a nonexistent device and a real device (whether the latter be online or offline) can be enabled, and the response to QUERY TRSOURCE indicates that a trace for the nonexistent device is activated.

Responses for Undefined Traces

Response 1:
No traces are defined
is the response for QUERY TRSOURCE ALL if no traces are defined.
Response 2:
Traceid traceid is not defined
is the response for QUERY TRSOURCE ID trace ID if the specified trace ID is not defined.
Response 3:
Traceset traceset is not defined
is the response for QUERY TRSOURCE SET traceset if no traces are defined for the specified trace set.
Response 4:
No GT traces are defined for user userid
is the response for QUERY TRSOURCE USER userid if no GT traces are defined for the specified user's virtual machine.
Response 5:
No trace was defined for type type
is the response for QUERY TRSOURCE TYPE type if no traces are defined for the specified trace type.

Responses for Defined Traces

The format of the responses depends upon the trace types. The grouping of the responses for QUERY TRSOURCE ALL is by trace set.

Response 1:
SET setid
is the response that heads each group of traces included in a set, setid being the set name of the set. When no set name has been defined, the set name is NULL.
Response 2:
  ID     TYPE   SET     STATUS      DEVICES   USER   IODATA
traceid   IO  setname {ENABLED }   rdev(s)   userid   nnnn
                      {DISABLED}
or
  ID     TYPE   SET     STATUS      LDEVS     USER   IODATA
traceid   IO  setname {ENABLED }   ldev(s)   userid   nnnn
                      {DISABLED}
is displayed for traces of type IO.
ID
identifies the name of the trace, as specified on the ID xxx parameter of the TRSOURCE…TYPE IO… command.
TYPE
identifies the type of trace.
SET
is the name used to group traces into a logically related set as specified on SET xxx parameter of the TRSOURCE ID traceid command or NULL.
STATUS ENABLED
STATUS DISABLED
ENABLED indicates that the defined trace is active. DISABLED indicates that the trace is inactive.
DEVICES
rdev(s) indicates the device number (rdev1) or ranges (rdev1-rdev2) of device numbers whose I/O activity should be traced. It is the value specified on the DEVICE xxx parameter of the TRSOURCE ID traceid command.
LDEVS
ldev(s) indicates the logical device number (ldev1) or ranges (ldev1-ldev2) of logical device numbers whose I/O activity should be traced. It is the value specified on the LDEV xxx parameter of the TRSOURCE ID traceid command.
USER
indicates which user's I/O should be traced. It is specified on the USER xxx parameter of the TRSOURCE ID traceid command. ALL indicates that all I/O to the specified devices are traced for all users.
IODATA
indicates how many bytes of the transferred data are being traced for the defined I/O trace.
Response 3:
  ID     TYPE   SET     STATUS    ORIGINID   INCLUDED
traceid  GT-x setname {ENABLED } {sysname}   {userida}
                      {DISABLED} {userida}   {useridb}
                                 {useridb}
 
  ID     TYPE   SET     STATUS    ORIGINID  EXCLUDED
traceid  GT-x setname {ENABLED } {sysname}  {useridx}
                      {DISABLED} {userida}  {useridy}
                                 {useridb}
 
  ID     TYPE   SET     STATUS    ORIGINID
traceid  GT-x setname {ENABLED }  userid
                      {DISABLED}
is displayed for traces of type GT.
ID
identifies the name of the trace, as specified on the ID xxx parameter of the TRSOURCE…TYPE GT… command.
TYPE GT-x
indicates the type of the trace; x stands for E or B.

E indicates that the guests being traced are sending trace data to CP in EVENT mode—that is, the virtual machine sends one trace entry at a time.

B indicates that the guests being traced are sending trace data to CP in BLOCK mode—that is, the guest virtual machine is collecting the trace entries into buffers and then requesting CP to receive the entire block of trace data at a time.

SET
is the name used to group traces into a logically related set as specified on the SET xxx parameter of the TRSOURCE ID traceid command or NULL.
STATUS ENABLED
STATUS DISABLED
ENABLED indicates that the defined trace is active. DISABLED indicates that the trace is inactive.
ORIGINID
identifies a virtual machine group if TRSOURCE…FOR VMGROUP sysname was entered to define the GT traceid. When tracing is active for a virtual machine group, the user IDs of the group members for which tracing is active are displayed as shown. When TYPE GT tracing is being done for a single virtual machine (the command TRSOURCE…FOR USER userid was entered), originid is the name of the virtual machine.
INCLUDED
displays a list of the virtual machines that are included in the virtual machine group trace. These virtual machines may or may not be logged on.

ALL indicates that every virtual machine that connects to the virtual machine group is included in the group trace.

NONE indicates that no virtual machines are included in the group trace.

EXCLUDED
displays a list of the virtual machines that are excluded from the virtual machine group trace. These virtual machines may or may not be logged on.
Note: Either an included list or an excluded list is displayed for a virtual machine group.
Response 4:
  ID     TYPE   SET     STATUS         LOC         INSTRUCTION
traceid  DATA setname  {ENABLED }  {   nnnnnn   }  string…
                       {DISABLED}  {modname+disp}
 
DATALINKS
DATALINK 001  …
DATALINK 002  …
              IF … THEN
               IF … THEN
DATALINK 004    …
               ELSE
DATALINK 005    …
DATALINK 006    …
               ENDIF
              ENDIF
⋮
DATALINK XXX  …

- or -

DATALINKS
NO DATALINKS DEFINED
is displayed for traces of type DATA.
ID
identifies the trace, as specified on the ID xxx parameter of the TRSOURCE…TYPE DATA… command.
TYPE
indicates the type of trace.
SET
is the name used to group traces into a logically related set as specified on SET xxx parameter of the TRSOURCE ID traceid command or NULL.
STATUS ENABLED
STATUS DISABLED
ENABLED indicates that the defined trace is active. DISABLED indicates that the trace is inactive.
LOC nnnnnn
LOC modname+disp
indicates the host address of the instruction that, when executed, triggers tracing information.

The operand modname+disp indicates the module name and displacement of the instruction that, when executed, triggers tracing information.

INSTRUCTION
identifies the instruction string located at the indicated location.
DATALINKS
defines the information collected when the trace springs. If no data links were specified for this trace ID, NO DATALINKS DEFINED is displayed under the DATALINKS header line.
IF
determines whether a subsequent THEN statement or ELSE statement is executed.
THEN
indicates that subsequent datalinks and IF statements are executed only if the preceding IF statement is true.
ELSE
indicates that subsequent datalinks and IF statements are executed only if the preceding IF statement is false.
ENDIF
closes the last unclosed IF statement.
Response 5:
  ID     TYPE   SET     STATUS
traceid  NONE setname   DISABLED
is displayed for traces of unspecified type, or type NONE.
ID
identifies the name of the trace, as specified on the ID xxx parameter of the TRSOURCE command.
TYPE
indicates that the TYPE xxx parameter was not specified on the TRSOURCE ID traceid command.
SET
is the name used to group traces into a logically related set as specified on SET xxx parameter of the TRSOURCE ID traceid command.
STATUS DISABLED
indicates the trace is inactive.
Response 6:
ID       TYPE     SET      STATUS   OWNER    NAME     LENGTH OPTIONS      
traceid  LAN      setname {ENABLED} owner    lanname  bytes {TRUNK         }
                          {DISABLED}                        {DROPPED       }
                                                            {NIC owner vdev}
                                                            {NONE          }
         VLANID                                                         
        {vlanid(4)}                                                     
-       {ALL      }
is displayed for traces of type LAN.
ID
identifies the trace, as specified on the ID xxx parameter of the TRSOURCE…TYPE LAN… command.
TYPE
indicates the type of trace.
SET
is the name used to group traces into a logically related set as specified on SET xxx parameter of the TRSOURCE ID traceid command or NULL.
STATUS ENABLED
STATUS DISABLED
ENABLED indicates that the defined trace is active. DISABLED indicates that the trace is inactive.
OWNER owner
the userid that owns the specified guest LAN or virtual switch.
NAME lanname
the name of the specified guest LAN or virtual switch.
LENGTH bytes
the number of bytes of traffic to be collected.
OPTIONS
TRUNK
only traffic flowing over the virtual switch OSA connection will be captured. If TRUNK is specified on a guest LAN, no traffic is collected.
DROPPED
only traffic that has been DROPPED due to an error or an unknown destination will be collected.
NIC owner vdev
only traffic for the specified guest machine (identified by owner and vdev) will be collected.
NONE
no options were specified; therefore, all traffic on the specified guest LAN or virtual switch will be captured.
VLANID
vlanid
only traffic destined for one of the vlan ids specified will be captured. Up to four vlan ids can be specified.
ALL
all traffic regardless of vlan id will be collected.
Response 7:
ID       TYPE     SET      STATUS      PCIF      USER     
traceid  PCI      setname {ENABLED}    pcif(s)   userid
                          {DISABLED}       
is displayed for traces of type PCI.
ID
identifies the name of the trace, as specified on the ID xxx parameter of the TRSOURCE...TYPE PCI... command.
TYPE
indicates the type of trace.
SET
is the name used to group traces into a logically related set as specified on SET xxx parameter of the TRSOURCE ID traceid command or NULL.
STATUS ENABLED
STATUS DISABLED
ENABLED indicates that the defined trace is active. DISABLED indicates that the trace is inactive.
PCIF
pcif(s) indicates the PCI function (pcif) or ranges (pcif1-pcif2) of PCI functions whose activity should be traced. It is the value specified on the PCIFUNCTION xxx parameter of the TRSOURCE ID traceid.
USER
indicates which user's PCI function should be traced. It is specified on the USER xxx parameter of the TRSOURCE ID traceid command. ALL indicates that activity to the specified PCI functions are traced for all users.

Messages

  • HCP002E Invalid operand - operand
  • HCP020E Userid missing or invalid
  • HCP026E Operand missing or invalid
  • HCP6163E Internal error during command processing: module + offset
  • HCP6525E Authorization request failed.