|
|
This chapter describes the function and displays the syntax for serial tunnel (STUN) and block serial tunnel (BSTUN) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Bridging and IBM Networking Command Reference.
| address-offset | Location of the address byte within the polled asynchronous frame being received. |
Use the asp role interface configuration command 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 no form of this command to cancel the specification.
asp role {primary | secondary}| 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. |
Use the asp rx-ift interface configuration command to specify a time period that, by expiring, signals the end of one frame being received and the start of the next. Use the no form of this command to cancel the specification.
asp rx-ift interframe-timeout| interframe-timeout | Number of milliseconds between the end of one frame being received and the start of the next frame. |
Use the bsc char-set interface configuration command to specify the character set used by the Bisync support feature in this serial interface as either EBCDIC or ASCII. Use the no form of this command to cancel the character set specification.
bsc char-set {ascii | ebcdic}| ascii | ASCII character set. |
| ebcdic | EBCDIC character set. |
Use the bsc contention interface configuration command to specify an address on a contention interface. Use the no form of this command to cancel the specification.
bsc contention address| address | Address assigned to contention interface. The range is 1 to 255. The default is 0x01. |
Use the bsc dial-contention interface configuration command to specify a router at the central site as a central router with dynamic allocation of serial interfaces. Use the no form of this command to cancel the specification. A timeout value is configurable to ensure that an interface does not get locked out because of a device outage during transmission.
bsc dial-contention time-out| 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. |
Use the bsc host-timeout interface configuration command to detect deactivation of devices at the host. Use the no form of this command to cancel the configuration.
bsc host-timeout interval| 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. |
Use the bsc pause interface configuration command to specify the interval to the tenth of a second, between starts of the polling cycle. Use the no form of this command to cancel the specification.
bsc pause time| time | Interval in tenths of a second. The default value is 10 (1 second). The maximum time is 25.5 seconds. |
Use the bsc poll-timeout interface configuration command to specify the timeout, in tenths of a second, for a poll or select sequence. Use the no form of this command to cancel the specification.
bsc poll-timeout time| time | Time in tenths of a second. The default value is 10 (1 second). |
Use the bsc primary interface configuration command 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 no form of this command to cancel the specification.
bsc primaryUse the bsc retries interface configuration command to specify the number of retries performed before a device is considered to have failed. Use the no form of this command to cancel the specification.
bsc retries retries| retries | Number of retries before a device fails. The default is 5. |
Use the bsc secondary interface configuration command 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 no form of this command to cancel the specification.
bsc secondaryUse the bsc servlim interface configuration command 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 no form of this command to cancel the specification.
bsc servlim servlim-count| servlim-count | Number of cycles. The range is 1 to 50. The default is 3. |
Use the bsc spec-poll interface configuration command to set specific polls, rather than general polls, used on the host-to-router connection. Use the no form of this command to cancel the specification.
bsc spec-pollUse the bstun group interface configuration command to specify the BSTUN group to which the interface belongs. Use the no form of this command to remove the interface from the BSTUN group.
bstun group group-number| group-number | BSTUN group to which the interface belongs. |
Use the bstun keepalive-count global configuration command to define the number of times to attempt a peer connection before declaring the peer connection to be down. Use the no form of this command to cancel the definition.
bstun keepalive-count count| count | Number of connection attempts. The range is between 2 and 10 retries. |
Use the bstun lisnsap global configuration command to configure a SAP on which to listen for incoming calls. Use the no form of this command to cancel the lisnsap.
bstun lisnsap sap-value| sap-value | SAP on which to listen for incoming calls. The default is 04. |
Use the bstun peer-name global configuration command to enable the block serial tunneling function. Use the no form of this command to disable the function.
bstun peer-name ip-address| ip-address | Address by which this BSTUN peer is known to other BSTUN peers that are using the TCP transport. |
Use the bstun protocol-group global configuration command to define a BSTUN group and the protocol it uses. Use the no form of this command to delete the BSTUN group.
bstun protocol-group group-number protocol| 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 |
Use the bstun remote-peer-keepalive global configuration command to enable detection of the loss of a peer. Use the no form of this command to disable detection.
bstun remote-peer-keepalive seconds| seconds | Keepalive interval, in seconds. The range is 1 to 300 seconds. |
Use the bstun route interface configuration command to define how frames will be forwarded from a BSTUN interface to a remote BSTUN peer. Use the no form of this command to cancel the definition.
bstun route {all | address address-number} {tcp ip-address | interface serial number} [direct]| 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. |
Use the bstun route interface configuration command to define how frames will be forwarded from a BSTUN interface to a remote BSTUN peer over Frame Relay. 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| 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 | 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 | Priority port to be used for this LLC2 session. Configurable only if the interface group number supports local acknowledgment. |
Use the encapsulation bstun interface configuration command to configure BSTUN on a particular serial interface. Use the no form of this command to disable the BSTUN function on the interface.
encapsulation bstunUse the encapsulation stun interface configuration command to enable STUN encapsulation on a specified serial interface.
encapsulation stunUse the frame-relay map bstun interface configuration command to configure BSTUN over Frame Relay for passthru. Use the no form of this command to cancel the configuration.
frame-relay map bstun dlci| dlci | Frame Relay DLCI number on which to support passthru. |
Use the frame-relay map llc2 interface configuration command to configure BSTUN over Frame Relay when using Bisync local acknowledgement. Use the no form of this command to cancel the configuration.
frame-relay map llc2 dlci| dlci | Frame Relay DLCI number on which to support local acknowledgement. |
Use the locaddr-priority-list interface configuration command to establish queuing priorities based upon the address of the logical unit (LU). Use the no form of this command to cancel all previous assignments.
locaddr-priority-list list-number address-number queue-keyword| list-number | Arbitrary integer between 1 and 10 that identifies the LU address priority list. |
| address-number | Value of the LOCADDR=parameter on the LU macro, which is a 1-byte address of the LU in hexadecimal. |
| queue-keyword | Priority queue type: high, medium, normal, or low. |
Use the priority-group interface configuration command to assign a priority group to an interface. Use the no form of this command to remove assignments.
priority-group list-number| list-number | Priority list number assigned to the interface. |
Use the priority-list protocol bstun global configuration command to establish BSTUN queuing priorities based on the BSTUN header. Use the no form of this command to revert to normal priorities.
priority-list list-number protocol bstun queue [gt | lt packetsize]| 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. |
Use the priority-list protocol ip tcp global configuration command to establish BSTUN or STUN queuing priorities based on the TCP port. Use the no form of this command to revert to normal priorities.
priority-list list-number protocol ip queue tcp tcp-port-number| 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: |
Use the priority-list stun address global configuration command to establish STUN queuing priorities based on the address of the serial link. Use the no form of this command to revert to normal priorities.
priority-list list-number stun queue address group-number address-number| 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. |
| 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. |
Use the queue-list protocol bstun global configuration command to customize BSTUN queuing priorities based on the BSTUN header. Use the no form of this command to revert to normal priorities.
queue-list list-number protocol bstun queue [gt | lt packetsize]| 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. |
Use the queue-list protocol ip tcp global configuration command to customize BSTUN queuing priorities based on the TCP port. Use the no form of this command to revert to normal priorities.
queue-list list-number protocol ip queue tcp tcp-port-number| 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: |
Use the sdlc virtual-multidrop interface configuration command 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 no form of this command to disable the SDLC broadcast feature.
sdlc virtual-multidropUse the show bsc privileged EXEC command to display statistics about the interfaces on which Bisync is configured.
show bsc [group bstun-group-number] [address address-list]| bstun-group-number | BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. |
| address-list | List of poll addresses. |
Use the show bstun privileged EXEC command to display the current status of STUN connections.
show bstun [group bstun-group-number] [address address-list]| group bstun-group-number | BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. |
| address address-list | List of poll addresses. |
Use the show stun privileged EXEC command to display the current status of STUN connections.
show stunUse the stun group interface configuration command to place each STUN-enabled interface on a router in a previously defined STUN group. Use the no form of this command to remove an interface from a group.
stun group group-number| group-number | Integer in the range 1 to 255. |
Use the stun keepalive-count global configuration command to define the number of times to attempt a peer connection before declaring the peer connection to be down. Use the no form of this command to cancel the definition.
stun keepalive-count count| count | Number of connection attempts. The range is between 2 and 10 retries. |
Use the stun peer-name global configuration command to enable STUN for an IP address. Use the no form of this command to disable STUN for an IP address.
stun peer-name ip-address cls| ip-address | IP address by which this STUN peer is known to other STUN peers. |
Use the stun protocol-group global configuration command to create a protocol group. Use the no form of this command to remove an interface from the group.
stun protocol-group group-number {basic | sdlc [sdlc-tg] | schema}| 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. |
Use the stun remote-peer-keepalive global configuration command to enable detection of the loss of a peer. Use the no form of this command to disable detection.
stun remote-peer-keepalive seconds| seconds | Keepalive interval, in seconds. The range is 1 to 300 seconds. The default is 30 seconds. |
Use the stun route address interface dlci interface configuration command to configure direct Frame Relay encapsulation between STUN peers with SDLC local acknowledgment. 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| 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. |
Use the stun route address interface serial interface configuration command to forward all HDLC traffic on a serial interface. Use the no form of this command to disable this method of HDLC encapsulation.
stun route address address-number interface serial number [direct]| 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. |
Use the stun route address tcp interface configuration command to specify TCP encapsulation and optionally establish SDLC local acknowledgment (SDLC transport) for STUN. 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]| address-number | Number that conforms to TCP 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. |
Use the stun route all interface serial interface configuration command to encapsulate and forward all STUN traffic using HDLC encapsulation on a serial interface.
stun route all interface serial number [direct]| 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. |
Use the stun route all tcp interface configuration command with TCP encapsulation to forward all STUN traffic on an interface regardless of what address is contained in the serial frame.
stun route all tcp ip-address| 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 far serial link. |
Use the stun schema offset length format global configuration command to define a protocol other than SDLC for use with STUN. Use the no form of this command to disable the new protocol.
stun schema name offset constant-offset length address-length format format-keyword| 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 | Format to be used to specify and display addresses for routes on interfaces that use this STUN protocol. The allowable format keywords are decimal (0 to 9), hexadecimal (0 to F), and octal (0 to 7). |
Use the stun sdlc-role primary interface configuration command to assign the router the role of SDLC primary node. Primary nodes poll secondary nodes in a predetermined order.
stun sdlc-role primaryUse the stun sdlc-role secondary interface configuration command to assign the router the role of SDLC secondary node. Secondary nodes respond to polls sent by the SDLC primary by transmitting any outgoing data they may have.
stun sdlc-role secondary
|
|