QUERY TRSOURCE
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
- 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.
- The class G user may not specify any parameters. The response to the class G user is that of the QUERY TRSOURCE USER * command.
- 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:
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.Traceid (TRACE ID) not enabled; incomplete definition
Responses for Undefined Traces
No traces are defined
is the response for QUERY TRSOURCE ALL
if no traces are defined.Traceid traceid is not defined
is
the response for QUERY TRSOURCE ID trace ID if the specified trace ID is not defined.Traceset traceset is not defined
is
the response for QUERY TRSOURCE SET traceset if no traces are defined for
the specified trace set.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.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.
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. 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.
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.
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.
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.
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.
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.