Serial Tunnel and Block Serial Tunnel Commands

Syntax Description

address-offset

Location of the address byte within the polled asynchronous frame being received.

Defaults

No default is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.2 F	This command was introduced.

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

Command	Description
asp role	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.
asp rx-ift	Specifies a time period that, by expiring, signals the end of one frame being received and the start of the next.
bstun protocol-group	Defines a BSTUN group and the protocol it uses.
bstun route	Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.

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 is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.2 F	This command was introduced.

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

Command	Description
bstun route	Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.

Syntax Description

interframe-timeout

Number of milliseconds between the end of one frame being received and the start of the next frame.

Defaults

The default timeout value is 40 ms.

Command Modes

Interface configuration

Command History

Release	Modification
11.2 F	This command was introduced.

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

Command	Description
asp addr-offset	Configures an asynchronous port to send and receive polled asynchronous traffic through a BSTUN tunnel.
asp role	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.
bstun protocol-group	Defines a BSTUN group and the protocol it uses.
bstun route	Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.

Syntax Description

ascii	ASCII character set.
ebcdic	EBCDIC character set.

Defaults

EBCDIC

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following command specifies that the ASCII character set will be used:

bsc char-set ascii

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

Release	Modification
11.0	This command was introduced.

Examples

The following command specifies address 20 on the remote device:

bsc contention 20

Related Commands

Command	Description
bsc dial-contention	Specifies a router at the central site as a central router with dynamic allocation of serial interfaces.

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

Release	Modification
11.2 F	This command was introduced.

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

Command	Description
bsc contention	Specifies an address on a contention interface.

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 60 seconds.

Defaults

The default interval is 60 seconds.

Command Modes

Interface configuration

Command History

Release	Modification
11.2 F	This command was introduced.

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 50 seconds:

bsc host-timeout 500

Related Commands

Command	Description
bsc secondary	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.
bstun group	Specifies the BSTUN group to which the interface belongs.
bstun protocol-group	Defines a BSTUN group and the protocol it uses.

Syntax Description

time	Interval in tenths of a second. The default value is 10 (1 second). The maximum time is 25.5 seconds.

Defaults

10 (1 second)

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

The following command sets the interval to 2 seconds:

bsc pause 20

Syntax Description

time	Time in tenths of a second. The default value is 10 (1 second).

Defaults

10 (1 second)

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following command sets the interval to 2 seconds:

bsc poll-timeout 20

Syntax Description

This command has no arguments or keywords.

Defaults

No default is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

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

Command	Description
bstun route	Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.

Syntax Description

retries

Number of retries before a device fails. The default is 5.

Defaults

5 retries

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This commands was introduced.

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 is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

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

Command	Description
bstun route	Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer.

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

Release	Modification
11.0	This command was introduced.

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 is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

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

Syntax Description

group-number

BSTUN group to which the interface belongs.

Defaults

No default is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

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

Command	Description
bstun protocol-group	Defines a BSTUN group and the protocol it uses.
encapsulation bstun	Configures BSTUN on a particular serial interface.

Syntax Description

count

Number of connection attempts. The range is between 2 and 10 retries.

Defaults

No default is specified.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

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

Command	Description
bstun remote-peer-keepalive	Enables detection of the loss of a peer.

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

Release	Modification
11.2 F	This command was introduced.

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

Command	Description
bstun route (Frame Relay)	Defines how frames will be forwarded from a BSTUN interface to a remote BSTUN peer over Frame Relay.
frame-relay map bstun	Configures BSTUN over Frame Relay for passthru.
frame-relay map llc2	Maps LLC2 traffic to a DLCI.

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 is specified.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

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

Command	Description
bstun protocol-group	Defines a BSTUN group and the protocol it uses.

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: adplex adt-poll-select adt-vari-poll async-generic bsc bsc-local-ack diebold mdi

Defaults

No defaults are specified.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

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

