DLSw+ Commands

Syntax Description

circuit-id

Circuit ID for a specific remote circuit. The valid range is 0 to 4294967295.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.2 F	This command was introduced.

Usage Guidelines

A user can specify a circuit ID of a specific circuit to clear rather than clearing all circuits.

Caution This command also drops the associated LLC2 session. The command usage should be used with caution and under the advice of a Cisco engineer.

Examples

The following example closes all DLSw+ circuits:

clear dlsw circuit

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.2 F	This command was introduced.

Usage Guidelines

This command does not affect existing sessions.

Examples

The following example removes all entries from the DLSw+ reachability cache:

clear dlsw reachability

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.2 F	This command was introduced.

Examples

The following example resets to zero the number of frames in the local, remote, and group cache:

clear dlsw statistics

Syntax Description

This command has no arguments or keywords.

Defaults

Single-route explorer

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Examples

The following example specifies all-route broadcasts for NetBIOS:

dlsw allroute-netbios

Syntax Description

This command has no arguments or keywords.

Defaults

Single-route explorer

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Examples

The following example specifies all-route broadcasts for SNA:

dlsw allroute-sna

Syntax Description

list-number	The ring list number. This number is subsequently used in the dlsw remote-peer command to define the segment to which the bridge-group should be applied. The valid range is 1 to 255.
bgroups number	The transparent bridge group list number. The valid range is 1 to 63.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Traffic received from a remote peer is forwarded only to the bridge group specified in the bridge group list. Traffic received from a local interface is forwarded to peers if the input bridge group number appears in the bridge group list applied to the remote peer definition. The definition of a bridge group list is optional. Each remote peer has a single list number associated with it; therefore, if you want traffic to go to a bridge group and to either a ring list or port list, you should specify the same list number in each definition.

Examples

The following example configures bridge-group list 1:

dlsw bgroup-list 1 bgroups 33

Related Commands

Command	Description
dlsw bridge-group	Links DLSw+ to the bridge group of the Ethernet LANs.
dlsw ring-list	Configures a ring list, mapping traffic on a local interface to remote peers.

Syntax Description

group-number	Transparent bridge group to which DLSw+ will be attached. The valid range is 1 to 63.
llc2	(Optional) LLC2 interface subcommands.
N2 number	(Optional) Number of times router should retry various operations. The valid range is 1 to 255.
ack-delay-time milliseconds	(Optional) Maximum time the router allows incoming I-frames to stay unacknowledged. The valid range is 1 to 60000.
ack-max number	(Optional) Maximim number of I-frames received before an acknowledgment must be sent. The valid range is 1 to 255.
idle-time milliseconds	(Optional) Frequency of polls during periods of idle traffic. The valid range is 1 to 60000.
local-window number	(Optional) Maximum number of I-frames to send before waiting for an acknowledgment. The valid range is 1 to 127.
t1-time milliseconds	(Optional) Amount of time router waits for an acknowledgment to transmitted I-frames. The valid range is 1 to 60000.
tbusy-time milliseconds	(Optional) Amount of time router waits while the other LLC2 station is in a busy state before attempting to poll the remote station. The valid range is 1 to 60000.
tpf-time milliseconds	(Optional) Amount of time router waits for a final response to a poll frame before re-sending the original poll frame. The valid range is 1 to 60000.
trej-time milliseconds	(Optional) Amount of time router waits for a resend of a rejected frame before sending the reject command. The valid range is 1 to 60000.
txq-max number	(Optional) Queue for holding LLC2 information frames. The valid range is 20 to 200.
xid-neg-val-time milliseconds]	(Optional) Frequency of exchange of identification (XID). The valid range is 1 to 60000.
xid-retry-time milliseconds	(Optional) Amount of time router waits for reply to XID. The valid range is 1 to 60000.
locaddr-priority lu address priority list number	(Optional) Assigns an input SNA LU Addr priority list to this bridge group. The valid range is 1 to 10.
sap-priority priority list number	(Optional) Assigns an input sap priority list to this bridge group. The valid range is 1 to 10.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines s

More than one bridge group can be attached to DLSw+ by using this command multiple times. Multiple bridge group support is available in Cisco IOS Release 11.3.

Examples

The following example links DLSw+ to bridge groups 1, 2, and 3:

dlsw local-peer peer-id 1.1.1.1
dlsw remote-peer 0 tcp 2.2.2.2
dlsw bridge-group 1
dlsw bridge-group 2
dlsw bridge-group 3
 
interface Ethernet0
 bridge-group 1
 
interface Ethernet1
 bridge-group 2
 
interface Ethernet2
 bridge-group 3
 
bridge 1 protocol ieee
bridge 2 protocol ieee
bridge 3 protocol ieee

Related Commands

Command	Description
dlsw bgroup-list	Maps traffic on the local Ethernet bridge group interface to remote peers.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.3	This command was introduced.

Examples

The following example helps maintain a smaller name cache:

dlsw cache-ignore-netbios-datagram

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following example reenables DLSw+:

no dlsw disable

Syntax Description

load-balance

(Optional) Specifies that sessions are load-balanced across duplicate paths.

Defaults

Fault-tolerance is the default logic used to handle duplicate paths.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

A path is either a remote peer or a local port.

In full-tolerance mode, the preferred path is always used unless it is unavailable. The preferred path is either the path over which the first response to an explorer was received, or, in the case of remote peers, the peer with the least cost.

Examples

The following example specifies load balancing to resolve duplicate paths:

dlsw duplicate-path-bias load-balance

Syntax Description

This command has no arguments or keywords.

Defaults

Border peer caching is enabled.

Command Modes

Global configuration

Command History

Release	Modification
11.2 F	This command was introduced.

Usage Guidelines

If a border peer becomes a nonborder peer, then the group cache is automatically deleted.

This command prevents a border peer from learning reachability information from relay responses. This command also prevents a border peer from using local or remote caches to make forwarding decisions.

Examples

The following example disables the group cache:

dlsw group-cache disable

Related Commands

Command	Description
dlsw group-cache max-entries	Limits the number of entries in the group cache.

Syntax Description

number

Maximum number of entries allowed in the group cache. The valid range is 0 through 12000. If the value is set to 0, then there is no limit to the number of entries. The default is 2000.

Defaults

The default setting is 2000.

Command Modes

Global configuration

Command History

Release	Modification
11.2 F	This command was introduced.

Usage Guidelines

Once the number of entries has reached the maximum number specified, if a new entry needs to be added an entry will be removed to make room.

The value set for number applies to both the NetBIOS and SNA group cache.

Examples

The following configuration defines the maximum number of entries allowed in the NetBIOS or SNA group cache as 1800:

dlsw group-cache max-entries 1800

Related Commands

Command	Description
dlsw group-cache disable	Disables the border peer caching feature.

Syntax Description

sap. . .

One or more SAPs.

Defaults

No lists are configured.

Command Modes

Global configuration

Command History

Release	Modification
10.3	This command was introduced.

Usage Guidelines

