|
|
Cisco's serial tunnel (STUN) feature allows Synchronous Data Link Control (SDLC) or High-Level Data Link Control (HDLC) devices to connect to one another through a multiprotocol internetwork rather than through a direct serial link. STUN encapsulates SDLC frames in either the Transmission Control Protocol/Internet Protocol (TCP/IP) or the HDLC protocol. STUN provides a straight passthrough of all SDLC traffic (including control frames, such as Receiver Ready) end-to-end between Systems Network Architecture (SNA) devices.
Cisco's SDLC local acknowledgment provides local termination of the SDLC session so that control frames no longer travel the WAN backbone networks. This means end nodes do not time out, and a loss of sessions does not occur. You can configure your network with STUN, or with STUN and SDLC local acknowledgment. To enable SDLC local acknowledgment, the Cisco IOS software must first be enabled for STUN and routers configured to appear on the network as primary or secondary SDLC nodes. TCP/IP encapsulation must be enabled. Cisco's SDLC transport feature also provides priority queuing for TCP encapsulated frames.
Cisco's block serial tunnel (BSTUN) implementation enables Cisco 2500, 3600, 4000, 4500, 4700 and 7200 series routers to support devices that use the Binary Synchronous Communications (Bisync) datalink protocol and asynchronous security protocols that include Adplex, ADT Security Systems, Inc., Diebold, asynchronous generic, and mdi traffic. Our support of the Bisync protocol enables enterprises to transport Bisync traffic and SNA multiprotocol traffic over the same network.
Use the commands in this chapter to configure BSTUN, Bisync, STUN, and SDLC local acknowledgment networks. For STUN and BSTUN configuration information and examples, refer to the "Configuring Serial Tunnel and Block Serial Tunnel" chapter in the Cisco IOS Bridging and IBM Networking Configuration Guide. To locate documentation of other commands, use the command reference master index or search online.
To configure an asynchronous port to transmit and receive polled asynchronous traffic through a BSTUN tunnel, use the asp addr-offset interface configuration command. Use the no form of this command to cancel the specification.
asp addr-offset address-offset
Syntax Description
address-offset Location of the address byte within the polled asynchronous frame being received.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.2 F This command was introduced.
Release
Modification
Usage Guidelines
This command is used to specify the offset from the start of the frame where the address byte is located. This command only applies when the asynchronous-generic protocol has been specified on an interface using a combination of the bstun protocol-group global configuration command and the bstun group interface configuration command.
Interfaces configured to run the asynchronous-generic protocol have their baud rate set to 9600 bps, use 8 data bits, no parity, 1 start bit, and 1 stop bit. If different line configurations are required, use the rxspeed, txspeed, databits, stopbits, and parity line configuration commands to change the line attributes.
The addresses of the alarm panels should be used in the address field of the bstun route address interface configuration command.
Examples
The following example specifies that the first byte in the polled asynchronous frame contains the device address:
asp addr-offset 0
Related Commands
Specifies whether the router is acting as the primary end of the polled asynchronous link or as the secondary end of the polled asynchronous link connected to the serial interface, and whether the attached remote device is a security alarm control station. Specifies a time period that, by expiring, signals the end of one frame being received and the start of the next. Defines a BSTUN group and the protocol it uses. Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.
Command
Description
To specify whether the router is acting as the primary end of the polled asynchronous link or as the secondary end of the polled asynchronous link connected to the serial interface and the attached remote device is a security alarm control station, use the asp role interface configuration command. Use the no form of this command to cancel the specification.
asp role {primary | secondary}
Syntax Description
primary Router is the primary end of the polled asynchronous link connected to the serial interface, and the attached remote devices are alarm panels. secondary Router is the secondary end of the polled asynchronous link connected to the serial interface, and the attached remote device is a security alarm control station.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.2 F This command was introduced.
Release
Modification
Usage Guidelines
This command enables the interface on which ASP is configured. Configure the interface connected to the alarm console as a secondary router and the interface connected to the alarm panel as a primary router.
The addresses of the alarm panels should be used in the address field of the bstun route address interface configuration command.
Examples
The following example specifies the router as the primary end of the link:
asp role primary
Related Commands
Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.
Command
Description
To specify a time period that, by expiring, signals the end of one frame being received and the start of the next, use the asp rx-ift interface configuration command. Use the no form of this command to cancel the specification.
asp rx-ift interframe-timeout
Syntax Description
interframe-timeout Number of milliseconds between the end of one frame being received and the start of the next frame. The default timeout value is 40 ms.
Defaults
The default timeout value is 40 ms.
Command Modes
Interface configuration
Command History
11.2 F This command was introduced.
Release
Modification
Usage Guidelines
The interframe timeout is useful when different baud rates are used between the router and the alarm console or alarm panel. For example, you might set an interframe timeout of 6 ms if the polled asynchronous protocol is running at 9600 bps, but set the value to 40 ms if the protocol is running at 300 bps.
This command applies only when the asynchronous-generic protocol has been specified on an interface using a combination of the bstun protocol-group global configuration command and the bstun group interface configuration command.
Interfaces configured to run the asynchronous-generic protocol have their baud rate set to 9600 bps, use 8 data bits, no parity, 1 start bit, and 1 stop bit. If different line configurations are required, use the rxspeed, txspeed, databits, stopbits, and parity line configuration commands to change the line attributes.
The addresses of the alarm panels should be used in the address field of the bstun route address interface configuration command.
Examples
The following example sets the interframe timeout value to 6 ms because the polled asynchronous protocol is running at 9600 bps:
asp rx-ift 6
Related Commands
Configures an asynchronous port to send and receive polled asynchronous traffic through a BSTUN tunnel. Specifies whether the router is acting as the primary end of the polled asynchronous link or as the secondary end of the polled asynchronous link connected to the serial interface, and whether the attached remote device is a security alarm control station. Defines a BSTUN group and the protocol it uses. Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.
Command
Description
To specify the character set used by the Bisync support feature in this serial interface as either EBCDIC or ASCII, use the bsc char-set interface configuration command. Use the no form of this command to cancel the character set specification.
bsc char-set {ascii | ebcdic}
Syntax Description
ascii ASCII character set. ebcdic EBCDIC character set. This character set is the default.
Defaults
EBCDIC
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following command specifies that the ASCII character set will be used:
bsc char-set ascii
To specify an address on a contention interface, use the bsc contention interface configuration command. Use the no form of this command to cancel the specification.
bsc contention address
Syntax Description
address Address assigned to contention interface. The range is 1 to 255. The default is 0x01.
Defaults
The default address is 0x01 to accommodate backward compatibility to the previous point-to-point contention implementation.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following command specifies address 20 on the remote device:
bsc contention 20
Related Commands
Specifies a router at the central site as a central router with dynamic allocation of serial interfaces.
Command
Description
To specify a router at the central site as a central router with dynamic allocation of serial interfaces, use the bsc dial-contention interface configuration command. Use the no form of this command to cancel the specification.
bsc dial-contention time-out
Syntax Description
time-out Amount of time interface can sit idle before it is returned to the idle interface pool. The range is 2 to 30 seconds. The default is 5 seconds.
Defaults
5 seconds
Command Modes
Interface configuration
Command History
11.2 F This command was introduced.
Release
Modification
Usage Guidelines
A timeout value is configurable to ensure that an interface does not get locked out because of a device outage during transmission.
Examples
The following command defines a dial-in interface at the central site with an idle timeout of 10 seconds:
bsc dial-contention 10
Related Commands
Specifies an address on a contention interface.
Command
Description
To detect deactivation of devices at the host, use the bsc host-timeout interface configuration command. Use the no form of this command to cancel the configuration.
bsc host-timeout interval
Syntax Description
interval Timeout interval within which a poll or select for a control unit must be received. If this interval expires, the remote router is sent a teardown peer signal. The range is 30 to 3000 deciseconds. The default is 600 deciseconds (60 seconds).
Defaults
The default interval is 600 deciseconds (60 seconds).
Command Modes
Interface configuration
Command History
11.2 F This command was introduced.
Release
Modification
Usage Guidelines
This command is used to detect deactivation of devices at the host. If the host is told to deactivate or not poll a device it will take time for the signal to propagate the network and get the remote end from polling. The timeout can be used to fine tune the delay in detecting the host outage. The remote peer will stop polling the control unit that has timed out in the interval 1 to 2 times the configured timeout value.
Examples
The following example configures a timeout of 500 deciseconds (50 seconds):
bsc host-timeout 500
Related Commands
Specifies that the router is acting as the secondary end of the Bisync link connected to the serial interface, and the attached remote device is a Bisync control station. Specifies the BSTUN group to which the interface belongs. Defines a BSTUN group and the protocol it uses.
Command
Description
Syntax Description
time Interval in tenths of a second. The default value is 10 (that is, 10 tenths, or 1 second). The maximum time is 255 (25.5 seconds).
Defaults
10
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
The following command sets the interval to 20 tenths (2 seconds):
bsc pause 20
Syntax Description
time Time in tenths of a second. The default value is 10 (that is, 10 tenths, or 1 second).
Defaults
10
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following command sets the interval to 20 tenths (2 seconds):
bsc poll-timeout 20
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
The Bisync support feature in the serial interface uses the address of the incoming encapsulation for reply.
Examples
The following example specifies the router as the primary role:
bsc primary
Related Commands
Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.
Command
Description
Syntax Description
retries Number of retries before a device fails. The default is 5.
Defaults
5 retries
Command Modes
Interface configuration
Command History
11.0 This commands was introduced.
Release
Modification
Examples
The following command sets the retry count to 10:
bsc retries 10
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
The Bisync support feature in this serial interface uses the address of the poll or selection block in the framing encapsulation. It also generates an end of transmission (EOT) frame preceding each Bisync poll and selection.
Examples
The following example specifies the router as the secondary role:
bsc secondary
Related Commands
Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.
Command
Description
To specify the number of cycles of the active poll list that are performed between polls to control units in the inactive poll list, use the bsc servlim interface configuration command. Use the no form of this command to cancel the specification.
bsc servlim servlim-count
Syntax Description
servlim-count Number of cycles. The range is 1 to 50. The default is 3.
Defaults
3 cycles
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following command sets the number of cycles to 2:
bsc servlim 2
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.1 This command was introduced.
Release
Modification
Usage Guidelines
Use the bsc spec-poll command when a router is connected to a host, and only when that host issues specific polls rather than general polls. Tandem hosts that poll ATM cash machines are typically configured to use specific polls rather than general polls.
Configuring a downstream (control-unit/device connected) router to support specific polling has no effect.
Examples
The following commands configure serial interface 0 to use specific poll:
interface serial 0 description Connection to host. encapsulation bstun bstun group 1 bsc secondary bsc spec-poll bsc char-set ebcdic bstun route all tcp 10.10.14.122
To specify the BSTUN group to which the interface belongs, use the bstun group interface configuration command. Use the no form of this command to remove the interface from the BSTUN group.
bstun group group-number
Syntax Description
group-number BSTUN group to which the interface belongs.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
Each BSTUN-enabled interface must be placed in a BSTUN group that was previously defined by the bstun protocol-group command. Packets only travel between BSTUN-enabled interfaces that are in the same group.
Examples
The following example specifies that serial interface 1 belongs to the previously defined protocol group 1:
interface serial 1 encapsulation bstun bstun group 1
Related Commands
Defines a BSTUN group and the protocol it uses. Configures BSTUN on a particular serial interface.
Command
Description
To define the number of times to attempt a peer connection before declaring the peer connection to be down, use the bstun keepalive-count global configuration command. Use the no form of this command to cancel the definition.
bstun keepalive-count count
Syntax Description
count Number of connection attempts. The range is between 2 and 10 retries.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.1 This command was introduced.
Release
Modification
Usage Guidelines
The following example sets the number of times to retry a connection to a peer to 4:
bstun keepalive-count 4
Related Commands
Enables detection of the loss of a peer.
Command
Description
To configure a SAP on which to listen for incoming calls, use the bstun lisnsap global configuration command. Use the no form of this command to cancel the SAP on which to listen.
bstun lisnsap sap-value
Syntax Description
sap-value SAP on which to listen for incoming calls. The default is 04.
Defaults
The default SAP value is 04.
Command Modes
Global configuration
Command History
11.2 F This command was introduced.
Release
Modification
Usage Guidelines
Changes to the bstun lisnsap command configuration will not take effect until after the router has been reloaded.
Examples
The following example configures a SAP for listening:
bstun lisnsap
Related Commands
Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer over Frame Relay. Configures BSTUN over Frame Relay for passthru. frame-relay map llc2 Configures BSTUN over Frame Relay when using Bisync local acknowledgment.
Command
Description
To enable the BSTUN function, use the bstun peer-name global configuration command. Use the no form of this command to disable the function.
bstun peer-name ip-address
Syntax Description
ip-address Address by which this BSTUN peer is known to other BSTUN peers that are using the TCP transport.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
The IP address defines the address by which this BSTUN peer is known to other BSTUN peers that are using the TCP transport. If this command is unconfigured or the no form of this command is specified, all BSTUN routing commands with IP addresses are deleted. BSTUN routing commands without IP addresses are not affected by this command.
Examples
The following example enables the BSTUN function:
bstun peer-name 150.10.254.201
Related Commands
Defines a BSTUN group and the protocol it uses.
Command
Description
To define a BSTUN group and the protocol it uses, use the bstun protocol-group global configuration command. Use the no form of this command to delete the BSTUN group.
bstun protocol-group group-number protocol
Syntax Description
group-number BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. protocol Block serial protocol, selected from the following:
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
Interfaces configured to run the Adplex protocol have their baud rate set to 4800 bps, use even parity, 8 data bits, 1 start bit, and 1 stop bit.
Interfaces configured to run the adt-vari-poll and adt-poll-select protocols have their baud rate set to 600 bps, use even parity, 8 data bits, 1 start bit, and 1.5 stop bits. If different line configurations are required, use the rxspeed, txspeed, databits, stopbits, and parity line configuration commands to change the line attributes.
Interfaces configured to run the asynchronous-generic protocol have their baud rate set to 9600 bps, use no parity, 8 data bits, 1 start bit, and 1 stop bit. If different line configurations are required, use the rxspeed, txspeed, databits, stopbits, and parity line configuration commands to change the line attributes.
Interfaces configured to run the mdi protocol have their baud rate set to 600 bps, use even parity, 8 data bits, 1 start bit, and 1.5 stop bits. If different line configurations are required, use the rxspeed, txspeed, databits, stopbits, and parity line configuration commands to change the line attributes. The mdi protocol allows alarm panels to be sent to the MDI alarm console.
Examples
The following example defines BSTUN group 1, specifies that it uses the Bisync protocol, and indicates that frames will be locally acknowledged:
bstun protocol-group 1 bsc-local-ack
Related Commands
Specifies the BSTUN group to which the interface belongs.
Command
Description
To enable detection of the loss of a peer, use the bstun remote-peer-keepalive global configuration command. Use the no form of this command to disable detection.
bstun remote-peer-keepalive seconds
Syntax Description
seconds Keepalive interval, in seconds. The range is 1 to 300 seconds. The default is 30 seconds.
Defaults
30 seconds
Command Modes
Global configuration
Command History
11.1 This command was introduced.
Release
Modification
Examples
In the following example, the remote-peer-keepalive interval is set to 60 seconds:
bstun remote-peer-keepalive 60
Related Commands
Defines the number of times to attempt a peer connection before declaring the peer connection to be down.
Command
Description
To define how frames will be forwarded from a BSTUN interface to a remote BSTUN peer, use the bstun route interface configuration command. Use the no form of this command to cancel the definition.
bstun route {all | address address-number} {tcp ip-address | interface serial number} [direct]
Syntax Description
all All BSTUN traffic received on the input interface is propagated, regardless of the address contained in the serial frame. address Serial frame that contains a specific address is propagated. address-number Poll address, a hexadecimal number from 01 to FF (but not all values are valid). The reply address to be used on the return leg is calculated from the configured poll address. tcp TCP encapsulation is used to propagate frames that match the entry. ip-address IP address of the remote BSTUN peer. interface serial HDLC encapsulation is used to propagate the serial frames. number Serial line to an appropriately configured router on the other end. direct (Optional) Specified interface is also a direct BSTUN link, rather than a serial connection to another peer.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
When the ADplex protocol is specified in the bstun protocol-group command, ADplex device addresses are limited to the range 1 to 127 because ADplex alarm panels invert the device address in the ADplex frame when responding to alarm console commands.
When the adt-poll-select protocol is specified in the bstun protocol-group command, routes for specific addresses cannot be specified on the downstream router (connected to the alarm panel), because no address field is provided within frames that are sent back to the alarm console. The only way to route traffic back to the alarm console is to use the bstun route all form of the bstun route command. This is also true for the diebold protocol and any other protocol supported by the asynchronous-generic protocol group that does not include a device address in the frame.
When the adt-vari-poll protocol is specified in the bstun protocol-group command, ADT device addresses are limited to the range 0 to 255, and address 0 is reserved for use as a broadcast address for adt-vari-poll only. If address 0 is specified in the bstun route address form of the bstun route command, the address is propagated to all configured BSTUN peers.
It is possible to use both the all and the address keywords on different bstun route commands on the same serial interface. When this is done, the address specifications take precedence; if none of these match, then the all specification is used to propagate the frame.
Examples
In the following example, all BSTUN traffic received on serial interface 0 is propagated, regardless of the address contained in the serial frame:
bstun route all interface serial 0
To define how frames will be forwarded from a BSTUN interface to a remote BSTUN peer over Frame Relay, use the bstun route (Frame Relay) interface configuration command. Use the no form of this command to cancel the definition.
bstun route {all | address cu-address} interface serial number [dlci dlci rsap] [priority priority]
Syntax Description
all All BSTUN traffic received on the input interface is propagated, regardless of the address contained in the serial frame. address Serial frames that contain a specific address are propagated. cu-address Control unit address for the Bisync end station. interface serial number Specify a serial interface on which Frame Relay encapsulation is used to propagate serial frames. dlci dlci (Optional) Data-link connection identifier to be used on the Frame Relay interface. rsap (Optional) Remote SAP, to be used when initiating an LLC2 session. This argument is configurable only if the interface group number supports local acknowledgment. priority priority (Optional) Priority port to be used for this LLC2 session. Configurable only if the interface group number supports local acknowledgment.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.1 This command was introduced.
Release
Modification
Examples
The following example configures BSTUN over Frame Relay. All BSTUN traffic is propagated to serial interface 0 regardless of the address contained in the serial frame:
bstun route all interface serial 0 dlci 16
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Usage Guidelines
The encapsulation bstun command must be configured on an interface before any further BSTUN or Bisync commands are configured for the interface.
You must use this command to enable BSTUN on an interface. Before using this command, complete the following two tasks:
After using the encapsulation bstun command, use the bstun group command to place the interface in the previously defined protocol group.
Examples
The following example configures the BSTUN function on serial interface 0:
interface serial 0 no ip address encapsulation bstun
Related Commands
Specifies the BSTUN group to which the interface belongs. Enables the BSTUN function. Defines a BSTUN group and the protocol it uses.
Command
Description
To enable STUN encapsulation on a specified serial interface, use the encapsulation stun interface configuration command.
encapsulation stunSyntax Description
This command has no arguments or keywords.
Defaults
STUN encapsulation is disabled.
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
Use this command to enable STUN on an interface. Before using this command, complete the following two tasks:
After using the encapsulation stun command, use the stun group command to place the interface in the previously defined protocol group.
To disable stun encapsulation, configure the default interface encapsulation using the encapsulation command and specify hdlc as the encapsulation-type
There is not a no form for this command.
Examples
This partial configuration example shows how to enable serial interface 5 for STUN traffic:
! sample stun peer name and stun protocol-group global commands stun peer-name 131.108.254.6 stun protocol-group 2 sdlc ! interface serial 5 ! sample ip address command no ip address ! enable the interface for STUN; must specify encapsulation stun ! command to further configure the interface encapsulation stun ! place interface serial 5 in previously defined STUN group 2 stun group 2 ! enter stun route command stun route 7 tcp 131.108.254.7
Related Commands
Places each STUN-enabled interface on a router in a previously defined STUN group. Enables STUN for an IP address. Creates a protocol group.
Command
Description
To configure BSTUN over Frame Relay for passthru, use the frame-relay map bstun interface configuration command. Use the no form of this command to cancel the configuration.
frame-relay map bstun dlci
Syntax Description
dlci Frame Relay DLCI number on which to support passthru.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.2 F This command was introduced.
Release
Modification
Examples
The following example maps BSTUN traffic to DLCI number 16:
frame-relay map bstun 16
Related Commands
Configures a SAP on which to listen for incoming calls. Defines a BSTUN group and the protocol it uses. encapsulation frame-relay Enables Frame Relay encapsulation.
Command
Description
To establish BSTUN queuing priorities based on the BSTUN header, use the priority-list protocol bstun global configuration command. Use the no form of this command to revert to normal priorities.
priority-list list-number protocol bstun queue [gt | lt packetsize] [address bstun-group bsc-addr]
Syntax Description
list-number Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. queue Priority queue type: high, medium, normal, or low. gt | lt packetsize (Optional) Output interface examines header information and packet size and places packets with the BSTUN header that match criteria (gt or lt specified packet size) on specified output. address bstun-group bsc-addr (Optional) Output interface examines header information and Bisync address and places packets with the BSTUN header that match Bisync address on the specified output queue.
Defaults
Prioritize based on BSTUN header.
Command Modes
Global configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
In the following example, the output interface examines the header information and places packets with the BSTUN header on the output queue specified as medium.
priority-list 1 protocol bstun medium
Related Commands
Configures BSTUN on a particular serial interface.
Command
Description
To establish BSTUN or STUN queuing priorities based on the TCP port, use the priority-list protocol ip tcp global configuration command. Use the no form of this command to revert to normal priorities.
priority-list list-number protocol ip queue tcp tcp-port-number
Syntax Description
list-number Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. queue Priority queue type: high, medium, normal, or low. The default queue value is normal. tcp-port-number BSTUN port and priority settings are as follows: STUN port and priority settings are as follows:
Defaults
The default queue value is normal.
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
Use the priority-list protocol stun address command first. Priority settings created with this command are assigned to SDLC ports.
 |
