The query_cs_trace command returns information about the current tracing
options for data sent between computers on the SNAplus2 LAN. For
more information about tracing options, refer to HP-UX
SNAplus2 Diagnostics Guide.
This command may be issued to a running node or to a HP-UX
client computer on which the SNAplus2 software is running. To issue
the command to a client computer, use the snapadmin program on the client computer without specifying a node
name.
On Windows clients, client-server tracing is controlled by
options in the sna.ini file (Win16 clients) or the Windows Program Registry
(Win32 clients). For more information, refer to HP-UX
SNAplus2 Diagnostics Guide.
Supplied Parameters |
 |
Parameter name Type Length Default
[query_cs_trace]
dest_sys character 64 (null string)
|
Supplied parameter is:
- dest_sys
The server name for which tracing options are to
be queried.
To query tracing options on messages flowing between the computer
to which this command is issued (either the local computer or one
identified by the -n option on the snapadmin program) and one other server on the LAN, specify the
name of the other server.
To query the default tracing options (set by a set_cs_trace command with no system name), do not specify this parameter.
Returned Parameters |
|
Parameter name Type
trace_flags constant
trace_direction constant
|
If the command executes successfully, SNAplus2 returns the
following parameters:
- trace_flags
The types of tracing currently active. For more information
about these trace types, see “set_cs_trace”.
If no tracing is active or if tracing is active for all types of
messages, one of the following values is returned:
- NONE
Tracing for all types of messages is active.
- ALL
Tracing for all types of messages is active.
If tracing is active on specific interfaces, one or more of the
following values is returned (combined using a + character):
- CS_ADMIN_MSG
Internal messages relating to client-server topology
are traced.
- CS_DATAGRAM
Datagram messages are traced.
- CS_DATA
Data messages are traced.
- trace_direction
Specifies the direction or directions in which tracing
is active. This parameter is not returned if trace_flags is set to NONE. Possible values
are:
- CS_SEND
Messages flowing from the target computer to the computer
defined by dest_sys are traced.
- CS_RECEIVE
Messages flowing from the computer defined by dest_sys to the target computer are traced.
- CS_BOTH
Messages flowing in both directions are traced.
Error Return Codes |
|
If the command cannot be executed, SNAplus2 returns a primary
return code to indicate the type of error and a secondary return
code to provide specific details about the reason for unsuccessful
execution.
If the command does not execute because of a parameter error,
SNAplus2 returns the following parameters:
- primary_rc
PARAMETER_CHECK
- secondary_rc
Possible values are:
- NAME_NOT_FOUND
The server specified by the dest_sys parameter was not valid or was not started.
- LOCAL_SYSTEM
The server specified by the dest_sys parameter is the same as the target node to which this
command was issued.
Printable version
