 |
» |
|
|
|
The remove_dlc_trace command removes DLC line tracing that was previously
specified using add_dlc_trace. This command 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. Supplied Parameters | |
Parameter name Type Length Default
[remove_dlc_trace]
resource_type constant ALL_DLC_TRACES
resource_name character 8 (null string)
sidh hex byte 0
sidl hex byte 0
odai constant NO
message_type constant TRACE_ALL
|
Supplied parameters are: - resource_type
The resource type of the trace entry to remove or modify.
Possible values are: - ALL_DLC_TRACES
Remove all DLC tracing options, so that no resources are
traced. If this option is specified, the remaining parameters on
this command (resource_name through message_type) are reserved. - ALL_RESOURCES
Remove or modify the tracing options used for tracing all
DLCs, ports, and link stations; resources for which DLC_TRACE entries
are explicitly defined will continue to be traced. - DLC
Remove or modify tracing for the DLC named in resource_name and for all ports and link stations that use this DLC. - PORT
Remove or modify tracing for the port named in resource_name and for all link stations that use this port. - LS
Remove or modify tracing for the LS named in resource_name. - PORT_DEFINED_LS
Modify tracing for the port named in resource_name and its defined link stations. - PORT_IMPLICIT_LS
Modify tracing for the port named in resource_name and its implicit link stations.
- resource_name
The name of the DLC, port, for which tracing is
to be removed or modified. If you specify this parameter, resource_type must not be set to either ALL_DLC_TRACES or ALL_RESOURCES.
The following three parameters identify the Local Form Session Identifier
for a session on the specified LS. This LFSID is valid only if resource_type is set to LS and indicates
that only messages on this session are to be removed. The LFSID
consists of the following parameters: - sidh
The session ID high byte used in identifying the
LFSID for a session on an LS. - sidl
The session ID low byte used in identifying the
LFSID for a session on an LS. - odai
The Origin Destination Assignor Indicator used in identifying
the LFSID for a session on an LS. Possible values are: - YES
The BIND sender is the node containing the secondary link
station. - NO
The BIND sender is the node containing the primary link
station.
- message_type
The type of messages to be traced for the specified resource
or session. To trace all messages, set this parameter to TRACE_ALL.
To trace a specific message, set this parameter to one or more of
the following values (combined using a + character): - TRACE_XID
XID messages - TRACE_SC
Session control RUs - TRACE_DFC
Data flow control RUs - TRACE_FMD
Function management data (FMD) messages - TRACE_NLP
Network layer protocol - TRACE_NC
Network connection - TRACE_SEGS
Non-BBIU segments that do not contain an RH - TRACE_CTL
Messages other then MUs and XIDs
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: - INVALID_RESOURCE_TYPE
The value specified in the resource_type parameter was not valid. - INVALID_MESSAGE_TYPE
The value specified in the message_type parameter was not valid. - INVALID_DLC_NAME
The DLC named in resource_name does not have any tracing options set. - INVALID_PORT_NAME
The port named in resource_name does not have any tracing options set. - INVALID_LS_NAME
The LS named in resource_name does not have any tracing options set. - INVALID_LFSID_SPECIFIED
The LS named in resource_name does not have any tracing options set for the specified
LFSID. - INVALID_FILTER_TYPE
The message_type parameter specified a message type that is not currently
being traced for the specified resource. - ALL_RESOURCES_NOT_DEFINED
The resource_type parameter was set to ALL_RESOURCES,
but a DLC_TRACE entry has not been defined for tracing options on
all resources.
|
Printable version