The dlsw icannotreach saps command causes the local router to send a control vector to its peers during the capabilities exchange, which tells the peers not to send canureach messages to the local router for sessions using those DSAPs. (They are DSAPs from the peer's perspective, and SSAPs from the perspective of the devices attached to the local router.) The effect is that devices attached to the peer will not be able to initiate sessions to devices attached to the local router using the listed DSAPs. Devices attached to the local router, however, will still be able to start sessions with devices on its peers using the listed saps as SSAPs. The reason is that the local router can still send canureach requests to its peers, since no filtering is actually done on the local router. The filtering done by the peers does not prohibit the peers from responding to canureach requests from the local router sending the control vector, only sending canureach requests to the local router.

Examples

The following example specifies that NetBIOS traffic will be denied:

dlsw icannotreach saps F0

Syntax Description

mac-exclusive	Router can reach only the MAC addresses that are user configured.
netbios-exclusive	Router can reach only the NetBIOS names that are user configured.
remote	(Optional) Gives the NetBIOS workstations (that are local to the router and that are not already defined in the dlsw icanreach netbios-name name statement) access to remote servers.
mac-address mac-addr	Configures a MAC address that this router can locally reach.
mask mask	(Optional) MAC address mask in hexadecimal h.h.h. The "f" value represents the "don't care" bit and the "0" value represents the "care" bit. The mask indicates which bits in the MAC address are relevant.
netbios-name name	Configures a NetBIOS name that this router can locally reach. Wildcards (*) are allowed at the end of the name. Trailing white spaces are ignored when comparing against an actual name in a NetBIOS frame.
saps	(Optional) Array of SAPs.

Defaults

No resources are configured.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command can be entered at any time. It causes a capabilities exchange to relay the information to all active peers. By specifying resource names or MAC addresses in this command, you can avoid broadcasts from remote peers that are looking for this resource. By specifying "exclusive" you can avoid broadcasts to this router or any resources. For example, you could configure the front-end processor (FEP) MAC address or corporate site LAN servers in central site routers to avoid any broadcasts over the WAN for these resources.

Configuring the remote keword allows roving workstations to access remote servers. With the remote keyword specified, all local NetBIOS stations will be able to make outgoing connections regardless of whether their own NetBIOS name is configured in the icanreach netbios-name list. Incoming connections will be limited to those with a destination name that is specified in the list.

In the default case (where the remote keyword is not specified), a local NetBIOS station that is not configured in the icanreach netbios-name list will not be able to make a connection in this router over DLSw+, whether incoming or outgoing.

Note   Because the configuration of the mac-address and netbios-name keywords prevents the DLSw+ peer from exploring, a misconfiguration could prevent DLSw+ from being able to find a resource actually available elsewhere in the network.

Examples

The following example indicates that this peer only has information about a single NetBIOS server, and that no peers should send this peer explorers searching for other NetBIOS names. Because the remote option is also configured, NetBIOS workstations that are connected to the NetBIOS server "lanserv" will be able to establish a DLSw+ connection:

dlsw icanreach netbios-exclusive
dlsw icanreach netbios-name lanserv

Related Commands

Command	Description
show dlsw capabilities	Displays the configuration of a specific peer or all peers.

Syntax Description

This command has no arguments or keywords.

Defaults

The command is disabled by default.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command is used when any device does not handle the LLC2 RNR frames.

Examples

The following example keeps the receiver not ready message from being sent when establishing an LLC2 connection.

dlsw llc2 nornr
 

The following is output from a Sniffer trace showing when it would be appropriate to use the dlsw llc2 nornr command because the RNR message is being rejected from the FEP when the router is trying to establish an LLC2 connection:

SUMMARY  Delta T    From 400020401003                From 400023491026
8    0.173                                    LLC C D=00 S=04 TEST P
9    0.003   LLC R D=04 S=00 TEST F
10    0.002                                    SNA XID Fmt 2 T4 
11    0.059   SNA XID Fmt 2 T4 
12    0.004                                    SNA XID Fmt 2 T4 
13    0.065   SNA XID Fmt 2 T4
14    0.005                                    SNA XID Fmt 2 T4 
16    0.054   LLC C D=04 S=04 SABME P
17    0.003                                    LLC R D=04 S=04 UA 
 

The router sends a receiver not ready message:

18    0.001   LLC C D=04 S=04 RNR NR=0  
 

From frames 19 to 35, the FEP does not respond:

19    0.002   LLC C D=04 S=04 RR NR=0  
20    0.048   SNA  C NC  NC-ER-OP 
21    0.997   LLC C D=04 S=04 RR NR=0 P
22    1.000   LLC C D=04 S=04 RR NR=0 P
24    1.000   LLC C D=04 S=04 RR NR=0 P
25    1.000   LLC C D=04 S=04 RR NR=0 P
31    1.000   LLC C D=04 S=04 RR NR=0 P
32    1.000   LLC C D=04 S=04 RR NR=0 P
34    1.000   LLC C D=04 S=04 RR NR=0 P
35    1.000   LLC C D=04 S=04 RR NR=0 P
 

The router disconnects the circuit:

37    1.000   LLC C D=04 S=04 DISC P
38    0.002                                    LLC R D=04 S=04 UA F
 

The sequence repeats:

39    0.179                                    LLC C D=00 S=04 TEST P
41    0.767   SNA XID Fmt 2 T4 
42    0.634   SNA XID Fmt 2 T4 
43    0.173                                    LLC C D=00 S=04 TEST 
44    0.003   LLC R D=04 S=00 TEST F
45    0.002                                    SNA XID Fmt 2 T4 
46    0.060   SNA XID Fmt 2 T4 
47    0.004                                    SNA XID Fmt 2 T4
48    0.063   SNA XID Fmt 2 T4 
49    0.005                                    SNA XID Fmt 2 T4 

Syntax Description

cluster cluster-id	(Optional) Implements the DLSw+ Peer Clusters feature and defines the router as part of a particular cluster. The valid range is 1 to 255.
peer-id ip-address	(Optional) Local peer IP address. This address is required when Fast-Sequenced Transport (FST) or TCP is used.
group group	(Optional) Peer group number for this router. The valid range is 1 to 255.
border	(Optional) Enables the router as a border peer. The group option must be specified to use the border peer option.
cost cost	(Optional) Peer cost advertised to remote peers in the capabilities exchange. The valid range is 1 to 5.
lf size	(Optional) Largest frame size for this local peer. Valid maximum frame sizes are as follows: 516-516 bytes 1470-1470 bytes 1500-1500 bytes 2052-2052 bytes 4472-4472 bytes 8144-8144 bytes 11407-11407 bytes 11454-11454 bytes 17800-17800 bytes
keepalive seconds	(Optional) Default remote peer keepalive interval in seconds. The valid range is 0 to 1200 seconds. The default is 30 seconds. The value 0 means no keepalives.
passive	(Optional) Specifies that this router does not initiate remote peer connections to configured peers.
promiscuous	(Optional) Accept connections from nonconfigured remote peers.
biu-segment	(Optional) DLSw+ spoofs the maximum receivable I-frame size in XID so that each end station sends its largest frame.
init-pacing-window size	(Optional) Size of the initial pacing window as defined in RFC 1795. The valid range is 1 to 2000.
max-pacing-window size	(Optional) Maximum size of the pacing window as defined in RFC 1795. The valid range is 1 to 2000.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
10.3	This command was introduced.
12.0(3)T	The cluster keyword was added.

Usage Guidelines

When there are multiple peers to a given destination, use the cost keyword to determine which router is preferred and which is capable. The cost keyword only applies in fault tolerance mode.

The biu-segment option is a performance/utilization improvement. If a frame that arrives from a remote peer is too large for the destination station to handle, DLSw+ segments the frame. If you choose to implement this option, you must add the option to both DLSw peer partners.

Examples

The following command defines the local peer IP address and specifies the peer group number for this router:

dlsw local-peer peer-id 10.2.17.1 group 2

Related Commands

Command	Description
dlsw duplicate-path-bias	Specifies how DLSw+ handles duplicate paths to the same MAC address or NetBIOS name.
show dlsw capabilities	Displays the configuration of a specific peer or all peers.

Syntax Description

mac-addr	Specifies the MAC address.
ring ring-number	Maps the MAC address to a ring number or ring group number. The valid range is 1 to 4095.
remote-peer	Maps the MAC address to a specific remote peer.
interface serial number	Specifies the remote peer by direct serial interface.
ip-address ip-address	Specifies the remote peer by IP address.
rif rif-string	Maps the MAC address to a local interface using a RIF string. The RIF string describes a source-routed path from the router to the MAC address. It starts at the router's ring-group and ends on the ring where the MAC address is located. The direction should be from the router toward the MAC address. See IEEE 802.5 standard for details.
group group	Maps the MAC address to a specified peer group. Valid numbers are in the range 1 to 255.

Defaults

No static MAC address is configured.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

You can statically define resources to prevent the Cisco IOS software from sending explorer frames for the specified resource. For example, you can include the MAC address of a FEP in the configuration for each remote router to eliminate any broadcasts that are searching for a FEP. Alternately, you can specify a single dlsw icanreach statement in the router attached to the FEP indicating the MAC address of the FEP. This information is sent to all remote routers as part of the capabilities exchange.

Note   Because the configuration of this command prevents the DLSw+ peer from exploring, a misconfiguration could prevent DLSw+ from being able to find a resource actually available elsewhere in the network.

Examples

The following example maps the static MAC address 1000.5A12.3456 to the remote peer at IP address 10.17.3.2:

dlsw mac-addr 1000.5A12.3456 remote-peer ip-address 10.17.3.2

Related Commands

Command	Description
show dlsw reachability	Displays DLSw+ reachability information.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
11.2 F	This command was introduced.

Usage Guidelines

See the "Cisco IOS Bridging and IBM Networking Overview" chapter of the Cisco IOS Bridging and IBM Networking Configuration Guide for more details on the NetBIOS DDR feature.

Examples

The following example enables NetBIOS DDR:

dlsw netbios-keepalive-filter

Syntax Description

netbios-name	Specifies the NetBIOS name. Wildcards are allowed.
ring ring number	Maps the NetBIOS name to a ring number or ring group number. Test frames for this name will only be sent to LAN ports in this ring group.
remote-peer	Maps the NetBIOS name to a specific remote peer.
interface serial number	Specifies the remote peer by direct interface.
ip-address ip-address	Specifies the remote peer by IP address.
rif rif- string	Maps the MAC address to a local interface using a RIF string. The RIF string describes a source-routed path from the router to the MAC address. It starts at the router's ring-group and ends on the ring where the MAC address is located. The direction should be from the router towards the MAC address. See the IEEE 802.5 standard for details.
group group	Maps the NetBIOS name to a specified peer group. Valid numbers are in the range 1 to 255.

Defaults

No static NetBIOS name is configured.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Note   Because the configuration of this command prevents the DLSw+ peer from exploring, a misconfiguration could prevent DLSw+ from being able to find a resource actually available elsewhere in the network.

Examples

The following example configures a static NetBIOS name and links it to group 3:

dlsw netbios-name netname group 3

Related Commands

Command	Description
show dlsw reachability	Displays DLSw+ reachability information.

Syntax Description

fst	(Optional) Use FST encapsulation for all peers-on-demand established by this router.
bytes-netbios-out bytes-list-name	(Optional) Configures NetBIOS bytes output filtering for peer-on-demand peers. The bytes-list-name is the name of the previously defined NetBIOS bytes access list filter.
cost cost	(Optional) Specifies the cost to reach peer-on-demand peer. The valid range is 1 to 5. The default cost is 3.
dest-mac destination-mac- address	(Optional) Specifies the exclusive destination MAC address for peer-on-demand peers.
dmac-output-list access- list-number	(Optional) Specifies the filter output destination MAC addresses.
host-netbios-out host-list-name	(Optional) Configures NetBIOS host output filtering for peer-on-demand peers. The host-list-name is the name of the previously defined NetBIOS host access list filter.
inactivity minutes	(Optional) Configures the length of time after the peer's circuit count is 0 that the peer-on-demand is disconnected. The valid range is 0 to1440 seconds. The default is 600 seconds.
keepalive seconds	(Optional) Configures the peer-on-demand keepalive interval. The valid range is 0 to 1200 seconds. The default is 30 seconds.
lf size	(Optional) Largest frame size for this remote peer. Valid maximum frame sizes are the following: 516-516 bytes 1470-1470 bytes 1500-1500 bytes 2052-2052 bytes 4472-4472 bytes 8144-8144 bytes 11407-11407 bytes 11454-11454 bytes 17800-17800 bytes
lsap-output-list list	(Optional) Configures local service access point (LSAP) output filtering for peer-on-demand peers. Valid numbers are in the range 200 to 299.
port-list port-list-number	(Optional) Configures a port list for peer-on-demand peers. Valid numbers are in the range 0 to 4095.
priority	(Optional) Configures prioritization for peer-on-demand peers. The default state is off.
rsvp global	(Optional) Sets the RSVP parameters to the global values specified in the dlsw rsvp command.
rsvp average-bit-rate	(Optional) Average bit rate kilobits per second to reserve up to 75 percent of total bits on the interface. The valid range is 0 to 4,294,967.
rsvp maximum-burst	(Optional) Maximum burst size (kilobytes of data in queue). The valid range is 0 to 4,294,967.
tcp-queue-max	(Optional) Configures the maximum output TCP queue size for peer-on-demand peers.

Defaults

The default peer-on-demand transport is TCP. The default cost is 3. The default inactivity is 600 seconds. The default keepalive is 30 seconds.The default priority state is off.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.
12.0(3)T	The rsvp keyword was added.

Usage Guidelines

A peer-on-demand peer is a non-configured remote-peer that was connected because of an LLC2 session established through a border peer DLSw+ network.

Setting the average-bit-rate and maximum burst values to 0 disables the RSVP bandwidth reservation for the peer connections.

Examples

The following example configures FST for peer-on-demand transport:

dlsw peer-on-demand-defaults fst

Related Commands

Command	Description
show dlsw peers	Displays DLSw peer information.

Syntax Description

list-number	Port list number. The valid range is 1 to 255.
type	Interface type.
number	Interface number.

Defaults

No port list is configured.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Traffic received from a remote peer is forwarded only to the ports specified in the port list. Traffic received from a local interface is forwarded to peers if the input port number appears in the port list applied to the remote peer definition. The definition of a port list is optional.

Examples

The following example configures a DLSw peer port list for Token Ring interface 1:

dlsw port-list 3 token ring 1

Related Commands

Command	Description
dlsw bgroup-list	Maps traffic on the local Ethernet bridge group interface to remote peers.
dlsw ring-list	Configures a ring list, mapping traffic on a local interface to remote peers.

Syntax Description

fst	(Optional) Use FST encapsulation for all promiscuous peers established by this router.
bytes-netbios-out bytes-list-name	(Optional) Configures NetBIOS bytes output filtering for promiscuous peers. The bytes-list-name is the name of the previously defined NetBIOS bytes access list filter.
cost cost	(Optional) Specifies the cost to reach promiscuous peers. The valid range is 1 to 5. The default cost is 3.
dest-mac destination-mac-address	(Optional) Specifies the exclusive destination MAC address for promiscuous peers.
dmac-output-list access-list-number	(Optional) Specifies the filter output destination MAC addresses.
host-netbios-out host-list-name	(Optional) Configures NetBIOS host output filtering for promiscuous peers. The host-list-name is the name of the previously defined NetBIOS host access list filter.
keepalive seconds	(Optional) Configures the promiscuous keepalive interval. The valid range is 0 to 1200 seconds. The default is 30 seconds.
lf size	(Optional) Largest frame size for this promiscuous peer. Valid maximum frame sizes are the following: 516-516 bytes 1470-1470 bytes 1500-1500 bytes 2052-2052 bytes 4472-4472 bytes 8144-8144 bytes 11407-11407 bytes 11454-11454 bytes 17800-17800 bytes
lsap-output-list list	(Optional) Configures LSAP output filtering for promiscuous peers. Valid numbers are 200 to 299.
rsvp global	(Optional) Sets the RSVP parameters to the global values.
rsvp learn	(Optional) Configures RSVP parameters (average-bit-rate and maximum burst rate) to be those of the remote peer to which the promiscuous peer is connecting.
average-bit-rate	(Optional) Configures RSVP parameters for this peer connection, which are different from the global values. Average bit rate (kilobits per second) to reserve up to 75 percent of the total bits on the interface. The valid range is 0 to 4,294,967.
maximum-burst	(Optional) Maximum burst size (kilobytes of data in queue). The valid range is 0 to 4,294,967.
tcp-queue-max size	(Optional) Configures the maximum output TCP queue size for promiscuous peers.

Defaults

The default prom-peer transport is TCP.

The default cost is 3.

The default keepalive value is 30 seconds.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.
12.0(3)T	The rsvp keyword was added.

Usage Guidelines -

A prom-peer is a peer not configured as a remote-peer on this DLSw+ device, but which initiated a peer connection which was accepted because promiscuous peering was enabled.

Setting the average-bit-rate and maximum burst values to 0 disables the RSVP bandwidth reservation for non-configured remote peers.

Examples

The following example configures cost for promiscuous peers:

dlsw prom-peer-defaults cost 4

Related Commands

Command	Description
show dlsw capabilities	Displays the configuration of a specific peer or all peers.

Syntax Description

ring	(Optional) Virtual ring number. Up to 10 redundant rings can be configured

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.3 T	This command was introduced.

Examples

The following example configures router milan so that the redundant virtual ring 300 should drop any explorer that is sourced from ring number 300. Similarly, router madrid knows that 300 is a redundant ring and any explorer sourced from ring 300 should be dropped.

milan#dlsw redundant-rings 300
madrid#dlsw redundant-rings 300

Syntax Description

list-number	Ring list number. The valid range is 1 to 255. The default is 0, which means DLSw+ forwards explorers over all ports or bridge groups on which DLSw+ is enabled.
interface serial number	Serial interface number of the remote peer with which the router is to communicate.
dlci-number	DLCI number of the remote peer.
backup-peer ip-address	(Optional) IP address of the existing TCP/FST peer for which this peer is the backup peer.
backup-peer frame-relay interface serial number dlci-number	(Optional) Serial interface and DLCI number of the existing Direct/LLC2 Frame-Relay peer for which this peer is the backup peer.
backup-peer interface name	(Optional) Interface name of the existing direct peer for which this peer is the backup peer.
bytes-netbios-out bytes-list-name	(Optional) Configures NetBIOS bytes output filtering for this peer. The bytes-list-name argument is the name of the previously defined NetBIOS bytes access list filter.
circuit weight weight	(Optional) Configures circuit-weight for this remote peer.
cost cost	(Optional) Cost to reach this remote peer. The valid range is 1 to 5.
dest-mac mac-address	(Optional) Permits the connection to be established only when there is an explorer frame destined for the specified 48-bit MAC address written in dotted triplet form.
dmac-output-list access-list-number	(Optional) Establishes the connection only when the explorer frame passes the specified access list. The access-list-number is the list number specified in the access-list command.
host-netbios-out host-list-name	(Optional) Configures NetBIOS host output filtering for this peer. The host-list-name is the name of the previously defined NetBIOS host access list filter.
keepalive seconds	(Optional) Sets the keepalive interval for this remote peer. The range is 0 to 1200 seconds.
lf size	(Optional) Largest frame size, in bytes, this local peer will use on a circuit to avoid segmented frames. Valid sizes are 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454, and 17800 bytes.
linger minutes	(Optional) Configures length of time the backup peer remains connected after the primary peer connection is reestablished. The valid range is 1 to 300 minutes. The default is 5 minutes.
lsap-output-list list	(Optional) Filters output IEEE 802.5 encapsulated packets. Valid access list numbers are in the range 200 to 299.
passive	(Optional) Designates this remote peer as passive.
pass-thru	(Optional) Selects pass-thru mode. The default is local acknowledgement mode.

Defaults

No remote peers are specified.

The linger default is 5 minutes.

The pass-thru default is local acknowledgement mode.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.
11.2	The following keywords and arguments were added: cost cost dest-mac mac-address dmac-output-list access-list-number linger minutes pass-thru
12.0(3)T	The keyword circuit weight was added.

Usage Guidelines

The following keywords and arguments first appeared in Cisco IOS Release 11.2: The cost keyword specified in a remote peer statement takes precedence over the cost learned as part of the capabilities exchange with the remote peer. The cost keyword is relevant only in fault tolerance mode.

When you need to permit access to only a single MAC address, the dest-mac option is a shortcut over the dmac-output-list option.

When pass-thru is not specified, traffic will be locally acknowledged and reliably transported in LLC2 across the WAN.

Examples

The following example specifies a DLSw+ Lite peer as a backup to a primary direct peer:

dlsw remote-peer 0 frame-relay interface serial 1 40 pass-thru
dlsw remote-peer 0 frame-relay interface serial 0 30 backup-peer frame-relay interface serial 1 40
 

The following example specifies Frame Relay encapsulation connection for remote peer transport:

dlsw remote-peer 0 frame-relay interface 0 30

Related Commands

Command	Description
show dlsw peers	Displays DLSw peer information.

Syntax Description

list-number	Ring list number. The valid range is 1 to 255. The default is 0, which means DLSw+ forwards explorers over all ports or bridge groups on which DLSw+ is enabled.
ip-address	IP address of the remote peer with which the router is to communicate.
backup-peer ip-address	(Optional) IP address of the existing TCP/FST peer for which this peer is the backup peer.
backup-peer frame-relay-interface serial number dlci-number	(Optional) Serial interface and DLCI number of the existing Direct/LLC2 Frame Relay peer for which this peer is the backup peer.
backup-peer interface name	(Optional) Interface name of the existing direct peer for which this peer is the backup peer.
bytes-netbios-out bytes-list-name	(Optional) Configures NetBIOS bytes output filtering for this peer. The bytes-list-name argument is the name of the previously defined NetBIOS bytes access list filter.
cost cost	(Optional) Cost to reach this remote peer. The valid range is 1 to 5.
dest-mac mac-address	(Optional) Permits the connection to be established only when there is an explorer frame destined for the specified 48-bit MAC address written in dotted triplet form.
dmac-output-list access-list-number	(Optional) Permits the connection to be established only when the explorer frame passes the specified access list. The access-list-number is the list number specified in the access-list command.
host-netbios-out host-list-name	(Optional) Configures NetBIOS host output filtering for this peer. The host-list-name is the name of the previously defined NetBIOS host access list filter.
keepalive seconds	(Optional) Sets the keepalive interval for this remote peer. The range is 0 to 1200 seconds.
lf size	(Optional) Largest frame size this local peer will use on a circuit to avoid segmented frames. Valid sizes are 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454, and 17800 bytes.
linger minutes	(Optional) Configures length of time the backup peer remains connected after the primary peer connection is reestablished. The valid range is 1 to 300 minutes. The default is 5 minutes.
lsap-output-list list	(Optional) Filters output IEEE 802.5 encapsulated packets. Valid access list numbers are in the range 200 to 299.
passive	(Optional) Designates this remote peer as passive.

Defaults

No FST encapsulation connection is specified.

The linger default is 5 minutes.

Command Modes

Global configuration

Command History

Release	Modification
10.3	This command was introduced.
11.2	The following keywords and arguments were added: dest-mac mac-address dmac-output-list access-list-number linger minutes

Usage Guidelines

The cost keyword specified in a remote peer statement takes precedence over the cost learned as part of the capabilities exchange with the remote peer. The cost keyword is relevant only in fault tolerance mode.

When you need to permit access to a single MAC address, the dest-mac option is a shortcut over the dmac-output-list option.

Examples

The following example specifies an FST peer as backup to a primary TCP peer:

dlsw remote-peer 0 tcp 10.2.18.1
dlsw remote-peer 1 fst 10.2.17.8 backup-peer 10.2.18.1
 

The following example specifies an FST encapsulation connection for remote peer transport:

dlsw remote-peer 1 fst 10.2.17.8

Related Commands

Command	Description
show dlsw peers	Displays DLSw peer information.

Syntax Description

list-number	Ring list number. The valid range is 1 to 255. The default is 0, which means all.
serial number	Specifies the remote peer by direct serial interface.
backup-peer ip-address	(Optional) IP address of the existing TCP/FST peer for which this peer is the backup peer.
backup-peer frame-relay interface serial number dlci-number	(Optional) Serial interface and DLCI number of the existing Direct /LLC2 frame-relay peer for which this peer is the backup peer.
backup-peer interface name	(Optional) Interface name of the existing direct peer for which this peer is the backup peer.
bytes-netbios-out bytes-list-name	(Optional) Configures NetBIOS bytes output filtering for this peer. The bytes-list-name argument is the name of the previously defined NetBIOS bytes access list filter.
cost cost	(Optional) Cost to reach this remote peer. The valid range is 1 to 5.
dest-mac mac-address	(Optional) Permits the connection to be established only when there is an explorer frame destined for the specified 48-bit MAC address written in dotted triplet form.
dmac-output-list access-list-number	(Optional) Permits the connection to be established only when the explorer frame passes the specified access list. The access-list-number is the list number specified in the access-list command.
host-netbios-out host-list-name	(Optional) Configures NetBIOS host output filtering for this peer. The host-list-name is the name of the previously defined NetBIOS host access list filter.
keepalive seconds	(Optional) Sets the keepalive interval for this remote peer. The range is 0 to 1200 seconds.
lf size	(Optional) Largest frame size, in bytes, this local peer will use on a circuit to avoid segmented frames. Valid sizes are 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454, and 17800 bytes.
linger minutes	(Optional) Configures length of time the backup peer remains connected after the primary peer connection is reestablished. The valid range is 1 to 300 minutes. The default is 5 minutes.
lsap-output-list list	(Optional) Filters output IEEE 802.5 encapsulated packets. Valid access list numbers are in the range 200 to 299.
passive	(Optional) Designates this remote peer as passive.
pass-thru	(Optional) Selects passthrough mode. The default is local acknowledgment mode.

Defaults

No point-to-point direct encapsulation connection is specified.

The linger default is 5 minutes.

The pass-thru default is local acknowledgment mode.

Command Modes

Global configuration

Command History

Release	Modification
10.3	This command was introduced.
11.2	The following keywords and arguments were added: dest-mac mac-address dmac-output-list access-list-number linger minutes

Usage Guidelines

The cost keyword specified in a remote peer statement takes precedence over the cost learned as part of the capabilities exchange with the remote peer. The cost keyword is relevant only in fault tolerance mode.

When you need to permit access to a single MAC address only, the dest-mac option is a shortcut over the dmac-output-list option.

Examples

The following example specifies a point-to-point direct peer backup to a primary direct peer:

dlsw remote-peer 0 interface serial 1 pass-thru
dlsw remote-peer 1 interface serial 2 pass-thru backup-peer interface serial 1
 

The following example specifies a point-to-point direct encapsulation connection for remote peer transport:

dlsw remote-peer 1 interface serial 2 pass-thru

Related Commands

Command	Description
show dlsw peers	Displays DLSw peer information.

Syntax Description

list-number	Remote peer ring group list number. This ring group list number default is 0. Otherwise, this value must match the number you specify with the dlsw ring-list, dlsw port-list, or dlsw bgroup-list command.
ip-address	IP address of the remote peer with which the router is to communicate.
backup-peer ip-address	(Optional) IP address of the existing TCP/FST peer for which this peer is the backup peer.
backup-peer frame-relay interface serial number dlci-number	(Optional) Serial interface and DLCI number of the existing Direct/LLC2 Frame Relay peer for which this peer is the backup peer.
backup-peer interface name	(Optional) Interface name of the existing direct peer for which this peer is the backup peer.
bytes-netbios-out bytes-list-name	(Optional) Configures NetBIOS bytes output filtering for this peer. The bytes-list-name argument is the name of the previously defined NetBIOS bytes access list filter.
cluster cluster-id	(Optional) Used to indicate to a border peer that a particular remote-peer should be treated as part of a specific peer cluster. The valid Range is 1 to 255.
circuit-weight value	(Optional) Configures the target state that DLSw+ tries to maintain. The valid range is 1 to 100.
cost cost	(Optional) Cost to reach this remote peer. The valid range is 1 to 5.
dest-mac mac-address	(Optional) Establishes the TCP connection only when there is an explorer frame destined for the specified 48-bit MAC address written in dotted triplet form.
dmac-output-list access-list-number	(Optional) Establishes the TCP connection only when the explorer frame passes the specified access list. The access-list-number is the list number specified in an access-list command.
dynamic	(Optional) Establishes the TCP connection only when there is DLSw+ data to send.
host-netbios-out host-list-name	(Optional) Configures NetBIOS host output filtering for this peer. The host-list-name is the name of the previously defined NetBIOS host access list filter.
inactivity minutes	(Optional) Configures the length of time a connection is idle before closing the dynamic remote peer connection. The valid range is 1 to 300 minutes. The default is 5 minutes.
keepalive seconds	Sets the keepalive interval for this remote peer. The range is 0 to 1200 seconds.
lf size	(Optional) Largest frame size, in bytes, this local peer uses on a circuit to avoid segmented frames. Valid sizes are 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454, and 17800 bytes.
linger minutes	(Optional) Configures length of time the backup peer remains connected after the primary peer connection is reestablished. The valid range is 1 to 300 minutes. The default is 5 minutes.
lsap-output-list list	(Optional) Filters output IEEE 802.5 encapsulated packets. Valid access list numbers are in the range 200 to 299.
no-llc minutes	(Optional) Configures the length of time a remote peer remains connected after all LLC2 connections are gone. The valid range is 1 to 300 minutes. The default is 5 minutes.
passive	(Optional) Designates this remote peer as passive.
priority	(Optional) Enables prioritization features for this remote peer. Valid TCP port numbers are the following: High—2065 Medium—1981 Normal—1982 Low—1983
rif-passthru virtual-ring-number	(Optional) Configures the remote peer as RIF-Passthru. The virtual-ring-number value is the same number as the ring number value assigned in the source-bridge ring-group commands of the DLSw+ Passthru peers.
rsvp global	(Optional) Configures the RSVP parameters for this specific peer back to the global values.
rsvp average-bit-rate	(Optional) Configures RSVP parameters for this peer, which are different from the global values. Average bit rate (kilobits per second) reserves up to 75 percent of the total bits on the interface. Range is 0 to 4,294,967.
rsvp maximum burst	(Optional) Maximum burst size (kilobytes of data in queue). Range is 0 to 4,294,967.
tcp-queue-max size	(Optional) Maximum output TCP queue size for this remote peer. The valid maximum TCP queue size is a number in the range 10 to 2000.
timeout seconds	(Optional) Retransmit time limit for TCP. The valid range is 5 to 1200 seconds. The default is 90 seconds.

Defaults

No peer IP address is identified.

The linger option is inactive. If the linger option is added with no minutes specified, the default is 5 minutes.

The dynamic option is not on by default. If the dynamic option is added without either the inactivity or no-llc argument specified, the default is to terminate the TCP connection to the remote peer after 5 minutes of no active LLC2 connection.

The inactivity default is 5 minutes.

The no-llc default is 5 minutes.

The timeout default is 90 seconds.

Command Modes

Global configuration

Command History

Release	Modification
10.3	This command was introduced.
11.1	The following keywords and arguments were added: dynamic inactivity minutes linger minutes no-llc minutes timeout seconds
11.2	The following keywords and arguments were added: dest-mac mac-address dmac-output-list access-list-number linger minutes
12.0(3)T	These keywords were added: circuit-weight value rsvp maximum burst

Usage Guidelines

SNA DDR technology allows switched links to be closed during idle periods. To enable this feature, set the keepalive option to 0 and configure the timeout option. When the dynamic option is configured, the keepalive option is automatically set to 0.

To enhance DDR cost-savings, you can configure the TCP connection to a remote peer to be dynamically established (that is, established only when there is DLSw data to send). You can further configure the TCP connection to terminate after a specified period of idle time on the peer or after a specified period of no active LLC sessions on the peer.

You cannot use both no-llc and inactivity in a command specifying a dynamic peer.

When you need to permit access to a single MAC address, the dest-mac option is a shortcut over the dmac-output-list option.

Use the linger option to specify that a backup peer will remain connected for a specified period of time after the primary connection is reestablished.

When the priority option on the dlsw remote-peer command is configured, DLSw+ automatically activates four TCP ports to that remote peer (ports 2065, 1981, 1982 and 1983) and assigns traffic to specific ports. Furthermore, if APPN is running with DLSw+ and you specify the priority option on the dlsw remote-peer command, then the SNA TOS will map APPN class of service (COS) to TCP TOS and will preserve the APPN COS characteristics throughout the network.

The rif passthru option works only on Token Ring LANs via SRB. Other LAN types, such as SDLC and QLLC, are not supported. The RIF Passthru feature is supported with TCP encapsulation and it disables local acknowledgment.

The following features are not supported with the DLSw+ RIF Passthru feature:

• Border peers

• Peer-on-demand peers

• Dynamic peers

• Backup peers

The cluster keyword is available only on border peers.This option enables the DLSw+ Peer Clusters feature without forcing every DLSw+ router in the network to upgrade their software.

Setting the average-bit-rate or maximum burst to 0 turns off RSVP for this peer.

Examples

The following example specifies a TCP encapsulation connection for remote peer transport:

dlsw remote-peer 0 tcp 10.2.17.8
 

The following example specifies a TCP peer as backup to a primary FST peer:

dlsw remote-peer 0 fst 10.2.18.9
dlsw remote-peer 0 tcp 10.2.17.8 backup-peer 10.2.18.9

Related Commands

Command	Description
show dlsw peers	Displays DLSw peer information.

Syntax Description

list-number	Ring list number. The valid range is 1 to 255.
rings	Specify one or more physical or virtual rings.
ring-number	Physical or virtual ring number. The valid range is 1 to 4095.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Traffic received from a remote peer is forwarded only to the rings specified in the ring list. Traffic received from a local interface is forwarded to peers if the input ring number appears in the ring list applied to the remote peer definition. The definition of a ring list is optional.

Examples

The following example configures a DLSw ring list, assigning rings 1, 2, and 3 to ring list 3:

dlsw ring-list 3 rings 1 2 3

Related Commands

Command	Description
dlsw port-list	Maps traffic on a local interface (Token Ring or serial) to remote peers.
dlsw remote-peer frame-relay	Specifies the remote peer with which the router will connect.
show dlsw capabilities	Displays the configuration of a specific peer or all peers.

Syntax Description

default	Sets the average bit rate to 10 Kbps and the maximum burst rate to 28 KBps.
average-bit-rate	(Optional) Average bit rate (kilobits per second) to reserve up to 75 percent of the total bits on the interface. The valid range is 1 to 4,294,967.
maximum-burst	(Optional) Maximum burst size (kilobytes of data in queue). The valid range is 1 to 4294967.

Defaults

The default values for the average-bit-rate and maximum-burst are 10 Kbps and 28 KBps, respectively.

Command Modes

Global configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

The DLSw+ RSVP Bandwidth Reservation feature does not require that all peers in a network have RSVP configured. However, the feature does require that the end peer devices are configured with RSVP and that all devices in the middle are IP RSVP capable.

The default value assumes that the DLSw+ peer is connected via a 56 Kbps link. If this is not the case, then the default values will likely not produce optimal results. Even if the line speed is 56 Kbps, the default values (10 Kbps average-bit-rate and 28 KBps maximum-burst) may not be optimal in a particular network environment and should be changed accordingly.

Setting the average-bit-rate or maximum-burst to 0 turns off RSVP for this peer.

Examples

The following example configures the DLSw+ RSVP Bandwidth Reservation feature with an average-bit-rate of 10 Kbps and a maximum-burst of 28 KBps:

dlsw rsvp default

Related Commands

Command	Description
dlsw peer-on-demand-defaults	Configures defaults for peer-on-demand transport.
dlsw prom-peer-defaults	Configures defaults for promiscuous transport
dlsw remote-peer tcp	Identifies the IP address of a peer with which to exchange traffic using TCP.
show ip rsvp sender	Displays RSVP PATH-related sender information currently in the database.
show ip rsvp request	Displays RSVP-related request information being requested upstream
show ip rsvp reservation	Displays RSVP-related receiver information currently in the database

Syntax Description

icannotreach-block-time	Cache life of unreachable resource; during this time searches for the resource are blocked. The valid range is 1 to 86400 seconds. The default is 0 (disabled).
netbios-cache-timeout	Cache life of NetBIOS name location for the local and remote reachability caches. The valid range is 1 to 86400 seconds. The default is 960 seconds (16 minutes).
netbios-explorer-timeout	Length of time that the Cisco IOS software waits for an explorer response before marking a resource unreachable (on both a LAN and a WAN). The valid range is 1 to 86400 seconds. The default is 6 seconds.
netbios-group-cache	Cache life of NetBIOS entries in the group cache. The valid range is 1 to 86000 seconds. The default is 240 seconds (4 minutes).
netbios-retry-interval	NetBIOS explorer retry interval (on a LAN only). The valid range is 1 to 86400 seconds. The default is 1 second.
netbios-verify-interval	Number of seconds between a cache entry's creation and its marking as stale. If a search request comes in for a stale cache entry, a directed verify query is sent to ensure the cache still exists. The valid range is 1 to 86400 seconds. The default is 240 seconds (4 minutes).
sna-cache-timeout	Length of time that an SNA MAC/service access point (SAP) location cache entry exists before it is discarded (for local and remote caches). The valid range is 1 to 86400 seconds. The default is 960 seconds (16 minutes).
explorer-delay-time	Time to wait before sending or accepting explorers. The valid range is 1 to 5 minutes. The default is 0.
sna-explorer-timeout	Length of time that the Cisco IOS software waits for an explorer response before marking a resource unreachable (on a LAN and WAN). The valid range is 1 to 86400 seconds. The default is 180 seconds (3 minutes).
explorer-wait-time	Time to wait for all stations to respond to explorers. The valid range is 1 to 86400 seconds. The default is 0.
sna-group-cache	Cache life of SNA entries in the group cache. The valid range is 1 to 86000 seconds. The default is 240 seconds (4 minutes).
sna-retry-interval	Interval between SNA explorer retries (on a LAN). The valid range is 1 to 86400 seconds. The default is 30 seconds.
sna-verify-interval	Number of seconds between a cache entry's creation and its marking as stale. If a search request comes in for a stale cache entry, a directed verify query is sent to ensure that the cache still exists. The valid range is 1 to 86400 seconds. The default is 240 seconds (4 minutes).

Defaults

The icannotreach-block-time default is 0 (disabled).

The netbios-cache-timeout default is 960 seconds (16 minutes).

The netbios-explorer-timeout default is 6 seconds.

The netbios-group-cache default is 240 seconds (4 minutes).

The netbios-retry-interval default is 1 second.

The netbios-verify-interval default is 240 seconds (4 minutes).

The sna-cache-timeout default is 960 seconds (16 minutes).

The explorer-delay-time default is 0.

The sna-explorer-timeout default is 180 seconds (3 minutes).

The explorer-wait-time default is 0.

The sna-group-cache default is 240 seconds (4 minutes).

The sna-retry-interval default is 30 seconds.

The sna-verify-interval default is 240 seconds (4 minutes).

Command Modes

Global configuration

Command History

Release	Modification
10.3	This command was introduced.

Usage Guidelines

The netbios-group-cache and sna-group-cache options were added to this command for the border peer caching feature.

Examples

The following configuration defines the length of time that an entry will stay in the group cache as 120 seconds (2 minutes):

dlsw timers sna-group-cache 120
 

The following example configures the length of time that an SNA MAC location cache entry exists before it is discarded:

dlsw timer sna-cache-timeout 3

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
12.0	This command was introduced.

Examples

The following example disables the tos bits in DLSw+ generated packets:

dlsw tos disable

Syntax Description

high value	(Optional) Overrides the default values set for the port labeled "high." The value is the TOS bit value. Valid ranges are 0 to 7.
medium value	(Optional) Overrides the default values set for the port labeled "medium." The value is the TOS bit value. Valid ranges are 0 to 7.
normal value	(Optional) Overrides the default values set for the port labeled "normal." The value is the TOS bit value. Valid ranges are 0 to 7.
low value	(Optional) Overrides the default values set for the port labeled "low." The value is the TOS bit value. Valid ranges are 0 to 7.

Defaults

TOS bit values 6 and 7 are not recommended for usage because of potential interference with critical network infrastructure flows. Although using TOS bit values 0 and 1 will not cause negative impact to the network, the values do not prioritize the traffic.

Examples

The following example changes the default setting on IP packets generated by DLSw+ from high to low:

dlsw tos map low 2
 

The following is an example policy routing configuration that shows how to modify the default setting of TCP port 2065. The configuration changes the default setting on IP packets from network control priority to routine priority.

ip local policy route-map test
access-list 101 permit tcp any eq 2065 any
access-list 101 permit tcp any any eq 2065
route-map test permit 20
 match ip address 101
set ip precedence routine
 

Syntax Description

multicast-mac-address	MAC address to which all DLSw+ devices on a transparent bridged domain advertise their presence by sending the master present frame.
master-priority value	(Optional) Configures the router as a master device. The valid range is 0 to 254. The lower the value, higher the priority. The default value is 100.

Defaults

No default value or behaviors.

The master-priority default is 100.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

The same multicast-mac-address must be configured on all DLSw+ devices within the same transparent bridged domain. All the DLSw+ devices advertise their presence via frames to this multicast-mac-address.

All routers in the transparent bridged domain compete and elect one master router. The master router is elected based on its master-priority value. In the case of equal master priority setting, the router with the lowest MAC address is the elected master router.

Examples

The following example configures Ethernet Redundancy with a master-priority of 100:

dlsw transparent redundancy-enable 9999.9999.9999 master-priority 100

Related Commands

Command	Description
show dlsw transparent neighbor	Displays DLSw neighbors in a transparent bridged domain.
show dlsw transparent cache	Displays the master circuit cache for each transparent bridged domain.

Syntax Description

This command has no arguments or keywords.

Defaults

Switch support is off.

Command Modes

Global configuration

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

The dlsw transparent switch-support command must be configured before the dlsw transparent map command.

Examples

The following example configures Ethernet switch support:

dlsw transparent switch-support

Related Commands

Command	Description
dlsw transparent map	Enables MAC address mapping in a switch-based environment.

Syntax Description

netbios value	(Optional) Timeout value for the NetBIOS session. The valid range is 100 to 900 ms. The default value is 400 ms.
sna value	(Optional) Timeout value for the SNA session. The valid range is 100 to 5000 ms. The default value is 1000 ms (1 second).

Defaults

The default NetBIOS value is 400 ms.

The default SNA value is 1000 ms (1 second).

Command Modes

Interface configuration

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

The dlsw transparent redundancy-enable command must be configured before the dlsw transparent timers command.

Examples

The following example configures the master router to wait 500 ms for a NetBIOS session before giving or denying permission to a router to create a circuit:

dlsw transparent timers netbios 500

Related Commands

Command	Description
dlsw transparent redundancy-enable	Configures transparent redundancy.

Syntax Description

This command has no arguments or keywords.

Defaults

The UDP unicast feature is enabled.

Command Modes

Global configuration

Command History

Release	Modification
11.2 F	This command was introduced.

Usage Guidelines

If the dlsw udp-disable command is configured, then a DLSw+ node will not send packets via UDP Unicast and will not advertise UDP Unicast support in its capabilities exchange message.

Refer to the "Bridging and IBM Networking Overview" chapter of the Bridging and IBM Networking Configuration Guide for more information on the UDP Unicast feature.

Examples

The following example disables the UDP unicast feature:

dlsw udp-disable

Syntax Description

subaddress subaddress	An X.121 subaddress.
pvc	Map one or more permanent virtual circuits (PVCs) to a particular QLLC service (in this case DLSw+). QLLC will attempt to reach the partner by sending and ID.STN.IND to DLSw+.
pvc-low	Lowest logical channel number (LCN) for a range of X.25 PVCs. Acceptable values for PVCs are decimal numbers between 1 and 4095.
pvc-high	(Optional) Highest LCN. If not specified the range of PVCs consists of just one PVC.
vmac vmacaddr	(Optional) Defines either the only virtual MAC address used for DLSw+ or the lowest virtual MAC address in a pool of virtual MAC addresses.
poolsize	(Optional) Specify the number of contiguous virtual MAC addresses that have been reserved for DLSw+. If the parameter is not present, then just one virtual MAC address is available.
partner partner-macaddr	(Optional) Virtual MAC address to which an incoming call wishes to connect. The qllc dlsw command must be repeated for each different partner. Each partner is identified by a unique subaddress.
sap ssap dsap	(Optional) Overrides the default SAP values (04) for a Token Ring connection. dsap refers to the partner's SAP address; ssap applies to the virtual MAC address that corresponds to the X.121 device.
xid xidstring	(Optional) XID format 0 type 2 string.
npsi-poll	(Optional) Inhibits forwarding a null XID on the X.25 link. Instead the Cisco IOS software will send a null XID response back to the device that sent the null XID command.

Defaults

No default behavior or values.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

Any incoming call whose X.121 destination address matches the router's X.121 address and this subaddress will be dispatched to DLSw+ (with an ID.STN IND). If a router is providing several QLLC services different subaddresses must be used to discriminate between them. Subaddresses can be used even if a remote X.25 device is not explicitly mapped to a specific virtual MAC address. This is most useful when PU 2.1 devices are connecting to a host because the X.25 device's control point name and network name are used to validate the connection, rather than some virtual MAC address. The subaddress is optional. If no subaddress is provided, any incoming call that matches the router's X.121 address will be dispatched to DLSw+. On outgoing calls the subaddress is concatenated to the interface's X.121 address.

When DLSw+ receives a Can You Reach inquiry about a virtual MAC address in the pool, the QLLC code will attempt to set up a virtual circuit to the X.121 address that maps to the virtual MAC address specified. If an incoming call is received, QLLC sends an ID.STN.IND with a virtual MAC address from the pool to DLSw+. If there is no virtual MAC address, then the x25 map qllc or x25 pvc qllc command must provide a virtual MAC address.

The npsi-poll parameter is needed to support PU 2.0 on the partner side that wishes to connect to a FEP on the X.25 side. In a Token Ring or DLSw+ environment the PU 2.0 will send a null XID to the FEP. If the software forwards this null XID to an X.25 attached FEP the FEP will assume that it is connecting to PU2.1, and will break off the connection when the PU 2.0 next send an XID Format 0 Type 2.

Examples

The following commands assign virtual MAC address 1000.0000.0001 to a remote X.25-attached 3174, which is then mapped to the X.121 address of the 3174 (31104150101) in an X.25-attached router:

interface serial 0
 x25 address 3110212011
 x25 map qllc 1000.000.0001 31104150101
 qllc dlsw partner 4000.1161.1234

Syntax Description

sdlc-address	SDLC addresses are in hexadecimal. The valid range is 1 to FE.
default	Allows the user to configure an unlimited number of SDLC addresses to DLSw+.
partner mac-address	MAC address for default partner
inbound	(Optional) Partner will initiate connection.
outbound	(Optional) Initiate connection to partner.

Defaults

No correspondence is defined between SDLC addresses and DLSw+.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following command attaches SDLC address d2 to DLSw+:

sdlc dlsw d2
 

The following command attaches SDLC addresses d2, d5, e3, e4, e6, b1, c3, d4, a1 and a5:

sdlc dlsw d2 d5 e3 e4 e6 b1 c3 d4 a1 a5

Related Commands

Command	Description
encapsulation sdlc	Configures an SDLC interface.
sdlc address	Assigns a set of secondary stations attached to the serial link.
sdlc role	Establishes the router to be either a primary or secondary SDLC station.

Syntax Description

interface type number	(Optional) Specifies the interface type and number for which the DLSw+ capabilities are to be displayed.
ip-address ip-address	(Optional) Specifies a peer by its IP address.
local	(Optional) Specifies the local DLSw+ peer.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.

Examples

The following is sample output from the show dlsw capabilities command:

Router# show dlsw capabilities
 
DLSw: Capabilities for peer 1.1.1.6(2065)
	 	 vendor id (OUI)         : '00C' (cisco)
  version number          : 1
  release number          : 0
  init pacing window      : 20
  unsupported saps        : none
  num of tcp sessions     : 1
  loop prevent support    : no
  icanreach mac-exclusive : no
  icanreach netbios-excl. : no
  reachable mac addresses : none
  reachable netbios names : none
  cisco version number    : 1
  peer group number       : 0
  border peer capable     : no
  peer cost               : 3
  biu-segment configured  : no
  UDP Unicast support     : yes 
  local-ack configured    : yes
  priority configured     : no
  configured ip address   : 1.1.1.6
  peer type               : conf
  version string          : 
Cisco Internetwork Operating System Software 
IOS (tm) RSP Software (RSP-JSV-M), Version 11.3(4), RELEASE SOFTWARE (fc1)
Copyright (c) 1986-1998 by cisco Systems, Inc.
Compiled Tue 16-Jun-98 04:29 by phanguye
 

Syntax Description

detail	(Optional) Display circuit state information in expanded format.
mac-address address	(Optional) Specifies the MAC address to be used in the circuit search.
sap-value value	(Optional) Specifies the SAP to be used in the circuit search.
circuit id	(Optional) Specifies the circuit ID of the circuit index.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.

Examples

The following is sample output from the show dlsw circuits command:

Router# show dlsw circuits 
 
Index           local addr(lsap)    remote addr(dsap)  state          uptime
4060086272      4000.0000.0056(F0)  4001.0000.0049(F0) CONNECTED      00:00:13
Total number of circuits connected: 1
 

The following is sample output from the show dlsw circuits command with the detail argument:

Router# show dlsw circuits detail
 
Index   local addr(lsap)    remote addr(dsap)   state uptime
194 0800.5a9b.b3b2(F0)  800.5ac1.302d(F0)  CONNECTED 00:00:13
        PCEP: 995AA4     UCEP: A52274
        Port: To0/0      peer 172.18.15.166(2065)
        Flow-Control-Tx SQ CW:20, Permitted:28; Rx CW:22, Granted:25 Op:
IWO
        Congestion: LOW(02), Flow Op: Half: 12/5 Reset 1/0
        RIF = 0680.0011.0640

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following is sample output from the show dlsw fastcache command with an FST peer:

Router# show dlsw fastcache
 
    peer              local-mac      remote-mac   l/r sap rif
FST 10.2.32.1       0800.5a8f.881c 0800.5a8f.8822  04/04  0680.02D5.1360
 

The following is sample output from the show dlsw fastcache command:

Router# show dlsw fastcache
 
    peer              local-mac      remote-mac   l/r sap rif

IF Se1 		0800.5a8f.881c 	 0800.5a8f.8822 F0/F0 0680.02D5.1360
 

Syntax Description

interface type number	(Optional) Specifies a remote peer by a direct interface.
ip-address ip-address	(Optional) Specifies a remote peer by its IP address.
ssp-dlx	(Optional) Details SSP and DLX primitive frames received and transmitted by a TCP or LLC2 peer.
udp	(Optional) Shows UDP frame forwarding statistics for specified peers.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0	This command was introduced.
12.0(5)T	The keyword ssp-dlx was added.

Examples

The following is sample output from the show dlsw peers command:

Router# show dlsw peers udp
 
Peers: 		 tot-Q'd  	 	 	 total-rx  total-tx  	 	 tot-retx  	tot-drop curr-Q'd TCP uptime
1.1.1. 	 	 	 0		 	 	 	 	 	 	 	 	 	 	 	 23	 	 	 	 	 	 	 	 	0	 	 	 	 	 	 	 	 	 	 	 	0	 	 	 	 	 	 	 	 	 	 0	 	 	 	 	 	 	 	0	 	 	 	 	 	 	0	 	00:01:02
Total number of connected peers: 2
Total number of connections:     8
 

The following is sample output from the show dlsw peers command with a TCP connection:

Router# show dlsw peers
 
Peers:                state     pkts_rx   pkts_tx  type  drops ckts TCP   uptime
 TCP 1.1.91.1 
     High priority   CONNECT         43        40  conf      0    1   0 00:01:02
   Medium priority   CONNECT          0         0  conf      0    -   0 00:01:02
   Normal priority   CONNECT          4        41  conf      0    -   5 00:01:02
      Low priority   CONNECT          1         0  conf      0    -   0 00:01:02
 TCP 1.1.93.1       
     High priority   CONNECT          3         3  conf      0    0   0 00:00:58
   Medium priority   CONNECT          0         0  conf      0    -   0 00:00:58
   Normal priority   CONNECT          0         0  conf      0    -   0 00:00:58
      Low priority   CONNECT          0        39  conf      0    -   0 00:00:58
Total number of connected peers: 2
Total number of connections:     8

The following is sample output from the show dlsw peers command with a Direct Frame Relay connection:

Router # show dlsw peers
 
Peers:                state 	 	 	 	pkts_rx pkts_tx  type  drops ckts TCP 	 	 	 uptime
IF 	 	 	SE1	16													 	 	 	 	 	 	 	 	 	 	 connect	 	 	 	 	 	 	53 	 							 					 2597		 	 	 	 conf		 	 	 								0						 	 	 	 	 -		 	 	 	 -	 	 	 	00:04:09
Total number of connected peers: 2
Total number of connections:     8
 

The following is sample output from the show dlsw peers command with a Direct Frame Relay with local acknowledgment (LLC2) connection:

Router # show dlsw peers
 
Peers:                state 		 	 	 	 pkts_rx pkts_tx  type  drops ckts TCP 	 	 	 uptime
LLC2 SE1	16	 	 	 	 	 	 	 	 	 	 	 connect		 	 	 	 	 											 1179				 	 	 								 108	 	 	 	 	conf		 	 	 		 0	1		 	 	 -		 	 	 	 -	 	 							 		 00:04:09
Total number of connected peers: 2
Total number of connections:     8

The following is sample output from the show dlsw peers ssp-dlx command:

torino#show dlsw peers ssp-dlx
Peer:1.1.1.6                               received transmitted
    CUR_ex Can U Reach Explorers                   5           2
    CUR_cs Can U Reach Circuit Start               2           5
    ICR_ex I Can Reach Explorers                   4           5
    ICR_cs I Can Reach Circuit Start               4           1
    ACK Reach Acknowledgement                      1           4
    XID Frame                                     22          20
    CONQ Contact Remote Station                    4           0
    CONR Remote Station Contacted                  0           4
    INFO Information (I) Frame                    39          39
    HLTQ Halt Data Link                            0           1
    HLTR Data Link Halted                          1           0
    HLTN Halt Data Link (no ack)                   1           2
    CAPX Capabilities Exchange                     2           2
    Total SSP Primatives                          85          85
 
    DLX Peer Test Request                        122         146
    DLX Peer Test Response                       146         122
    DLX Border to Border Message                  53           9
    --> SSP:CUR Can U Reach                      53           2
    --> SSP:DATA Data Frames                      0           7
 
    Last SSP Received: INFO
    Last SSP Sent: ICR
 
Total number of connected peers:1
Total number of connections:    1
 

Syntax Description

group	(Optional) Displays contents of group reachability cache only.
value	(Optional) Specifies the group number for the reachability check. Only displays group cache entries for the specified group. The valid range is 1 to 255.
local	(Optional) Displays contents of local reachabilty cache only.
remote	(Optional) Displays contents of remote reachabilty cache only.
mac-address	(Optional) Displays DLSw reachability for MAC addresses only.
address	(Optional) Specifies the MAC address for which to search in the reachability cache.
netbios-names	(Optional) Displays DLSw reachability for NetBIOS names only.
name	(Optional) Specifies the NetBIOS name for which to search in the reachability cache.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

If none of the group, local, or remote options are specified, then the caches will be displayed in the following order: local, remote, and group.

Examples

The following is sample output from the show dlsw reachability group command:

Router# show dlsw reachability group
 
DLSw Group MAC address reachability cache list
Mac Addr Group
0000.3072.1070     10
DLSW Group NetBIOS Name reachability cache list
NetBIOS Name    Group
 

The following is sample output from the show dlsw reachability command:

Router# show dlsw reachability
 
DLSw MAC address reachability cache list
Mac Addr        status     Loc.    peer/port          rif
0000.f641.91e8  SEARCHING  LOCAL   
0006.7c9a.7a48  FOUND      LOCAL   TokenRing0/0   0CB0.0011.3E71.A041.0DE5.0640
0800.5a4b.1cbc  SEARCHING  LOCAL   
0800.5a54.ee59  SEARCHING  LOCAL   
0800.5a8f.9c3f  FOUND      LOCAL   TokenRing0/0   08B0.A041.0DE5.0640
4000.0000.0050  FOUND      LOCAL   TokenRing0/0   0CB0.0011.3E71.A041.0DE5.0640
4000.0000.0306  FOUND      LOCAL   TokenRing0/0   0CB0.0011.3E71.A041.0DE5.0640
4000.0000.0307  SEARCHING  LOCAL   
4000.0000.0308  SEARCHING  LOCAL   
4000.1234.56c1  FOUND      LOCAL   Serial3/7      --no rif--
4000.1234.56c2  FOUND      LOCAL   Serial3/7      --no rif--
4000.3000.0100  FOUND      LOCAL   TokenRing0/0   08B0.A041.0DE5.0640
4000.4000.ff40  SEARCHING  LOCAL   
4000.7470.00e7  SEARCHING  LOCAL   
4000.ac0b.0001  FOUND      LOCAL   TokenRing0/0   08B0.A041.0DE5.0640
4001.0000.0064  FOUND      LOCAL   TokenRing0/0   0CB0.0011.3E71.A041.0DE5.0640
4001.3745.1088  FOUND      LOCAL   TokenRing0/0   08B0.A041.0DE5.0640
4100.0131.1030  FOUND      LOCAL   TokenRing0/0   
10B0.FFF1.4041.0041.3E71.A041.0DE5.0640
 
DLSw NetBIOS Name reachability cache list
NetBIOS Name    status     Loc.    peer/port          rif
APPNCLT2        FOUND      LOCAL   TokenRing0/0   08B0.A041.0DE5.0640
 

The following is sample output from the show dlsw reachability command with the mac-address argument:

Router# show dlsw reachability mac-address 4000.00000306
 
DLSw MAC address reachability cache list
Mac Addr        status     Loc.    peer/port          rif
4000.0000.0306  FOUND      LOCAL   TokenRing0/0   0CB0.0011.3E71.A041.0DE5.0640
 

The following is sample output from the show dlsw reachability command with the netbios-names argument:

Router# show dlsw reachability netbios-names
 
DLSw NetBIOS Name reachability cache list
NetBIOS Name    status     Loc.    peer/port          rif
APPNCLT2        FOUND      LOCAL   TokenRing0/0   08B0.A041.0DE5.0640
 

Syntax Description

border-peers

(Optional) Displays the number of frames processed in the local, remote, and group caches.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.2 F	This command was introduced.

Examples

The following sample is a sample output from the show dlsw statistics command. The output displays the number of frames processed in the local, remote, and group cache:

router# show dlsw statistics border-peers
 
100 Border Peer Frames processed
10 Border frames found Local
20 Border frames found Remote
17 Border frames found Group Cache

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

Issue the show dlsw transparent cache command on the master router of the transparent bridged domain.

Examples

The following is sample output from the show dlsw transparent cache command:

router#show dlsw transparent cache
Interface Ethernet0/1
 Circuit Cache
local addr(lsap)    remote addr(dsap)  state          Owner
0000.3028.92b6(08)  0007.0db1.238c(08) POSITIVE        SELF
0000.3028.92b6(08)  0008.dec3.609e(12) NEGATIVE        0009.fa50.0b1c
Total number of circuits in the Cache:2

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)T	This command was introduced.

