The set_cs_trace command specifies 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; for more information, refer to HP-UX
SNAplus2 Diagnostics Guide.
Supplied Parameters |
 |
Parameter name Type Length Default
[set_cs_trace]
dest_sys character 64 (null string)
trace_flags constant NONE
trace_direction constant CS_BOTH
|
Supplied parameters are:
- dest_sys
The server name for which tracing is required. This name
is a string of locally displayable characters.
To manage tracing 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 node on the LAN, specify the name
of the other node; tracing on messages flowing to and from other
computers on the LAN will be unchanged. You can issue two set_cs_trace commands to activate tracing between the same target
computer and two different destination servers.
To manage tracing 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 all other nodes on the LAN, do not specify
this parameter. The options you specify on this command override
any previous settings for tracing to specific computers (identified
by dest_sys on the previous set_cs_trace commands).
- trace_flags
The types of tracing required. For more information about
these trace types, refer to HP-UX SNAplus2 Diagnostics
Guide.
To set tracing for all types use one of the following values:
- NONE
Do not activate tracing for any type of message.
- ALL
Activate tracing for all types of messages.
To activate tracing on specific message types, select one or
more of the following values (combined using a + character):
- CS_ADMIN_MSG
Trace internal messages relating to client-server topology
- CS_DATAGRAM
Trace datagram messages
- CS_DATA
Trace data messages
- trace_direction
Specifies the direction or directions in which tracing
is required. This parameter is ignored if trace_flags is set to NONE. Possible values
are:
- CS_SEND
Trace messages flowing from the target computer
to the computer defined by dest_sys.
- CS_RECEIVE
Trace messages flowing from the computer defined
by dest_sys to the target computer.
- CS_BOTH
Trace messages flowing in both directions.
Returned Parameters |
|
No parameters are returned by SNAplus2 when this command executes successfully.
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.
- INVALID_TRC_DIRECTION
The trace_direction parameter was not set to a valid value.
Printable version
