-
Bridging and IBM Networking Command Reference
-
About The Cisco IOS Software Documentation
-
Transparent Bridging Commands
-
Source-Route Bridging Commands
-
Remote Source-Route Bridging Commands
-
DLSw+ Configuration Commands
-
STUN and BSTUN Commands
-
LLC2 and SDLC Commands
-
IBM Network Media Translation Commands
-
DSPU and SNA Service Point Support Commands
-
SNA Frame Relay Access Support Commands
-
APPN Configuration Commands
-
NCIA Server Configuration Commands
-
IBM Channel Attach Commands
-
Ethernet Type Codes
-
Table Of Contents
dlsw peer-on-demand-defaults fst
dlsw peer-on-demand-defaults tcp
DLSw+ Configuration Commands
This chapter describes the commands to configure data-link switching plus (DLSw+), our implementation of the DLSw standard. For DLSw+ configuration tasks and examples, refer to the "Configuring Data-Link Switching Plus" chapter of the Bridging and IBM Networking Configuration Guide. For specific SDLC commands to configure DLSw+ for SDLC, refer to the "LLC2 and SDLC Commands" chapter in this publication.
dlsw allroute-netbios
Use the dlsw allroute-netbios global configuration command to change the single-route explorer to an all-route broadcast for NetBIOS. Use the no form of this command to return to the default single-route explorer.
dlsw allroute-netbios
no dlsw allroute-netbiosSyntax Description
This command has no arguments or keywords.
Default
Single-route explorer.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
Example
The following example specifies all-route broadcasts:
dlsw allroute-netbiosdlsw allroute-sna
Use the dlsw allroute-sna global configuration command to change the single-route explorer to an all-route broadcast for SNA. Use the no form of this command to return to the default single-route explorer.
dlsw allroute-sna
no dlsw allroute-snaSyntax Description
This command has no arguments or keywords.
Default
Single-route explorer.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
Example
The following example specifies all-route broadcasts:
dlsw allroute-snadlsw bgroup-list
Use the dlsw bgroup-list global configuration command to map traffic on the local Ethernet bridge group interface to remote peers. Use the no form of this command to cancel the map.
dlsw bgroup-list list-number bgroups number
no dlsw bgroup-listSyntax Description
Default
There is no default setting.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
The following example configures bgroup list 1:
dlsw bgroup-list 1 bgroups 33Related Commands
dlsw bridge-group
dlsw port-list
dlsw ring-listdlsw bridge-group
Use the dlsw bridge-group global configuration command to link DLSw+ to the bridge group of the Ethernet LANs. Use the no form of this command to disable the link.
dlsw bridge-group group-number
no dlsw bridge-group group-numberSyntax Description
group-number
The transparent bridge group to which DLSw+ will be attached. The valid range is 1 to 63.
Default
There is no default setting.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example links DLSw+ to bridge group 1:
dlsw bridge-group 1Related Command
dlsw disable
Use the dlsw disable global configuration command to disable and reenable DLSw+ without altering the configuration.
dlsw disable
Syntax Description
This command has no arguments or keywords.
Default
There is no default setting.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example disables and reenables DLSw+:
dlsw disableRelated Command
dlsw duplicate-path-bias
Use the dlsw duplicate-path-bias global configuration command to specify how DLSw+ handles duplicate paths to the same Media Access Control (MAC) address or NetBIOS name. Use the no form of the command to return to the default (fault-tolerance).
dlsw duplicate-path-bias [load-balance]
no dlsw duplicate-path-bias [load-balance]Syntax Description
Default
Fault-tolerance is the default logic used to handle duplicate paths.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
The following example specifies load balancing to resolve duplicate paths:
dlsw duplicate-path-bias load-balanceRelated Command
dlsw explorerq-depth
Use the dlsw explorerq-depth global configuration command to configure the depth of the DLSw explorer packet processing queue. Use the no form of this command to disable the explorer packet processing queue.
dlsw explorerq-depth queue-max
no dlsw explorerq-depth queue-maxSyntax Description
Default
No default queue-max is configured.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example sets the explorer packet processing queue to 256:
dlsw explorerq-depth 256Related Command
dlsw icannotreach saps
Use the dlsw icannotreach saps global configuration command to configure a list of service access points (SAPs) not locally reachable by the router. Use the no form of this command to remove the list.
dlsw icannotreach saps sap [sap...]
no dlsw icannotreach saps sap [sap...]Syntax Description
Default
No lists are configured.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3
The dlsw icannot reach 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.
Example
The following example specifies a list of SAPs that are not reachable:
dlsw icannotreach saps F0Related Command
dlsw icanreach
Use the dlsw icanreach global configuration command to configure a resource that is locally reachable by this router. Use the no form of this command to remove the resource.
dlsw icanreach {mac-exclusive | netbios-exclusive | mac-address mac-addr
[mask mask] | netbios-name name}
no dlsw icanreach {mac-exclusive | netbios-exclusive | mac-address mac-addr
[mask mask] | netbios-name name}Syntax Description
Default
No resources are configured.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
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:
dlsw icanreach netbios-exclusivedlsw icanreach netbios-name lanservRelated Commands
show dlsw capabilities
show dlsw peersdlsw local-peer
Use the dlsw local-peer global configuration command to define the parameters of the DLSw+ local peer. Use the no form of this command to cancel the definitions.
dlsw local-peer [peer-id ip-address] [group group] [border] [cost cost]
[lf size] [keepalive seconds] [passive] [promiscuous] [biu-segment]
no dlsw local-peer [peer-id ip-address] [group group] [border] [cost cost]
[lf size] [keepalive seconds] [passive] [promiscuous] [biu-segment]Syntax Description
Default
No parameters are defined.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
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 2Related Commands
dlsw duplicate-path-bias
show dlsw capabilities
show dlsw peersdlsw mac-addr
Use the dlsw mac-addr global configuration command to configure a static MAC address. Use the no form of this command to cancel the configuration.
dlsw mac-addr mac-addr {ring-group ring | remote-peer {interface serial number |
ip-address ip-address}| group group }
no dlsw mac-addr mac-addr {ring-group ring | remote-peer {interface serial number |
ip-address ip-address}| group group }Syntax Description
Default
No static MAC address is configured.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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. Alternatively, 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.
Example
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.2Related Commands
show dlsw capabilities
show dlsw peersdlsw netbios-name
Use the dlsw netbios-name global configuration command to configure a static NetBIOS name. Use the no form of this command to cancel the configuration.
dlsw netbios-name netbios-name {ring-group ring | remote-peer {interface serial number |
ip-address ip-address}| group group }
no dlsw netbios-name netbios-name {ring-group ring | remote-peer {interface serial number |
ip-address ip-address}| group group }Syntax Description
Default
No static NetBIOS name is configured.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example configures a static NetBIOS name and links it to ring group 3:
dlsw netbios-name netname ring-group 3Related Commands
show dlsw capabilities
show dlsw peersdlsw peer-on-demand-defaults fst
Use the dlsw peer-on-demand-defaults fst global configuration command to configure FST for peer-on-demand transport. Use the no form of this command to disable the previous assignment.
dlsw peer-on-demand-defaults fst [bytes-netbios-out bytes-list-name [cost cost]
host-netbios-out host-list-name] [keepalive seconds] [lsap-output-list list] [port-list
port-list-number].
no dlsw peer-on-demand-defaults fst [bytes-netbios-out bytes-list-name [cost cost]
host-netbios-out host-list-name] [keepalive seconds] [lsap-output-list list] [port-list
port-list-number]Syntax Description
Default
The default peer-on-demand transport is TCP.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example configures FST for peer-on-demand transport:
dlsw peer-on-demand-defaults fstRelated Commands
show dlsw capabilities
show dlsw peersdlsw peer-on-demand-defaults tcp
Use the dlsw peer-on-demand-defaults tcp global configuration command to configure TCP for peer-on-demand transport. Use the no form of this command to disable the previous assignment.
dlsw peer-on-demand-defaults tcp [bytes-netbios-out bytes-list-name] [cost cost]
[host-netbios-out host-list-name] [keepalive seconds] [local-ack] [lsap-output-list
list] [port-list port-list-number] [priority]
no dlsw peer-on-demand-defaults tcp [bytes-netbios-out bytes-list-name] [cost cost]
[host-netbios-out host-list-name] [keepalive seconds] [local-ack] [lsap-output-list
list] [port-list port-list-number] [priority]Syntax Description
Default
The default peer-on-demand transport is TCP.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example configures TCP for peer-on-demand transport:
dlsw peer-on-demand-defaults tcpRelated Commands
show dlsw capabilities
show dlsw peersdlsw port-list
Use the dlsw port-list global configuration command to map traffic on a local interface (Ethernet, Token Ring, or serial) to remote peers. Use the no form of this command to disable the previous map assignment.
dlsw port-list list-number type number
no dlsw port-list list-number type numberSyntax Description
list-number
Port list number. The valid range is 1 to 255.
type
Interface type.
number
Interface number.
Default
No port list is configured.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
The following example configures a DLSw peer port list for Ethernet interface 1:
dlsw port-list 3 ethernet 1Related Commands
dlsw bgroup-list
dlsw ring-listdlsw remote-peer frame relay
Use the dlsw remote-peer frame relay global configuration command to specify the remote peer with which the router will connect. Use the no form of this command to disable the previous assignments.
dlsw remote-peer list-number frame-relay interface serial number dlci-number
[backup-peer ip-address] [bytes-netbios-out bytes-list-name] [cost cost]
[dest-mac mac-address] [dmac-output-list access-list-number]
[host-netbios-out host-list-name] [keepalive seconds] [lf size] [linger minutes]
[lsap-output-list list] [pass-thru]
no dlsw remote-peer list-number frame-relay interface serial number dlci-number
[backup-peer ip-address] [bytes-netbios-out bytes-list-name] [cost cost]
[dest-mac mac-address] [dmac-output-list access-list-number]
[host-netbios-out host-list-name] [keepalive seconds] [lf size] [linger minutes]
[lsap-output-list list] [pass-thru]Syntax Description
Default
No defaults are specified.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0. The folloiwng keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number , linger minutes .
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.
Example
The following example specifies Frame Relay encapsulation connection for remote peer transport:
dlsw remote-peer 0 frame-relay interface 0 30Related Commands
dlsw local-peer
show dlsw capabilities
show dlsw peersdlsw remote-peer fst
Use the dlsw remote-peer fst global configuration command to specify an FST encapsulation connection for remote peer transport. Use the no form of this command to disable the previous assignments.
dlsw remote-peer list-number fst ip-address [backup-peer ip-address]
[bytes-netbios-out bytes-list-name][cost cost] [dest-mac mac-address]
[dmac-output-list access-list-number] [host-netbios-out host-list-name]
[keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [pass-thru]
no dlsw remote-peer list-number fst ip-address [backup-peer ip-address]
[bytes-netbios-out bytes-list-name][cost cost] [dest-mac mac-address]
[dmac-output-list access-list-number] [host-netbios-out host-list-name]
[keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [pass-thru]Syntax Description
Default
No FST encapsulation connection is specified.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0. The folloiwng keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number , linger minutes .
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.
Example
The following example specifies an FST encapsulation connection for remote peer transport:
dlsw remote-peer 1 fst 10.2.17.8Related Commands
dlsw local-peer
show dlsw capabilities
show dlsw peersdlsw remote-peer interface
Use the dlsw remote-peer interface global configuration command when specifying a point-to-point direct encapsulation connection. Use the no form of this command to disable previous interface assignments.
dlsw remote-peer list-number interface serial number [backup-peer ip-address]
[bytes-netbios-out bytes-list-name] [cost cost] [dest-mac mac-address]
[dmac-output-list access-list-number] [host-netbios-out host-list-name]
[keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [pass-thru]
no dlsw remote-peer list-number interface serial number [backup-peer ip-address]
[bytes-netbios-out bytes-list-name] [cost cost] [dest-mac mac-address]
[dmac-output-list access-list-number] [host-netbios-out host-list-name]
[keepalive seconds] [lf size] [linger minutes] [lsap-output-list list] [pass-thru]Syntax Description
Default
No point-to-point direct encapsulation connection is specified.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0. The folloiwng keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number , linger minutes .
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.
Example
The following example specifies a point-to-point direct encapsulation connection for remote peer transport:
dlsw remote-peer 1 interface serial 2Related Commands
A dagger (†) indicates that the command is documented outside this chapter.
show dlsw peers
show interfaces †dlsw remote-peer tcp
Use the dlsw remote-peer tcp global configuration command to identify the IP address of a peer with which to exchange traffic using TCP. Use the no form of this command to remove a remote peer.
dlsw remote-peer list-number tcp ip-address [backup-peer ip-address]
[bytes-netbios-out bytes-list-name] [cost cost] [dest-mac mac-address]
[dmac-output-list access-list-number] [dynamic] [host-netbios-out host-list-name]
[inactivity minutes] [keepalive seconds] [lf size] [linger minutes] [lsap-output-list list]
[no-llc minutes] [priority] [tcp-queue-max size] [timeout seconds]
no dlsw remote-peer list-number tcp ip-address [backup-peer ip-address]
[bytes-netbios-out bytes-list-name] [cost cost] [dest-mac mac-address]
[dmac-output-list access-list-number] [dynamic] [host-netbios-out host-list-name]
[inactivity minutes] [keepalive seconds] [lf size] [linger minutes] [lsap-output-list list]
[no-llc minutes] [priority] [tcp-queue-max size] [timeout seconds]Syntax Description
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 linger 5 minutes.
The dynamic option is inactive. If the dynamic option is added with neither suboption (inactivity, no-llc) specified, the default is to terminate the TCP connection to the remote peer after 5 minutes of no active LLC2 connection.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0. The folloiwng keywords and arguments first appeared in Cisco IOS Release 11.1: dynamic, inactivity minutes, linger minutes, no-llc minutes, timeout seconds. The folloiwng keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number , linger minutes .
SNA dial-on-demand routing (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.
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 either 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 only 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 gone.
Example
The following example specifies a TCP encapsulation connection for remote peer transport:
dlsw remote-peer 1 tcp 10.2.17.8Related Commands
dlsw ring-list
show dlsw capabilities
show dlsw peersdlsw ring-list
Use the dlsw ring-list to configure a ring list, mapping traffic on a local interface to remote peers. Use the no form of this command to cancel the definition.
dlsw ring-list list-number rings ring-number
no dlsw ring-list list-number rings ring-numberSyntax 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.
Default
There is no default setting.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
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 3Related Commands
dlsw bgroup-list
dlsw port-listt
show dlsw capabilities
show dlsw peersdlsw timer
Use the dlsw timer global configuration command to tune an existing configuration parameter. Use the no form of this command to restore the default parameters.
dlsw timer {icannotreach-block-time | netbios-cache-timeout | netbios-explorer-timeout |
netbios-retry-interval | netbios-verify-interval | sna-cache-timeout |
sna-explorer-timeout | sna-retry-interval | sna-verify-interval} time
no dlsw timer {icannotreach-block-time | netbios-cache-timeout |
netbios-explorer-timeout | netbios-retry-interval | netbios-verify-interval |
sna-cache-timeout | sna-explorer-timeout | sna-retry-interval | sna-verify-interval} timeSyntax Description