|
|
The chapter describes the function and displays the syntax of each serial tunnel (STUN) and block serial tunnel (BSTUN) command. For more information about defaults and usage guidelines, see the corresponding chapter of the Bridging and IBM Networking Command Reference.
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 that the Bisync link connected to the serial interface is a point-to-point Bisync station. Use the no form of this command to cancel the specification.
bsc contentionUse the bsc pause interface configuration command to specify the interval to the tenth of a second, between the start of a 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 polling timeout to the tenth of a second. 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 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 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 {bsc | bsc-local-ack}| group-number | BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. |
| bsc | Enables Bisync passthrough. |
| bsc-local-ack | Enables local acknowledgment of Bisync frames. |
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 | For Bisync protocols, address number is the 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 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 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: High - STUN port 1994 Medium - STUN port 1990 Normal - STUN port 1991 Low - STUN port 1992 |
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: High - STUN port 1994 Medium - STUN port 1990 Normal - STUN port 1991 Low - STUN port 1992 |
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]| 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 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| 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 global 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
|
|