|
|
|
|
This verb returns information about the current tracing options for data sent between computers on the SNAP-IX LAN. For more information about tracing options, see the SNAP-IX Administration Guide.
This verb may be issued to a running node, or to a Solaris client computer on which the SNAP-IX software is running. To obtain a target handle for the client in order to issue this verb, use the CONNECT_NODE verb without specifying a node name; the NOF application must be running on the client.
On Windows clients, client-server tracing is controlled by options in the Windows Program Registry. For more information, see the SNAP-IX Administration Guide.
typedef struct query_cs_trace
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char dest_sys[64]; /* node to which messages are traced */
unsigned char reserv4[4]; /* reserved */
AP_UINT16 trace_flags; /* trace flags */
AP_UINT16 trace_direction; /* direction (send/rcv/both) to trace */
unsigned char reserv3[8]; /* Reserved */
} QUERY_CS_TRACE;
The application supplies the following parameters:
The server name for which tracing options are being queried. This is an ASCII string, padded on the right with spaces if the name is shorter than 64 characters.
To query tracing options on messages flowing between the computer to which this verb is issued (identified by the target_handle parameter on the NOF API call) and one other server on the LAN, specify the name of the other server here.
To query the default tracing options (set by a SET_CS_TRACE verb with no destination system name specified), set this parameter to 64 ASCII space characters.
If the verb executes successfully, SNAP-IX returns the following parameters:
AP_OK
Not used.
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 of all types is active, this is one of the following values:
No tracing.
Tracing of all types.
If tracing is being used on specific interfaces, this parameter is set to one or more values from the list below, combined using a logical OR operation.
Internal messages relating to client-server topology
Datagram messages
Data messages
Specifies the direction or directions in which tracing is active. This parameter is not used if trace_flags is set to AP_NO_TRACE. Possible values are:
Messages flowing from the target computer to the computer defined by dest_sys are traced.
Messages flowing from the computer defined by dest_sys to the target computer are traced.
Messages flowing in both directions are traced.
If the verb does not execute because of a parameter error, SNAP-IX returns the following parameters:
AP_PARAMETER_CHECK
Possible values are:
The server specified by the dest_sys parameter did not exist or was not started.
The server specified by the dest_sys parameter is the same as the target node to which this verb was issued.
The verb was issued on a standalone server. This verb can only be issued on a client-server system.
Common Return Codes lists further secondary return codes associated with AP_PARAMETER_CHECK, which are common to all NOF verbs.
Common Return Codes lists further combinations of primary and secondary return codes that are common to all NOF verbs.
|
|
|
 |
|