Usage Guidelines

Issue the show dlsw transparent map command to ensure that the local MAC address is the address created in the dlsw transparent map command. The command should be issued on all the routers configured for the Ethernet Redundancy feature to ensure the local MAC addresses match.

Examples

The following is sample output from the show dlsw transparent map command on two routers configured for the Ethernet Redundancy feature:

router6#show dlsw transparent map

Interface Ethernet6/2
      LOCAL Mac          REMOTE MAC      BACKUP
      ---------          ----------      ------
    0008.dec3.0080     0008.dec3.609e    0007.7fb0.1080     STATIC
    0008.dec3.0040     0008.dec3.609e    0007.7fb0.1080     DYNAMIC(Passive)

router7#show dlsw transparent map
 
Interface Ethernet0/1
      LOCAL Mac          REMOTE MAC      BACKUP
      ---------          ----------      ------
    0008.dec3.0080     0008.dec3.609e    0006.3a0a.1a55     DYNAMIC(Passive)
    0008.dec3.0040     0008.dec3.609e    0006.3a0a.1a55     STATIC

The output from Router 6 and Router 7 shows the created MAC addresses are 0008.dec3.0080 and 0008.dec3.0040.

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(5)T	This command was introduced.

Examples

The following is sample output from the show dlsw transparent neighbor command:

router7#show dlsw transparent neighbor
Interface ATM0.1 
0006.e278.6c0e  SELF                     Master 
0009.fa50.0b1c  Rcvd Master-Accepted     VALID

The output shows that Router 7 is the master router whose MAC address is 0006.e278.6c0e. The other router, with a MAC address of 0009.fa50.0b1c, is a slave router on the common domain. The master router received a packet from the slave and notes the router is VALID