-
Bridging and IBM Networking Command Reference
-
About The Cisco IOS Software Documentation
- Part 1: Bridging
-
Part 2: IBM Networking
-
Remote Source-Route Bridging Commands
-
DLSw+ 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
-
Appendix - Ethernet Type Codes
-
-
Table Of Contents
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.
clear dlsw circuit
Use the clear dlsw circuit privileged EXEC command to cause all DLSw+ circuits to be closed.
clear dlsw circuit
Syntax Description
This command has no arguments or keywords.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
CautionThis command also drops the associated LLC2 session. The command usage should be used with caution and under the advice of a Cisco engineer.
Example
The following example closes all DLSw+ circuits:
clear dlsw circuitclear dlsw reachability
Use the clear dlsw reachability privileged EXEC command to remove all entries from the dlsw reachability cache.
clear dlsw reachability
Syntax Description
This command has no arguments or keywords.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
This command does not affect existing sessions.
Example
The following example removes all entries from the dlsw reachability cache:
clear dlsw reachabilityclear dlsw statistics
Use the clear dlsw statistics privileged EXEC command to reset to zero the number of frames that have been processed in the local, remote, and group cache.
clear dlsw statistics
Syntax Description
This command has no arguments or keywords.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
Example
The following example resets to zero the number of frames in the local, remote, and group cache:
clear dlsw statisticsdlsw 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
You can use the master indexes or search online to find documentation of related commands.
dlsw bridge-group
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 [llc2 [N2 number] [ack-delay-time milliseconds]
[ack-max number] [idle-time milliseconds] [local-window number] [t1-time milliseconds]
[tbusy-time milliseconds] [tpf-time milliseconds] [trej-time milliseconds]
[txq-max number] [xid-neg-val-time milliseconds] [xid-retry-time milliseconds]]
[locaddr-priority] [sap-priority]
no dlsw bridge-group group-number [llc2 [N2 number] [ack-delay-time milliseconds]
[ack-max number] [idle-time milliseconds] [local-window number] [t1-time milliseconds]
[tbusy-time milliseconds] [tpf-time milliseconds] [trej-time milliseconds]
[txq-max number] [xid-neg-val-time milliseconds] [xid-retry-time milliseconds]]
[locaddr-priority] [sap-priority]Syntax Description
Default
There is no default setting.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
The following example links DLSw+ to bridge group 1, 2 and 3:
dlsw local-peer peer-id 1.1.1.1dlsw remote-peer 0 tcp 2.2.2.2dlsw bridge-group 1dlsw bridge-group 2dlsw bridge-group 3interface Ethernet0bridge-group 1interface Ethernet1bridge-group 2interface Ethernet2bridge-group 3bridge 1 protocol ieeebridge 2 protocol ieeebridge 3 protocol ieeeRelated Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw disable
Use the dlsw disable global configuration command to disable and reenable DLSw+ without altering the configuration.
dlsw disable
no dlsw disableSyntax 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 re-enables DLSw+:
no dlsw disabledlsw 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-balancedlsw group-cache disable
Use the dlsw group cache disable global configuration command to disable the border peer caching feature. Use the no form of this command to return to the default peer caching feature.
dlsw group-cache disable
no dlsw group-cache disableSyntax Description
This command has no arguments or keywords.
Default
This command is enabled by default.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
If a border peer becomes a non-border 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.
Example
The following example disables the group cache:
dlsw group-cache disableRelated Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw group-cache max-entries
Use the dlsw group-cache max entries global configuration command to limit the number of entries in the group cache. Use the no form of this command to return to the default.
dlsw group-cache max-entries number
no dlsw group-cache max entriesSyntax 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.
Default
The default setting is 2000.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
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 cache max applies to both the NetBIOS and SNA group cache.
Example
The following configuration defines the maximum number of entries allowed in the NetBIOS or SNA group cache as 1800:
dlsw group-cache max-entries 1800Releated Commands
You can use the master indexes or search online to find documentation of related commands.
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 F0dlsw 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 | saps}
no dlsw icanreach {mac-exclusive | netbios-exclusive | mac-address mac-addr
[mask mask] | netbios-name name | saps}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
You can use the master indexes or search online to find documentation of related commands.
dlsw llc2 nornr
Use the dlsw llc2 nornr global configuration command to prevent the receiver not ready (RNR) message from being sent while establishing an LLC2 connection. Use the no form of this command to return to the default.
dlsw llc2 nornr
no dlsw llc2 nornrDefault
The command is disabled by default.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
This command is used when any device does not handle the LLC2 RNR frames.
Examples
The following configuration keeps the receiver not ready message from being sent when establishing an LLC2 connection.
router# dlsw llc2 nornrThe 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 4000234910268 0.173 LLC C D=00 S=04 TEST P9 0.003 LLC R D=04 S=00 TEST F10 0.002 SNA XID Fmt 2 T411 0.059 SNA XID Fmt 2 T412 0.004 SNA XID Fmt 2 T413 0.065 SNA XID Fmt 2 T414 0.005 SNA XID Fmt 2 T416 0.054 LLC C D=04 S=04 SABME P17 0.003 LLC R D=04 S=04 UAThe router sends a receiver not ready message.
18 0.001 LLC C D=04 S=04 RNR NR=0From frames 19 to 35, the FEP does not respond.
19 0.002 LLC C D=04 S=04 RR NR=020 0.048 SNA C NC NC-ER-OP21 0.997 LLC C D=04 S=04 RR NR=0 P22 1.000 LLC C D=04 S=04 RR NR=0 P24 1.000 LLC C D=04 S=04 RR NR=0 P25 1.000 LLC C D=04 S=04 RR NR=0 P31 1.000 LLC C D=04 S=04 RR NR=0 P32 1.000 LLC C D=04 S=04 RR NR=0 P34 1.000 LLC C D=04 S=04 RR NR=0 P35 1.000 LLC C D=04 S=04 RR NR=0 PThe router disconnects the circuit.
37 1.000 LLC C D=04 S=04 DISC P38 0.002 LLC R D=04 S=04 UA FThe sequence repeats.
39 0.179 LLC C D=00 S=04 TEST P41 0.767 SNA XID Fmt 2 T442 0.634 SNA XID Fmt 2 T443 0.173 LLC C D=00 S=04 TEST44 0.003 LLC R D=04 S=00 TEST F45 0.002 SNA XID Fmt 2 T446 0.060 SNA XID Fmt 2 T447 0.004 SNA XID Fmt 2 T448 0.063 SNA XID Fmt 2 T449 0.005 SNA XID Fmt 2 T4dlsw 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]
[init-pacing-window size] [max-pacing-window size]
no dlsw local-peer [peer-id ip-address] [group group] [border] [cost cost]
[lf size] [keepalive seconds] [passive] [promiscuous] [biu-segment]
[init-pacing-window size] [max-pacing-window size]Syntax Description
Default
No parameters are defined.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
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
You can use the master indexes or search online to find documentation of related commands.
dlsw duplicate-path-bias
show dlsw capabilitiesdlsw 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 ring -number| remote-peer {interface serial number |
ip-address ip-address}| rif rif-string | }
no dlsw mac-addr mac-addr {ring ring -number| remote-peer {interface serial number |
ip-address ip-address}| rif rif-string | 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
You can use the master indexes or search online to find documentation of related commands.
dlsw max-multiple-rifs
Use the dlsw max-multiple-rifs global configuration command to enable caching of multiple RIFs per interface. Use the no form of this command to turn off the feature.
dlsw max-multiple-rifs multiple-rifs-per-port
no dlsw max-multiple-rifs multiple-rifs-per-portSyntax Description
Default
The deafult value is 1.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3.
A MAC address or NetBIOS name can have several RIF entries. Prior to this command, DLSw+ could cache only one of these RIF entries per local Token Ring port. With the dlsw max-multiple-rifs command configured, however, DLSw+ can cache multiple RIF enties (up to 4) for a specific MAC address or NetBIOS name on one token ring port.
If the value 1 is specified, multiple RIF caching is not enabled.
Example
The following example enables the router to cache up to 2 RIFs per interface:
dlsw max-multiple-rifs 2dlsw netbios-keepalive-filter
Use the dlsw netbios-keepalive-filter global configuration command to enable the NetBIOS Dial-on-Demanding Routing (DDR) feature. Use the no form of this command to turn off the feature.
dlsw netbios-keepalive-filter
no dlsw netbios-keepalive-filterSyntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Global configuration
Usage Guidelines
This command first appeared in 11.2 F.
See the "Bridging and IBM Networking Overview" chapter of the Bridging and IBM Networking Configuration Guide for more details on the NetBIOS DDR feature.
Example
The following example enables NetBIOS DDR:
dlsw netbios-keepalive-filterdlsw 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 ring-number | remote-peer {interface serial number |
ip-address ip-address}| rif rif-string | group group}
no dlsw netbios-name netbios-name {ring ring-number | remote-peer
{interface serial number | ip-address ip-address}| rif rif-string | 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 group 3:
dlsw netbios-name netname group 3Related Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw peer-on-demand-defaults
Use the dlsw peer-on-demand-defaults global configuration command to configure defaults 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]
[dest-mac destination mac address] [dmac-output-list access list number]
[host-netbios-out host-list-name] [inactivity minutes] [keepalive seconds] [lf size]
[lsap-output-list list] [port-list port-list-number] [priority] [tcp-queue-max]
no dlsw peer-on-demand-defaults [fst] [bytes-netbios-out bytes-list-name] [cost cost]
[dest-mac destination mac address] [dmac-output-list access list number]
[host-netbios-out host-list-name] [inactivity minutes] [keepalive seconds] [lf size]
[lsap-output-list list] [port-list port-list-number] [priority] [tcp-queue-max]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
You can use the master indexes or search online to find documentation of related commands.
dlsw 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 token ring interface 1:
dlsw port-list 3 token ring 1Related Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw bgroup-list
dlsw ring-listdlsw prom-peer-defaults
Use the dlsw prom-peer-defaults global configuration command to configure defaults for promiscuous transport. Use the no form of this command to disable the previous assignment.
dlsw prom-peer-defaults [fst] [bytes-netbios-out bytes-list-name] [cost cost]
[dest-mac destination mac address] [dmac-output-list access list number]
[host-netbios-out host-list-name] [keepalive seconds] [lf size]
[lsap-output-list list] [tcp-queue-max size]
no dlsw prom-peer-defaults [fst] [bytes-netbios-out bytes-list-name] [cost cost]
[dest-mac destination mac address] [dmac-output-list access list number]
[host-netbios-out host-list-name] [keepalive seconds] [lf size]
[lsap-output-list list] [tcp-queue-max size]
Syntax Description
Default
The default prom-peer transport is TCP.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example configures cost for promiscuous peers:
dlsw prom-peer-defaults cost 4Related Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw 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 | frame-relay interface serial number dlci-number |
interface name]] [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] [passive]
[pass-thru]
no dlsw remote-peer list-number frame-relay interface serial number dlci-number
[backup-peer [ip-address | frame-relay interface serial number dlci-number |
interface name]] [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] [passive]
[pass-thru]Syntax Description
Default
No remote peers are specified.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0. The following keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number and 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.
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-thrudlsw remote-peer 0 frame-relay interface serial 0 30 backup-peer frame-relay interface serial 1 40The following example specifies Frame Relay encapsulation connection for remote peer transport:
dlsw remote-peer 0 frame-relay interface 0 30Related Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw 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 FST assignments.
dlsw remote-peer list-number fst ip-address [backup-peer [ip-address | frame-relay
interface serial number dlci-number | interface name]]
[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] [passive]
no dlsw remote-peer list-number fst ip-address [backup-peer [ip-address | frame-relay
interface serial number dlci-number | interface name]]
[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] [passive]Syntax Description
Default
No FST encapsulation connection is specified.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3. The following keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number, and 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 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.1dlsw remote-peer 1 fst 10.2.17.8 backup-peer 10.2.18.1The following example specifies an FST encapsulation connection for remote peer transport:
dlsw remote-peer 1 fst 10.2.17.8Related Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw 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 | frame-relay
interface serial number dlci-number | interface name]] [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] [passive] [pass-thru]
no dlsw remote-peer list-number interface serial number [backup-peer [ip-address |
frame-relay interface serial number dlci-number | interface name]]
[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] [passive]
[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 10.3. The following 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 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-thrudlsw remote-peer 1 interface serial 2 pass-thru backup-peer interface serial 1The following example specifies a point-to-point direct encapsulation connection for remote peer transport:
dlsw remote-peer 1 interface serial 2 pass-thruRelated Commands
You can use the master indexes or search online to find documentation of related commands.
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 | frame-relay
interface serial number dlci-number | interface name]] [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] [dynamic] [keepalive seconds]
[lf size] [linger minutes] [lsap-output-list list] [no-llc minutes] [passive] [priority]
[tcp-queue-max size] [timeout seconds]
no dlsw remote-peer list-number tcp ip-address [backup-peer [ip-address | frame-relay
interface serial number dlci-number | interface name]] [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] [dynamic] [keepalive seconds]
[lf size] [linger minutes] [lsap-output-list list] [no-llc minutes] [passive] [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 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.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3. The following keywords and arguments first appeared in Cisco IOS Release 11.1: dynamic, inactivity minutes, linger minutes, no-llc minutes and timeout seconds. The following keywords and arguments first appeared in Cisco IOS Release 11.2: dest-mac mac-address, dmac-output-list access-list-number, linger minutes.
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.
Examples
The following example specifies a TCP peer as backup to a primary FST peer:
dlsw remote-peer 0 fst 10.2.18.9dlsw remote-peer 1 tcp 10.2.17.8 backup-peer 10.2.18.9The following example specifies a TCP encapsulation connection for remote peer transport:
dlsw remote-peer 1 tcp 10.2.17.8The 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 precedence to routine precedence.
ip local policy route-map testaccess-list 101 permit tcp any eq 2065 anyaccess-list 101 permit tcp any any eq 2065route-map test permit 20match ip address 101set ip precedence routineRelated Commands
You can use the master indexes or search online to find documentation of related commands.
dlsw 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
You can use the master indexes or search online to find documentation of related commands.
dlsw port-list
show dlsw capabilities
dlsw remote-peer frame relaydlsw 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-group-cache | netbios-retry-interval | netbios-verify-interval |
sna-cache-timeout | explorer-delay-time | sna-explorer-timeout | explorer-wait-time |
sna-group-cache | sna-retry-interval | sna-verify-interval} time
no dlsw timer {icannotreach-block-time | netbios-cache-timeout |
netbios-explorer-timeout | netbios-group-cache | netbios-retry-interval |
netbios-verify-interval | sna-cache-timeout | explorer-delay-time | sna-explorer-timeout
| explorer-wait-time | sna-group-cache | sna-retry-interval | sna-verify-interval} timeSyntax Description
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
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 3dlsw udp-disable
Use the dlsw udp-disable global configuration command to disable the UDP Unicast feature. Use the no form of this command to return to the default UDP Unicast feature.
dlsw udp-disable
no dlsw udp-disableSyntax Description
This command has no arguments or keywords.
Default
The UDP Unicast feature is enabled.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
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.
Example
The following example disables the UDP Unicast feature:
dlsw udp-disableqllc dlsw
Use the qllc dlsw interface configuration command to enable DLSw+ over Qualified Logical Link Control (QLLC). Use the no form of this command to cancel the configuration.
qllc dlsw {subaddress subaddress | pvc pvc-low [pvc-high]} [vmac vmacaddr
[poolsize]] [partner partner-macaddr] [sap ssap dsap] [xid xidstring] [npsi-poll]
no qllc dlsw {subaddress subaddress | pvc pvc-low [pvc-high]} [vmac vmacaddr
[poolsize]] [partner partner-macaddr] [sap ssap dsap] [xid xidstring] [npsi-poll]Syntax Description
Default
No defaults are specified.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Example
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 0x25 address 3110212011x25 map qllc 1000.000.0001 31104150101qllc dlsw partner 4000.1161.1234sdlc dlsw
Use the sdlc dlsw interface configuration command to attach SDLC addresses to DLSw+. Use the no form of this command to cancel the configuration.
sdlc dlsw {sdlc-address | default | partner mac address [inbound | outbound]}
no sdlc dlsw {sdlc-address | default | partner mac address [inbound | outbound]}Syntax Description
Default
No correspondence is defined.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Examples
The following command attaches SDLC address d2 to DLSw+:
sdlc dlsw d2The 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 a5Related Commands
You can use the master indexes or search online to find documentation of related commands.
encapsulation sdlc
sdlc address
sdlc roleshow dlsw capabilities
Use the show dlsw capabilities privileged EXEC command to display the configuration of a specific peer or all peers.
show dlsw capabilities [interface type number | ip-address ip-address | local]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Sample Display
The following is sample output from the show dlsw capabilities command:
Router# show dlsw capabilitiesDLSw: Capabilities for peer 1.1.1.6(2065)vendor id (OUI) : '00C' (cisco)version number : 1release number : 0init pacing window : 20unsupported saps : nonenum of tcp sessions : 1loop prevent support : noicanreach mac-exclusive : noicanreach netbios-excl. : noreachable mac addresses : nonereachable netbios names : nonecisco version number : 1peer group number : 0border peer capable : nopeer cost : 3biu-segment configured : noUDP Unicast support : yeslocal-ack configured : yespriority configured : noconfigured ip address : 1.1.1.6peer type : confversion string :describes significant fields shown from the show dlsw capabilities command.
show dlsw circuits
Use the show dlsw circuits privileged EXEC command to display the state of all circuits involving this MAC address as a source and destination.
show dlsw circuits [detail] [mac-address address | sap-value value | circuit id]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Sample Displays
The following is sample output from the show dlsw circuits command:
Router# show dlsw circuitsIndex local addr(lsap) remote addr(dsap) state uptime4060086272 4000.0000.0056(F0) 4001.0000.0049(F0) CONNECTED 00:00:13Total number of circuits connected: 1The following is sample output from the show dlsw circuits command with the detail argument:
Router# show dlsw circuits detailIndex local addr(lsap) remote addr(dsap) state uptime194 0800.5a9b.b3b2(F0) 800.5ac1.302d(F0) CONNECTED 00:00:13PCEP: 995AA4 UCEP: A52274Port: To0/0 peer 172.18.15.166(2065)Flow-Control-Tx SQ CW:20, Permitted:28; Rx CW:22, Granted:25 Op:IWOCongestion: LOW(02), Flow Op: Half: 12/5 Reset 1/0RIF = 0680.0011.0640describes significant fields shown in the display.
show dlsw fastcache
Use the show dlsw fastcache privileged EXEC command to display the fast cache for FST and direct-encapsulated peers.
show dlsw fastcache
Syntax Description
This command has no arguments or keywords.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Display
The following is sample output from the show dlsw fastcache command with an FST peer:
Router# show dlsw fastcachepeer local-mac remote-mac l/r sap rifFST 10.2.32.1 0800.5a8f.881c 0800.5a8f.8822 04/04 0680.02D5.1360The following is sample output from the show dlsw fastcache command:
Router# show dlsw fastcachepeer local-mac remote-mac l/r sap rifIF Se1 0800.5a8f.881c 0800.5a8f.8822 F0/F0 0680.02D5.1360describes significant fields shown in the display.
show dlsw peers
Use the show dlsw peers privileged EXEC command to display DLSw peer information.
show dlsw peers [interface type number | ip-address ip-address | udp]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Displays
The following is sample output from the show dlsw peers command:
Router# show dlsw peers udpPeers: tot-Q'd total-rx total-tx tot-retx tot-drop curr-Q'd TCP uptime1.1.1. 6 0 23 0 0 0 0 0 00:01:02Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers command with a TCP connection:
Router# show dlsw peersPeers: state pkts_rx pkts_tx type drops ckts TCP uptimeTCP 1.1.91.1High priority CONNECT 43 40 conf 0 1 0 00:01:02Medium priority CONNECT 0 0 conf 0 - 0 00:01:02Normal priority CONNECT 4 41 conf 0 - 5 00:01:02Low priority CONNECT 1 0 conf 0 - 0 00:01:02TCP 1.1.93.1High priority CONNECT 3 3 conf 0 0 0 00:00:58Medium priority CONNECT 0 0 conf 0 - 0 00:00:58Normal priority CONNECT 0 0 conf 0 - 0 00:00:58Low priority CONNECT 0 39 conf 0 - 0 00:00:58Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers command with a Direct Frame Relay connection:
Router # show dlsw peersPeers: state pkts_rx pkts_tx type drops ckts TCP uptimeIF SE1 16connect 652 597 conf 0 - - 00:04:09Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers command with a Direct Frame Relay with local acknowledgment (LLC2) connection:
Router # show dlsw peersPeers: state pkts_rx pkts_tx type drops ckts TCP uptimeLLC2 SE1 16connect 1179 108 conf 0 1 - 00:04:09Total number of connected peers: 2Total number of connections: 8describes the significant fields shown in the show dlsw peers command display.
show dlsw reachability
Use the show dlsw reachability privileged EXEC command to display DLSw reachability information.
show dlsw reachability [[group [value] | local | remote] | [mac-address [address]
[netbios-names [name]]Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Sample Displays
The following is sample output from the show dlsw reachability group command:
router# show dlsw reachability groupDLSw Group MAC address reachability cache listMac Addr Group0000.3072.1070 10DLSW Group NetBIOS Name reachability cache listNetBIOS Name GroupThe following is sample output from the show dlsw reachability command:
Router# show dlsw reachabilityDLSw MAC address reachability cache listMac Addr status Loc. peer/port rif0000.f641.91e8 SEARCHING LOCAL0006.7c9a.7a48 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06400800.5a4b.1cbc SEARCHING LOCAL0800.5a54.ee59 SEARCHING LOCAL0800.5a8f.9c3f FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404000.0000.0050 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06404000.0000.0306 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06404000.0000.0307 SEARCHING LOCAL4000.0000.0308 SEARCHING LOCAL4000.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.06404000.4000.ff40 SEARCHING LOCAL4000.7470.00e7 SEARCHING LOCAL4000.ac0b.0001 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404001.0000.0064 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06404001.3745.1088 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404100.0131.1030 FOUND LOCAL TokenRing0/010B0.FFF1.4041.0041.3E71.A041.0DE5.0640DLSw NetBIOS Name reachability cache listNetBIOS Name status Loc. peer/port rifAPPNCLT2 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.0640The following is sample output from the show dlsw reachability command with the mac-address argument:
Router# show dlsw reachability mac-address 4000.00000306DLSw MAC address reachability cache listMac Addr status Loc. peer/port rif4000.0000.0306 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.0640The following is sample output from the show dlsw reachability command with the netbios-names argument:
Router# show dlsw reachability netbios-namesDLSw NetBIOS Name reachability cache listNetBIOS Name status Loc. peer/port rifAPPNCLT2 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.0640describes the significant fields shown in the show dlsw reachability command.
show dlsw statistics
Use the show dlsw statistics privileged EXEC command to display the number of frames that have been processed in the local, remote, and group cache.
show dlsw statistics [border-peers]
Syntax Description
border-peers
(Optional) Displays the number of frames processed in the local, remote, and group caches.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
Example
The following sample displays the number of frames processed in the local, remote, and group cache:
router# show dlsw statistics border-peers100 Border Peer Frames processed10 Border frames found Local20 Border frames found Remote17 Border frames found Group Cache