Command	Description
bstun group	Specifies the BSTUN group to which the interface belongs.

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 defaults are specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

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

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	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 defaults are specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

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 is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

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:

• Enable BSTUN on a global basis by identifying BSTUN on IP addresses. The command is bstun peer-name.

• Define a protocol group number to be applied to the interface. Packets only travel between interfaces that are in the same protocol group. The command is bstun protocol-group.

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

Command	Description
bstun group	Specifies the BSTUN group to which the interface belongs.
bstun peer-name	Enables the BSTUN function.
bstun protocol-group	Defines a BSTUN group and the protocol it uses.

Syntax Description

This command has no arguments or keywords.

Defaults

STUN encapsulation is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Use this command to enable STUN on an interface. Before using this command, complete the following two tasks:

• Enable STUN on a global basis by identifying STUN on IP addresses. The command is stun peer-name.

• Define a protocol group number to be applied to the interface. Packets only travel between interfaces that are in the same protocol group. The command is stun protocol-group.

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.

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

Command	Description
stun group	Places each STUN-enabled interface on a router in a previously defined STUN group.
stun peer-name	Enables STUN for an IP address.
stun protocol-group	Creates a protocol group.

Syntax Description

dlci	Frame Relay DLCI number on which to support passthru.

Defaults

No default is specified.

Command Modes

Interface configuration

Command History

Release	Modification
11.2 F	This command was introduced.

Examples

The following example maps BSTUN traffic to DLCI number 16:

frame-relay map bstun 16

Related Commands

Command	Description
bstun lisnsap	Configures a SAP on which to listen for incoming calls.
bstun protocol-group	Defines a BSTUN group and the protocol it uses.
encapsulation frame-relay	Enables Frame Relay encapsulation.

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

Release	Modification
11.0	This command was introduced.

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

Command	Description
encapsulation bstun	Configures BSTUN on a particular serial interface.

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.
tcp-port-number	BSTUN port and priority settings are as follows: High—BSTUN port 1976 Medium—BSTUN port 1977 Normal—BSTUN port 1978 Low—BSTUN port 1979 STUN port and priority settings are as follows: High—STUN port 1994 Medium—STUN port 1990 Normal—STUN port 1991 Low—STUN port 1992

Defaults

The default is normal queue.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

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

Command	Description
bstun protocol-group	Defines a BSTUN group and the protocol it uses.
encapsulation bstun	Configures BSTUN on a particular serial interface.
encapsulation stun	Enables STUN encapsulation on a specified serial interface.
priority-list protocol bstun	Establishes BSTUN queueing priorities based on the BSTUN header.
priority-list protocol stun address	Establishes STUN queueing priorities based on the address of the serial link.
stun route address tcp	Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN.

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: high—Priority queue type is high. medium—Priority queue type is medium. normal—Priority queue type is normal. low—Priority queue type is low.
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 hex value (for example, C1). For a non-SDLC link, the address format can be specified by the stun schema command.

Defaults

The default is normal queue.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

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 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

Command	Description
priority-list protocol ip tcp	Establishes BSTUN or STUN queueing priorities based on the TCP port.
stun group	Places each STUN-enabled interface on a router in a previously defined STUN group.
stun route address interface serial	Forwards all HDLC traffic on a serial interface.
stun schema offset length format	Defines a protocol other than SDLC for use with STUN.

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: high—Priority queue type is high. medium—Priority queue type is medium. normal—Priority queue type is normal. low—Priority queue type is 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

Release	Modification
11.0	This command was introduced.

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

Command	Description
encapsulation bstun	Configures BSTUN on a particular serial interface.

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: high—Priority queue type is high. medium—Priority queue type is medium. normal—Priority queue type is normal. low—Priority queue type is low.
tcp-port-number	BSTUN port and priority settings are as follows: High—BSTUN port 1976 Medium—BSTUN port 1977 Normal—BSTUN port 1978 Low—BSTUN port 1979 STUN port and priority settings are as follows: High—STUN port 1994 Medium—STUN port 1990 Normal—STUN port 1991 Low—STUN port 1992

