|
|
|
|
This verb removes DLC line tracing that was previously specified using ADD_DLC_TRACE. It can be used to remove all tracing on a resource that is currently being traced, to remove the tracing of certain messages from a resource currently being traced, or to remove all DLC line tracing.
typedef struct remove_dlc_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 */
DLC_TRACE_FILTER filter; /* resource to stop tracing */
} REMOVE_DLC_TRACE;
typedef struct dlc_trace_filter
{
unsigned char resource_type; /* type of resource */
unsigned char resource_name[8]; /* name of resource */
SNA_LFSID lfsid; /* session identifier */
unsigned char message_type; /* type of messages */
} DLC_TRACE_FILTER;
typedef struct sna_lfsid
{
union
{
AP_UINT16 session_id;
struct
{
unsigned char sidh;
unsigned char sidl;
} s;
} uu;
AP_UINT16 odai;
} SNA_LFSID;
The application supplies the following parameters:
The resource type of the trace entry to remove or modify. Possible values are:
Remove all DLC tracing options, so that no resources are traced. If this option is specified, the remaining parameters on this verb (resource_name through message_type) are reserved.
Remove or modify the tracing options used for tracing all DLCs, ports, and LSs; resources for which DLC_TRACE entries are explicitly defined will continue to be traced.
Remove or modify tracing for the DLC named in resource_name , and for all ports and LSs that use this DLC.
Remove or modify tracing for the port named in resource_name , and for all LSs that use this port.
Remove or modify tracing for the LS named in resource_name .
Remove or modify tracing for the RTP (rapid transport protocol) connection named in resource_name.
Modify tracing for the port named in resource_name and its defined LSs.
Modify tracing for the port named in resource_name and its implicit LSs.
The name of the DLC, port, LS, or
RTP connection for which tracing is being removed or modified. This parameter
is reserved if resource_type is set to
The Local Form Session Identifier for a session on the specified LS.
This is only valid for resource_type
Session ID high byte.
Session ID low byte.
Origin Destination Assignor Indicator.
The type of messages to trace for the specified resource or session.
Set this parameter to
XID messages
Session Control RUs
Data Flow Control RUs
FMD messages
Non-BBIU segments that do not contain an RH
Messages other then MUs and XIDs
(this message type is currently not used)
(this message type is currently not used)
For tracing on an RTP connection, the values
If the verb executes successfully, SNAP-IX returns the following parameters:
AP_OK
Not used.
If the verb does not execute because of a parameter error, SNAP-IX returns one of the following.
AP_PARAMETER_CHECK
Possible values are:
The resource_type parameter specified a value that was not valid.
The message_type parameter specified a value that was not valid.
The DLC named in resource_name does not have any tracing options set.
The Port named in resource_name does not have any tracing options set.
The LS named in resource_name does not have any tracing options set.
The RTP connection named in the resource_name parameter does not have any tracing options set.
The LS named in resource_name does not have any tracing options set for the specified LFSID.
The message_type parameter specified a message type that is not currently being traced for the specified resource.
The resource_type parameter was set to
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.
|
|
|
 |
|