cc/td/doc/product/software/ios121/121sup/121csum2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Serial Tunnel and Block Serial Tunnel Commands

Serial Tunnel and Block Serial Tunnel Commands

This chapter explains the function and syntax of the serial tunnel and block serial tunnel commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Bridging and IBM Networking Command Reference, Volume 1, Release 12.1.

asp addr-offset

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

no asp addr-offset

Syntax Description

address-offset

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

asp role

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}

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

asp rx-ift

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

no asp rx-ift

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.

bsc char-set

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}

no bsc char-set {ascii | ebcdic}

Syntax Description

ascii

ASCII character set.

ebcdic

EBCDIC character set. This character set is the default.

bsc contention

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

no bsc contention

Syntax Description

address

Address assigned to contention interface. The range is 1 to 255. The default is 0x01.

bsc dial-contention

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

no bsc dial-contention

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.

bsc host-timeout

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

no 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).

bsc pause

To specify the interval between starts of the polling cycle, use the bsc pause interface configuration command. Use the no form of this command to cancel the specification.

bsc pause time 

no bsc pause time

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

bsc poll-timeout

To specify the timeout, for a poll or select sequence, use the bsc poll-timeout interface configuration command. Use the no form of this command to cancel the specification.

bsc poll-timeout time 

no bsc poll-timeout time

Syntax Description

time

Time in tenths of a second. The default value is 10 (that is, 10 tenths, or 1 second).

bsc primary

To specify that the router is acting as the primary end of the Bisync link connected to the serial interface, and that the attached remote devices are Bisync tributary stations, use the bsc primary interface configuration command. Use the no form of this command to cancel the specification.

bsc primary

no bsc primary

Syntax Description

This command has no arguments or keywords.

bsc retries

To specify the number of retries performed before a device is considered to have failed, use the bsc retries interface configuration command. Use the no form of this command to cancel the specification.

bsc retries retries 

no bsc retries retries

Syntax Description

retries

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

bsc secondary

To specify 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, use the bsc secondary interface configuration command. Use the no form of this command to cancel the specification.

bsc secondary

no bsc secondary

Syntax Description

This command has no arguments or keywords.

bsc servlim

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

no bsc servlim servlim-count

Syntax Description

servlim-count

Number of cycles. The range is 1 to 50. The default is 3.

bsc spec-poll

To set specific polls, rather than general polls, used on the host-to-router connection, use the bsc spec-poll interface configuration command. Use the no form of this command to cancel the specification.

bsc spec-poll

no spec-poll

Syntax Description

This command has no arguments or keywords.

bstun group

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 

no bstun group group-number

Syntax Description

group-number

BSTUN group to which the interface belongs.

bstun keepalive-count

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 

no bstun keepalive-count

Syntax Description

count

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

bstun lisnsap

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

no bstun lisnsap

Syntax Description

sap-value

SAP on which to listen for incoming calls. The default is 04.

bstun peer-name

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 

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

bstun protocol-group

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

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

  • adplex

  • adt-poll-select

  • adt-vari-poll

  • async-generic

  • bsc

  • bsc-local-ack

  • diebold

  • mdi

bstun remote-peer-keepalive

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

no bstun remote-peer-keepalive

Syntax Description

seconds

Keepalive interval, in seconds. The range is 1 to 300 seconds. The default is 30 seconds.

bstun route

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]

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

bstun route (Frame Relay)

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]

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

encapsulation bstun

To configure BSTUN on a particular serial interface, use the encapsulation bstun interface configuration command. Use the no form of this command to disable the BSTUN function on the interface.

encapsulation bstun

no encapsulation bstun

Syntax Description

This command has no arguments or keywords.

encapsulation stun

To enable STUN encapsulation on a specified serial interface, use the encapsulation stun interface configuration command.

encapsulation stun

Syntax Description

This command has no arguments or keywords.

frame-relay map bstun

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

no frame-relay map bstun dlci

Syntax Description

dlci

Frame Relay DLCI number on which to support passthrough.

priority-list protocol bstun

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]

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

priority-list protocol ip tcp

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

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

  • 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

priority-list protocol stun address

To establish STUN queuing priorities based on the address of the serial link, use the priority-list protocol stun address global configuration command. Use the no form of this command to revert to normal priorities.

priority-list list-number protocol stun queue address group-number address-number

no priority-list list-number protocol stun queue-keyword address group-number address-number

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.

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.

queue-list protocol bstun

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]

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

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

queue-list protocol ip tcp

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

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

  • high---Priority queue type is high.

  • medium---Priority queue type is medium.

  • normal---Priority queue type is normal.

  • low---Priority queue type is low.

The default queue value is normal.

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

sdlc virtual-multidrop

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

no sdlc virtual-multidrop

Syntax Description

This command has no arguments or keywords.

show bsc

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.

show bstun

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.

show stun

To display the current status of STUN connections, use the show stun privileged EXEC command.

show stun

Syntax Description

This command has no arguments or keywords.

stun group

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

no stun group group-number

Syntax Description

group-number

Integer in the range 1 to 255.

stun keepalive-count

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

no stun keepalive-count

Syntax Description

count

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

stun peer-name

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

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

stun protocol-group

To create a protocol group, use the stun protocol-group global configuration command. Use the no form of this command to remove an interface from the group.

stun protocol-group group-number {basic | sdlc [sdlc-tg] | schema}

no stun protocol-group

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.

stun quick-response

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

no stun quick-response

Syntax Description

This command has no arguments or keywords.

stun remote-peer-keepalive

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

no stun remote-peer-keepalive

Syntax Description

seconds

Keepalive interval, in seconds. The range is 1 to 300 seconds. The default is 30 seconds.

stun route address interface dlci

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

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

stun route address interface serial

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]

no stun route address address-number interface serial number

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.

stun route address tcp

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]

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

stun route all interface serial

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]

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

stun route all tcp

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

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

stun schema offset length format

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

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

  • decimal---0 to 9

  • hexadecimal---0 to F

  • octal---0 to 7

stun sdlc-role primary

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 primary

no stun sdlc-role


Syntax Description

This command has no arguments or keywords.

stun sdlc-role secondary

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 secondary node role assignment

stun sdlc-role secondary

no stun sdlc-role

Syntax Description

This command has no arguments or keywords.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jul 26 11:22:11 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.