Defaults

The default is normal queue.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

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

Command	Description
encapsulation bstun	Configures BSTUN on a particular serial interface.

Syntax Description

This command has no arguments or keywords.

Defaults

SDLC broadcast is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
10.3	This command was introduced.

Examples

The following example allows each STUN peer to receive a broadcast frame:

sdlc virtual-multidrop

Related Commands

Command	Description
stun route address tcp	Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN.

Syntax Description

bstun-group-number	(Optional) BSTUN group number. Valid numbers are decimal integers in the range 1 to 255.
address-list	(Optional) List of poll addresses.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0	This command was introduced.

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.
 

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

Release	Modification
11.0	This command was introduced.

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
 

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.0	This command was introduced.

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.

Syntax Description

group-number

Integer in the range 1 to 255.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Before using this command, complete the following steps:

Syntax Description

count

Number of connection attempts. The range is between 2 and 10 retries.

Defaults

No default is specified.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Examples

The following example sets the number of times to retry a connection to a peer to 4:

stun keepalive-count 4

Related Commands

Command	Description
stun remote-peer-keepalive	Enables detection of the loss of a peer.

Syntax Description

ip-address

IP address by which this STUN peer is known to other STUN peers.

Defaults

STUN is disabled.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Use this command to enable any further STUN features. After using this command, complete the following steps:

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

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Syntax Description

This command has no arguments or keywords.

Defaults

STUN quick-response is disabled.

Command Modes

Global configuration

Command History

Release	Modification
10.3(5)	This command was introduced.

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

Command	Description
stun route address interface dlci	Configures direct Frame Relay encapsulation between STUN peers with SDLC local acknowledgment.
stun route address interface serial	Forwards all HDLC traffic on a serial interface.
stun route address tcp	Specifies TCP encapsulation and optionally establishes SDLC local acknowledgment (SDLC transport) for STUN.
stun route all interface serial	Encapsulates and forwards all STUN traffic using HDLC encapsulation on a serial interface.
stun route all tcp	Used with TCP encapsulation, forwards all STUN traffic on an interface regardless of which address is contained in the serial frame.

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

Release	Modification
10.0	This command was introduced.

Examples

In the following example, the remote-peer-keepalive interval is set to 60 seconds:

stun remote-peer-keepalive 60

Related Commands

Command	Description
stun keepalive-count	Defines the number of times to attempt a peer connection before declaring the peer connection to be down.

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

Release	Modification
11.0	This command was introduced.

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

Command	Description
stun route all interface serial	Encapsulates and forwards all STUN traffic using HDLC encapsulation on a serial interface.

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

Release	Modification
10.0	This command was introduced.

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

Command	Description
stun route all interface serial	Encapsulates and forwards all STUN traffic using HDLC encapsulation on a serial interface.

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.

Defaults

TCP encapsulation is not established; TCP queue size default is 100.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.
11.1	The tcp-queue-max keyword was added.

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

Command	Description
sdlc address ff ack-mode	Configures the IBM reserved address FF as a valid local address.
stun route all tcp	Used with TCP encapsulation, forwards all STUN traffic on an interface regardless of which address is contained in the serial frame.

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 is specified.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

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

Command	Description
stun route address interface serial	Forwards all HDLC traffic on a serial interface.

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

Release	Modification
10.0	This command was introduced.

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

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	The allowable format keywords are decimal (0 to 9), hexadecimal (0 to F), and octal (0 to  7). 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: decimal—0 to 9 hexadecimal—0 to F octal—0 to 7

Defaults

No protocol is defined.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Syntax Description

This command has no arguments or keywords.

Defaults

No role is assigned.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

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

Command	Description
encapsulation stun	Enables STUN encapsulation on a specified serial interface.
stun sdlc-role secondary	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.