Note SDLC local acknowledgment with the priority option must be enabled using the stun route address tcp command. |
Examples
In the following example, queuing priority for address C1 using priority list 1 is set to high. A priority queue of high is assigned to the SDLC port 1994.
priority-list 1 stun high address 1 c1 priority-list 1 protocol ip high tcp 1994
In the following example, queuing priority for address C1 using priority list 1 is set to high. A priority queue of high is assigned to BSTUN port 1976.
priority-list bstun high address 1 c1 priority-list 1 protocol ip high 1976
Related Commands
Defines a BSTUN group and the protocol it uses. Configures BSTUN on a particular serial interface. Enables STUN encapsulation on a specified serial interface. Establishes BSTUN queueing priorities based on the BSTUN header. Establishes STUN queueing priorities based on the address of the serial link. Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN.
Command
Description
Syntax Description
list-number Arbitrary integer between 1 and 16 that identifies the priority list selected by the user. queue Enables a priority queue type: Valid queue values and their equivalent priority queue type level are: The default queue value is normal. group-number Group number that is used in the stun group command. address-number Address of the serial link. For an SDLC link, the format is a 1-byte hexadecimal value (for example, C1). For a non-SDLC link, the address format can be specified by the stun schema command.
Defaults
The default queue value is normal.
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
|
Note SDLC local acknowledgment with the priority option must be enabled using the stun route address interface serial command. |
The priority-list command is described in greater detail in the "Performance Management Commands" chapter in the Cisco IOS Configuration Fundamentals Command Reference.
Examples
In the following example, queuing priority for address C1 using priority list 1 is set to high:
priority-list 1 stun high address 1 c1
Related Commands
Establishes BSTUN or STUN queueing priorities based on the TCP port. Places each STUN-enabled interface on a router in a previously defined STUN group. Forwards all HDLC traffic on a serial interface. Defines a protocol other than SDLC for use with STUN.
Command
Description
To customize BSTUN queuing priorities based on the BSTUN header, use the queue-list protocol bstun global configuration command. Use the no form of this command to revert to normal priorities.
queue-list list-number protocol bstun queue [gt | lt packetsize] [address bstun-group bsc-addr]
Syntax Description
list-number Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. queue Enables a priority queue type: Valid queue-keyword values and their equivalent priority queue type level are: gt | lt packetsize (Optional) Output interface examines header information and packet size and places packets with the BSTUN header that match criteria (gt or lt specified packet size) on specified output. address bstun-group bsc-addr (Optional) Output interface examines header information and Bisync address and places packets with the BSTUN header that match Bisync address on the specified output queue.
Defaults
Prioritize based on BSTUN header.
Command Modes
Global configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
In the following example, the output interface examines the header information and places packets with the BSTUN header on the output queue specified as medium.
queue-list 1 protocol bstun medium
Related Commands
Configures BSTUN on a particular serial interface.
Command
Description
To customize BSTUN queuing priorities based on the TCP port, use the queue-list protocol ip tcp global configuration command. Use the no form of this command to revert to normal priorities.
queue-list list-number protocol ip queue tcp tcp-port-number
Syntax Description
list-number Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. queue Enables a priority queue type: Valid queue-keyword values and their equivalent priority queue type level are: The default queue value is normal. tcp-port-number BSTUN port and priority settings are as follows: STUN port and priority settings are as follows:
Defaults
The default queue value is normal.
Command Modes
Global configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
In the following example, queuing priority for address C1 using priority list 1 is set to high. A priority queue of high is assigned to BSTUN port 1976.
queue-list bstun high address 1 c1 queue-list 1 protocol ip high 1976
Related Commands
Configures BSTUN on a particular serial interface.
Command
Description
To allow SDLC broadcast address FF to be replicated for each of the STUN peers, so each of the end stations receive the broadcast frame, use the sdlc virtual-multidrop interface configuration command. Use the no form of this command to disable the SDLC broadcast feature.
sdlc virtual-multidropSyntax Description
This command has no arguments or keywords.
Defaults
SDLC broadcast is disabled.
Command Modes
Interface configuration
Command History
10.3 This command was introduced.
Release
Modification
Examples
The following example allows each STUN peer to receive a broadcast frame:
sdlc virtual-multidrop
Related Commands
Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN.
Command
Description
To display statistics about the interfaces on which Bisync is configured, use the show bsc privileged EXEC command.
show bsc [group bstun-group-number] [address address-list]
Syntax Description
group bstun-group-number (Optional) BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. address address-list (Optional) List of poll addresses.
Command Modes
Privileged EXEC
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following is sample output from the show bsc command:
Router# show bsc BSC pass-through on Serial4: HDX enforcement state: IDLE. Frame sequencing state: IDLE. Total Tx Counts: 0 frames(total). 0 frames(data). 0 bytes. Total Rx Counts: 0 frames(total). 0 frames(data). 0 bytes. BSC local-ack on serial5: Secondary state is CU_Idle. Control units on this interface: Poll address: C2. Select address: E2. State is Active. Tx Counts: 1137 frames(total). 0 frames(data). 1137 bytes. Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes. Poll address: C3. Select address: E3 *CURRENT-CU* State is Active. Tx Counts: 1136 frames(total). 0 frames(data). 1136 bytes. Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes. Total Tx Counts: 2273 frames(total). 0 frames(data). 2273 bytes. Total Rx Counts: 2284 frames(total). 0 frames(data). 11420 bytes.
The following is sample output from the show bsc command specifying BSTUN group 50:
Router# show bsc group 50 BSC local-ack on serial5: Secondary state is CU_Idle. Control units on this interface: Poll address: C2. Select address: E2. State is Active. Tx Counts: 1217 frames(total). 0 frames(data). 1217 bytes. Rx Counts: 1222 frames(total). 0 frames(data). 6110 bytes. Poll address: C3. Select address: E3 *CURRENT-CU* State is Active. Tx Counts: 1214 frames(total). 0 frames(data). 1214 bytes. Rx Counts: 1220 frames(total). 0 frames(data). 6100 bytes. Total Tx Counts: 2431 frames(total). 0 frames(data). 2431 bytes. Total Rx Counts: 2442 frames(total). 0 frames(data). 12200 bytes.
The following is sample output from the show bsc command specifying BSTUN group 50 and poll address C2:
Router# show bsc group 50 address C2 BSC local-ack on serial5: Secondary state is CU_Idle. Control units on this interface: Poll address: C2. Select address: E2. State is Active. Tx Counts: 1217 frames(total). 0 frames(data). 1217 bytes. Rx Counts: 1222 frames(total). 0 frames(data). 6110 bytes. Total Tx Counts: 1217 frames(total). 0 frames(data). 1217 bytes. Total Rx Counts: 1222 frames(total). 0 frames(data). 6110 bytes.
The following is sample output from the show bsc command specifying poll address C2:
Router# show bsc address C2 BSC pass-through on Serial4: HDX enforcement state: IDLE. Frame sequencing state: IDLE. Total Tx Counts: 0 frames(total). 0 frames(data). 0 bytes. Total Rx Counts: 0 frames(total). 0 frames(data). 0 bytes. BSC local-ack on serial5: Secondary state is CU_Idle. Control units on this interface: Poll address: C2. Select address: E2. State is Active. Tx Counts: 1137 frames(total). 0 frames(data). 1137 bytes. Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes. Total Tx Counts: 1137 frames(total). 0 frames(data). 1137 bytes. Total Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes.
Table 34 describes significant fields shown in the display.
.
| Field | Description |
|---|---|
BSC x on interface y | Indicates whether the router is configured for passthru or local acknowledgment on the indicated interface. |
Output queue depth | Packets queued on this interface. This field is only displayed when the value is not zero. |
Frame builder state | Current frame building state. This field is only displayed when the state is not IDLE. |
HDX enforcement state | Current half-duplex transmit enforcement state. The possible values are:
|
Frame sequencing state | Frame sequencing state to protect against network latencies. When the router is configured as the primary end of the link, the possible values are:
When the router is configured as the secondary end of the link, the possible values are:
When the router is configured for point-to-point contention, the possible values are:
|
Total Tx Counts | Total transmit frame count for the indicated interface. |
Total Rx Count | Total receive frame count for the indicated interface. |
Primary state is | The current state when the router is configured as the primary end of the link. The possible values are:
|
Secondary state is | The current state when the router is configured as the secondary end of the link. The possible values are:
|
Poll address | Address used when the host wants to get device information. |
Select address | Address used when the host wants to send data to the device. |
State is | Current initialization state of this control unit. The possible values are:
|
Tx Counts | Transmit frame count for this control unit. |
Rx Counts | Receive frame count for this control unit. |
Total Tx Counts | Total transmit frame count for the indicated interface. |
Total Rx Counts | Total receive frame count for the indicated interface. |
To display the current status of STUN connections, use the show bstun privileged EXEC command.
show bstun [group bstun-group-number] [address address-list]
Syntax Description
group bstun-group-number (Optional) BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. address address-list (Optional) List of poll addresses.
Command Modes
Privileged EXEC
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following is sample output from the show bstun command with no options:
Router# show bstun This peer: 22.22.1.107 *Serial0 (group 1 [bsc]) route transport address state rx_pkts tx_pkts drops all TCP 22.22.1.108 closed 0 0 0 Serial4 (group 3 [bsc]) route transport address state rx_pkts tx_pkts drops C2 TCP 22.22.2.108 closed 0 0 0 C1 TCP 22.22.2.108 closed 0 0 0 40 TCP 22.22.1.108 closed 0 0 0 Serial5 (group 50 [bsc]) route transport address state rx_pkts tx_pkts drops C2 TCP 22.22.2.108 open 4 4 0 C3 TCP 22.22.2.108 open 3 3 0
The following is sample output from the show bstun command specifying BSTUN group 3:
Router# show bstun group 3 This peer: 22.22.1.107 Serial4 (group 3 [bsc]) route transport address state rx_pkts tx_pkts drops C2 TCP 22.22.2.108 closed 0 0 0 C1 TCP 22.22.2.108 closed 0 0 0 40 TCP 22.22.1.108 closed 0 0 0
The following is sample output from the show bstun command specifying BSTUN group 3 and poll address C1:
Router# show bstun group 3 address C1 This peer: 22.22.1.107 Serial4 (group 3 [bsc]) route transport address state rx_pkts tx_pkts drops C1 TCP 22.22.2.108 closed 0 0 0
The following is sample output from the show bstun command specifying poll address C2:
Router# show bstun address C2 This peer: 22.22.1.107 Serial4 (group 3 [bsc]) route transport address state rx_pkts tx_pkts drops C2 TCP 22.22.2.108 closed 0 0 0 Serial5 (group 50 [bsc]) route transport address state rx_pkts tx_pkts drops C2 TCP 22.22.2.108 open 4 4 0
Table 35 describes significant fields shown in the output.
| Field | Description |
|---|---|
This peer | Lists the peer name or address. The interface name (as defined by the description command), its BSTUN group number, and the protocol associated with the group are shown on the next header line. |
route | Bisync control unit address. |
transport | Description of link, either a serial interface using serial transport (indicated by IF followed by interface name), or a TCP connection to a remote router (TCP followed by IP address). |
address | Address or the word all if the default forwarding entry is specified, followed by a repeat of the group number given for the interface. |
state | State of the link: open is the normal, working state; direct indicates a direct link to another line, as specified with the direct keyword on the bstun route command. |
rx_pkts | Number of received packets. |
tx_pkts | Number of transmitted packets. |
drops | Number of packets that had to be dropped for whatever reason. |
To display the current status of STUN connections, use the show stun privileged EXEC command.
show stunSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
10.0 This command was introduced.
Release
Modification
Examples
The following is sample output from the show stun command:
Router# show stun
This peer: 131.108.10.1
Serial0 -- 3174 Controller for test lab (group 1 [sdlc])
state rx-pkts tx-pkts drops poll
7[ 1] IF Serial1 open 20334 86440 5 8P
10[1] TCP 131.108.8.1 open 6771 7331 0
all[1] TCP 131.108.8.1 open 612301 2338550 1005
In the display, the first entry reports proxy polling is enabled for address 7 and serial 0 is running with modulus 8 on the primary side of the link. The link has received 20,334 packets, transmitted 86,440 packets, and dropped 5 packets.
Table 36 describes significant fields shown in the output.
.
| Field | Description |
|---|---|
This peer | Lists the peer name or address. The interface name (as defined by the description command), its STUN group number, and the protocol associated with the group are shown on the header line. |
STUN address | Address or the word all if the default forwarding entry is specified, followed by a repeat of the group number given for the interface. |
Type of link | Description of link, either a serial interface using serial transport (indicated by IF followed by interface name), or a TCP connection to a remote router (TCP followed by IP address). |
state | State of the link: open is the normal, working state; direct indicates a direct link to another line, as specified with the direct keyword on the stun route command. |
rx_pkts | Number of received packets. |
tx_pkts | Number of transmitted packets. |
drops | Number of packets that for whatever reason had to be dropped. |
poll | Report of the proxy poll parameters, if any. P indicates a primary and S indicates a secondary node. The number before the letter is the modulus of the link. |
To place each STUN-enabled interface on a router in a previously defined STUN group, use the stun group interface configuration command. Use the no form of this command to remove an interface from a group.
stun group group-number
Syntax Description
group-number Integer in the range 1 to 255.
Defaults
Disabled
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
Before using this command, complete the following steps:
Step 2 Define the protocol group in which you want to place this interface with the stun protocol-group command.
Step 3 Enable STUN on the interface using the encapsulation stun command.
Packets only travel between STUN-enabled interfaces that are in the same group. Once a given serial link is configured for the STUN function, it is no longer a shared multiprotocol link. All traffic that arrives on the link is transported to the corresponding peer as determined by the current STUN configuration.
Examples
The following example places serial interface 0 in STUN group 2, which is defined to run the SDLC transport:
! sample stun peer-name global command stun peer-name 131.108.254.6 ! sample protocol-group command telling group 2 to use the SDLC protocol stun protocol-group 2 sdlc ! interface serial 0 ! sample ip address subcommand no ip address ! sample encapsulation stun subcommand encapsulation stun ! place interface serial0 in previously defined STUN group 2 stun group 2 ! enter stun route command stun route 7 tcp 131.108.254.7
Related Commands
Enables STUN encapsulation on a specified serial interface. Establishes STUN queueing priorities based on the address of the serial link. Enables STUN for an IP address. Creates a protocol group.
Command
Description
To define the number of times to attempt a peer connection before declaring the peer connection to be down, use the stun keepalive-count global configuration command. Use the no form of this command to cancel the definition.
stun keepalive-count count
Syntax Description
count Number of connection attempts. The range is between 2 and 10 retries.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Examples
The following example sets the number of times to retry a connection to a peer to 4:
stun keepalive-count 4
Related Commands
Enables detection of the loss of a peer.
Command
Description
To enable STUN for an IP address, use the stun peer-name global configuration command. Use the no form of this command to disable STUN for an IP address.
stun peer-name ip-address cls
Syntax Description
ip-address IP address by which this STUN peer is known to other STUN peers. cls Use Cisco Link Services (CLS) to access the frame relay network.
Defaults
STUN is disabled.
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
Use this command to enable any further STUN features. After using this command, complete the following steps:
Step 2 Enable STUN on the interface using the encapsulation stun command.
Step 3 Place the interface in a STUN group with the stun group command.
Examples
The following example assigns IP address 131.108.254.6 as the STUN peer:
stun peer-name 131.108.254.6 cls
Related Commands
Enables STUN encapsulation on a specified serial interface. Places each STUN-enabled interface on a router in a previously defined STUN group. Creates a protocol group.
Command
Description
Syntax Description
group-number Integer in the range 1 to 255. basic Indicates a non-SDLC protocol. sdlc Indicates an SDLC protocol. sdlc-tg (Optional) Identifies the group as part of an SNA transmission group. schema Indicates a custom protocol.
Defaults
No protocol group established.
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
Use the sdlc keyword to specify an SDLC protocol. You must specify either the sdlc or the sdlc-tg keyword before you can enable SDLC local acknowledgment. SDLC local acknowledgment is established with the stun route address tcp command.
Use the basic keyword to specify a non-SDLC protocol, such as HDLC.
Use the schema keyword to specify a custom protocol. The custom protocol must have been previously created with the stun schema command.
Use the optional sdlc-tg keyword, in conjunction with the sdlc keyword, to establish an SNA transmission group. A transmission group is a set of protocol groups providing parallel links to the same pair of IBM establishment controllers. This provides redundancy of paths. In case one or more links go down, an alternate path will be used. All STUN connections in a transmission group must connect to the same IP address. SDLC local acknowledgment must be enabled.
|
Note If you specify the keyword sdlc in the stun protocol group command string, you cannot specify the stun route all command on that interface. |
Examples
The following example specifies that group 7 will use the SDLC STUN protocol to route frames within that group:
stun protocol-group 7 sdlc
The following example specifies that group 5 use the basic protocol, wherein the serial addressing is unimportant and you have a point-to-point link:
stun protocol-group 5 basic
Related Commands
Enables STUN encapsulation on a specified serial interface. Forwards all HDLC traffic on a serial interface. Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN. Defines a protocol other than SDLC for use with STUN.
Command
Description
To enable STUN quick-response, which can be used with local acknowledgment, use the stun quick-response global configuration command. Use the no form of this command to disable STUN quick-response.
stun quick-responseSyntax Description
This command has no arguments or keywords.
Defaults
STUN quick-response is disabled.
Command Modes
Global configuration
Command History
10.3(5) This command was introduced.
Release
Modification
Usage Guidelines
This command is used with local acknowledgment (local ack).
When STUN quick-response is enabled, the router responds to an exchange identification (XID) or a Set Normal Response Mode (SNRM) request with a Disconnect Mode (DM) response when the device is not in the CONNECT state. The request is then passed to the remote router and, if the device responds, the reply is cached. The next time the device is sent an XID or SNRM, the router replies with the cached DM response.
|
Note Using STUN quick-response avoids an AS/400 line reset problem by eliminating the Non-Productive Receive Timer (NPR) expiration in the AS/400. With quick-response enabled, the AS/400 receives a response from the polled device, even when the device is down. If the device does not respond to the forwarded request, the router continues to respond with the cached DM response. |
Examples
The following example enables STUN quick-response:
stun quick-response
Related Commands
Configures direct Frame Relay encapsulation between STUN peers with SDLC local acknowledgment. Forwards all HDLC traffic on a serial interface. Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN. Encapsulates and forwards all STUN traffic using HDLC encapsulation on a serial interface. Used with TCP encapsulation, forwards all STUN traffic on an interface regardless of which address is contained in the serial frame.
Command
Description
To enable detection of the loss of a peer, use the stun remote-peer-keepalive global configuration command. Use the no form of this command to disable detection.
stun remote-peer-keepalive seconds
Syntax Description
seconds Keepalive interval, in seconds. The range is 1 to 300 seconds. The default is 30 seconds.
Defaults
30 seconds
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Examples
In the following example, the remote-peer-keepalive interval is set to 60 seconds:
stun remote-peer-keepalive 60
Related Commands
Defines the number of times to attempt a peer connection before declaring the peer connection to be down.
Command
Description
To configure direct Frame Relay encapsulation between STUN peers with SDLC local acknowledgment, use the stun route address interface dlci interface configuration command. Use the no form of this command to disable the configuration.
stun route address sdlc-addr interface frame-relay-port dlci number localsap local-ack cls
Syntax Description
sdlc-addr Address of the serial interface. frame-relay-port Port number. number Data-link connection identifier (DLCI) number. localsap Local connecting SAP. local-ack Enable local acknowledgment. cls Use Cisco Link Services (CLS) to access the Frame Relay network.
Defaults
The configuration is disabled.
Command Modes
Interface configuration
Command History
11.0 This command was introduced.
Release
Modification
Examples
The following command enables Frame Relay encapsulation between STUN peers with SDLC local acknowledgment:
stun route address c1 interface serial1 dlci 22 04 local-ack
Related Commands
Encapsulates and forwards all STUN traffic using HDLC encapsulation on a serial interface.
Command
Description
To forward all HDLC traffic on a serial interface, use the stun route address interface serial interface configuration command. Use the no form of this command to disable this method of HDLC encapsulation.
stun route address address-number interface serial number [direct]
Syntax Description
address-number Address of the serial interface. number Number assigned to the serial interface. direct (Optional) Forwards all HDLC traffic on a direct STUN link.
Defaults
The configuration is disabled.
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Examples
In the following example, serial frames with a STUN route address of 4 are forwarded through serial interface 0 using HDLC encapsulation:
stun route address 4 interface serial 0
In the following example, serial frames with STUN route address 4 are propagated through serial interface 0 using STUN encapsulation:
stun route address 4 interface serial 0 direct
Related Commands
Encapsulates and forwards all STUN traffic using HDLC encapsulation on a serial interface.
Command
Description
To specify TCP encapsulation and optionally establish SDLC local acknowledgment (SDLC transport) for STUN, use the stun route address tcp interface configuration command. Use the no form of this command to disable this method of TCP encapsulation.
stun route address address-number tcp ip-address [local-ack] [priority] [tcp-queue-max]
Syntax Description
address-number Number that conforms to SDLC addressing conventions. ip-address IP address by which this STUN peer is known to other STUN peers that are using the TCP as the STUN encapsulation. local-ack (Optional) Enables local acknowledgment for STUN. priority (Optional) Establishes the four levels used in priority queuing: low, medium, normal, and high. tcp-queue-max (Optional) Sets the maximum size of the outbound TCP queue for the SDLC link. The default is 100.
Defaults
TCP encapsulation is not established; TCP queue size default is 100.
Command Modes
Interface configuration
Command History
10.0 This command was introduced. 11.1 The tcp-queue-max keyword was added.
Release
Modification
Usage Guidelines
SDLC transport participates in SDLC windowing and retransmission through support of local acknowledgment. SDLC sessions require that end nodes send acknowledgments for a set amount of data frames received before allowing further data to be transmitted. Local acknowledgment provides local termination of the SDLC session, so that control frames no longer travel the WAN backbone networks. This means end nodes do not time out, and a loss of sessions does not occur.
Examples
In the following example, a frame with a source-route address of 10 is propagated using TCP encapsulation to a device with an IP address of 131.108.8.1:
stun route address 10 tcp 131.108.8.1
Related Commands
sdlc address ff ack-mode Configures the IBM reserved address FF as a valid local address. Used with TCP encapsulation, forwards all STUN traffic on an interface regardless of which address is contained in the serial frame.
Command
Description
To encapsulate and forward all STUN traffic using HDLC encapsulation on a serial interface, use the stun route all interface serial interface configuration command. Use the no form of this command to disable this method of encapsulation.
stun route all interface serial number [direct]
Syntax Description
number Number assigned to the serial interface. direct (Optional) Indicates that the specified interface is also a direct STUN link, rather than a serial connection to another peer.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
An appropriately configured router must exist on the other end of the designated serial line. The outgoing serial link still can be used for other kinds of traffic (the frame is not TCP encapsulated). This mode is used when TCP/IP encapsulation is not needed or when higher performance is required. Enter the serial line number connected to the router for the interface-number argument.
Examples
In the following example, all traffic on serial interface 0 is propagated using STUN encapsulation:
stun route all interface serial 0
In the following example, serial interface 1 is a direct STUN link, not a serial connection to another peer:
stun route all interface serial 1 direct
Related Commands
Forwards all HDLC traffic on a serial interface.
Command
Description
To forward all STUN traffic on an interface regardless of what address is contained in the serial frame, use the stun route all tcp interface configuration command with TCP encapsulation. Use the no form of this command to disable traffic from being forwarded with this method of encapsulation.
stun route all tcp ip-address
Syntax Description
ip-address IP address by which this remote STUN peer is known to other STUN peers. Use the address that identifies the remote STUN peer that is connected to the remote serial link.
Defaults
Disabled
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
TCP/IP encapsulation allows movement of serial frames across arbitrary media types and topologies. This is particularly useful for building shared, multiprotocol enterprise network backbones.
Examples
In the following example, all STUN traffic received will be propagated through the bridge:
stun route all tcp 131.108.10.1
To define a protocol other than SDLC for use with STUN, use the stun schema offset length format global configuration command. Use the no form of this command to disable the new protocol.
stun schema name offset constant-offset length address-length format format-keyword
Syntax Description
name Name that defines your protocol. It can be up to 20 characters in length. constant-offset Constant offset, in bytes, for the address to be found in the frame. address-length Length in one of the following formats: decimal (4 bytes), hexadecimal (8 bytes), or octal (4 bytes). format-keyword Identifies format to be used to specify and display addresses for routes on interfaces that use this STUN protocol. Valid format keyword values and their ranges are:
Defaults
No protocol is defined.
Command Modes
Global configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
Use this command before defining the protocol group (stun protocol-group command). The serial protocol you define must meet the following criteria:
Examples
In the following example, a protocol named new-sdlc is created. In the protocol frame structure, the constant offset is 0, the address length is 1 byte, and the address format is hexadecimal.
stun schema new-sdlc offset 0 length 1 format hexadecimal
Related Commands
Establishes STUN queueing priorities based on the address of the serial link. Creates a protocol group.
Command
Description
To assign the router the role of SDLC primary node, use the stun sdlc-role primary interface configuration command. Primary nodes poll secondary nodes in a predetermined order. Use the no form of this command to disable the primary node role assignment.
stun sdlc-role primarySyntax Description
This command has no arguments or keywords.
Defaults
No role is assigned.
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
If the router is connected to a cluster controller, for example a 3x74, it should appear as a front-end processor (FEP) such as a 37x5, and must be assigned the role of a primary node.
Examples
The following example assigns the router the role of SDLC primary node:
stun sdlc-role primary
Related Commands
Enables STUN encapsulation on a specified serial interface. Assigns the router the role of SDLC secondary node. Secondary nodes respond to polls sent by the SDLC primary by sending any outgoing data they may have.
Command
Description
To assign the router the role of SDLC secondary node, use the stun sdlc-role secondary interface configuration command. Secondary nodes respond to polls sent by the SDLC primary by transmitting any outgoing data they may have. Use the no form of this command to disable the
stun sdlc-role secondarySyntax Description
This command has no arguments or keywords.
Defaults
No secondary role is assigned.
Command Modes
Interface configuration
Command History
10.0 This command was introduced.
Release
Modification
Usage Guidelines
If the router is connected to a front-end processor, for example a 37x5, it should appear as a cluster controller such as a 3x74, and must be assigned the role of a secondary node.
Examples
The following example assigns the router the role of SDLC secondary node:
stun sdlc-role secondary
Related Commands
Enables STUN encapsulation on a specified serial interface. Assigns the router the role of SDLC primary node. Primary nodes poll secondary nodes in a predetermined order.
Command
Description
Posted: Wed Aug 23 13:10:53 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.