Table Of Contents
SNA Frame Relay Access Support Commands
frame-relay map llc2
frame-relay map rsrb
fras backup dlsw
fras ban
fras ddr-backup
fras-host ban
fras-host bnn
fras-host dlsw-local-ack
fras map llc
fras map sdlc
interface virtual-tokenring
llc2 dynwind
show fras
show fras-host
show fras map
SNA Frame Relay Access Support Commands
This chapter describes the commands to configure Systems Network Architecture (SNA) Frame Relay Access Support (FRAS). For SNA FRAS configuration tasks and examples, refer to the "Configuring SNA Frame Relay Access Support" chapter of the Cisco IOS Bridging and IBM Networking Configuration Guide.
Note
Because Frame Relay does not provide the reliable transport required by SNA, the RFC 1490 support of SNA uses Logical Link Control, type 2 (LLC2) as part of the encapsulation to provide link-level sequencing, acknowledgment, and flow control. The serial interface configured for Internet Engineering Task Force (IETF) encapsulation (RFC 1490) accepts all LLC2 interface configuration commands. For more information about LLC2 interface configuration commands, refer to the "LLC2 and SDLC Commands."
frame-relay map llc2
To configure BSTUN over Frame Relay when using Bisync local acknowledgment, use the frame-relay map llc2 interface configuration command. To cancel the configuration, use the no form of this command.
frame-relay map llc2 dlci
no frame-relay map llc2 dlci
Syntax Description
dlci
|
Frame Relay DLCI number on which to support local acknowledgment.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Usage Guidelines
Direct encapsulation over Frame Relay is supported only for an encapsulation type of cisco, configured using the encapsulation frame-relay command.
Examples
The following example maps BSTUN traffic to DLCI number 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.
|
frame-relay map rsrb
To specify the DLCI number onto which the RSRB traffic is to be mapped, use the frame-relay map rsrb interface configuration command. To cancel the RSRB map, use the no form of this command.
frame-relay map rsrb dlci-number
no frame-relay map rsrb
Syntax Description
dlci-number
|
Frame Relay DLCI.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Direct encapsulation over Frame Relay is supported only for an encapsulation type of cisco, configured using the encapsulation frame-relay command.
Examples
The following example shows RSRB traffic mapped to DLCI number 30:
Related Commands
Command
|
Description
|
encapsulation frame-relay
|
Enables Frame Relay encapsulation.
|
fras backup dlsw
To configure an auxiliary route between the end stations and the host for use as a backup when the DLCI connection to the Frame Relay network is lost, use the fras backup dlsw interface configuration command. To cancel the backup configuration, use the no form of this command.
fras backup dlsw virtual-mac-address target-ring-number host-mac-address [retry retry-number]
no fras backup dlsw virtual-mac-address target-ring-number host-mac-address [retry
retry-number]
Syntax Description
virtual-mac-address
|
12-digit hexadecimal string used as a source MAC address for all packets going to the host.
|
target-ring-number
|
Number configured in the source-bridge ring-group command. This is a virtual ring. The valid range is 1 to 4095.
|
host-mac-address
|
Destination MAC address of the host.
|
retry retry-number
|
(Optional) Number of attempts by the end station to reconnect to the primary Frame Relay interface before activating the backup link. The range is 1 to 5 retries. If the retry option is not specified, the default number of retries is 5.
|
Defaults
FRAS dial backup over DLSw+ is disabled. The default number of retries is 5.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Usage Guidelines
Configure DLSw+ as normally required. Specify the optional keyword dynamic at the end of the dlsw remote-peer configuration command to enable the peer relationship to be established only when needed (for example, when the fras backup dlsw command becomes active).
Examples
The following example configures FRAS dial backup over DLSw+:
fras backup dlsw 4000.1000.2000 200 1000.5aed.1f53
Related Commands
Command
|
Description
|
dlsw local-peer
|
Defines the parameters of the DLSw+ local peer.
|
dlsw remote-peer tcp
|
Identifies the IP address of a peer with which to exchange traffic using TCP.
|
frame-relay lmi-type
|
Selects the LMI type.
|
frame-relay map llc2
|
Configures BSTUN over Frame Relay when using Bisync local acknowledgment.
|
fras map llc
|
Associates an LLC connection with a Frame Relay DLCI.
|
show fras
|
Displays notification that the FRAS dial backup over DLSw+ feature is active, information about the connection state in FRAS, and information about current BNN, BAN, and dial backup.
|
source-bridge ring-group
|
Defines or removes a ring group from the configuration.
|
fras ban
To associate bridging over a Frame Relay network using boundary access node (BAN), use the fras ban interface configuration command. To cancel each association, use the no form of this command.
fras ban local-ring bridge-number ring-group ban-dlci-mac dlci dlci#1 [dlci#2 ... dlci#5] [bni
mac-addr]
no fras ban local-ring bridge-number ring-group ban-dlci-mac dlci dlci#1 [dlci#2 ... dlci#5] [bni
mac-addr]
Syntax Description
local-ring
|
Decimal number from 1 to 4095 describing the Token Ring interface.
|
bridge-number
|
Decimal number from 1 to 15 that uniquely identifies a bridge connecting two rings.
|
ring-group
|
Decimal number from 1 to 4095 representing a collection of Token Ring interfaces on one or more routers.
|
ban-dlci-mac
|
Frame Relay BAN PVC MAC address.
|
dlci dlci#1 [dlci#2 ... dlci#5]
|
Frame Relay DLCI. The dlci keyword precedes the list of one or more DLCI numbers. If you need more than one DLCI number for load balancing, you can configure up to five DLCI numbers, separated by spaces. Each DLCI number must be unique and must be a decimal in the range 16 through 1007.
|
bni mac-addr
|
(Optional) Boundary node identifier (BNI) MAC address of the NCP that receives frames from the router.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Usage Guidelines
Multiple fras ban commands may be configured; however, each fras ban command must use a unique DLCI MAC address.
You must configure the source-bridge ring-group global configuration command prior to configuring the fras ban command.
Examples
The following example shows FRAS BAN support for Token Ring and serial interfaces:
source-bridge ring-group 200
encapsulation frame-relay ietf
frame-relay lmi-type ansi
fras ban 120 1 200 4000.1000.2000 dlci 16 17
Related Commands
Command
|
Description
|
source-bridge ring-group
|
Defines or removes a ring group from the configuration.
|
fras ddr-backup
To configure an auxiliary interface for use as a backup when the primary Frame Relay link to the Frame Relay WAN fails, use the fras ddr-backup interface configuration command. To cancel the backup configuration, use the no form of this command.
fras ddr-backup interface interface dlci-number
no fras ddr-backup
Syntax Description
interface interface
|
Interface over which the backup connection is made.
|
dlci-number
|
DLCI number of the session.
|
Defaults
FRAS DLCI backup is disabled by default.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Examples
The following example configures FRAS DLCI backup on serial interface 1:
fras ddr-backup interface serial1 188
Related Commands
Command
|
Description
|
show llc2
|
Displays the LLC2 connections active in the router.
|
show frame-relay pvc
|
Displays statistics about PVCs for Frame Relay interfaces.
|
show fras
|
Displays notification that the FRAS dial backup over DLSw+ feature is active, information about the connection state in FRAS, and information about current BNN, BAN, and dial backup.
|
fras-host ban
To enable the FRAS Host function for BAN, use the fras-host ban interface configuration command. To disable the FRAS Host BAN functionality, use the no form of this command.
fras-host ban interface hmac hmac [bni bni]
no fras-host ban
Syntax Description
interface
|
Associated Frame Relay interface or subinterface.
|
hmac hmac
|
MAC address of the CIP adapter or LAN-attached host.
|
bni bni
|
(Optional) Boundary node identifier MAC address. The default bni is 4FFF.0000.0000.
|
Defaults
The FRAS Host function for BAN is disabled for the Frame Relay subinterface.
The default bni is 4FFF.0000.0000.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Examples
The following example enables the FRAS Host function for BAN:
fras-host ban Serial0 hmac 4001.3745.0001
Related Commands
fras-host bnn
To enable the FRAS Host function for BNN, use the fras-host bnn interface configuration command. To disable the FRAS Host function, use the no form of this command.
fras-host bnn interface fr-lsap sap vmac virt-mac hmac hmac [hsap hsap]
no fras-host bnn
Syntax Description
interface
|
Associated Frame Relay interface or subinterface.
|
fr-lsap sap
|
LLC2 service access point (SAP). The destination SAP on inbound BNN frames received from Frame Relay.
|
vmac virt-mac
|
Used in combination with the DLCI number to form a unique MAC address. The first 4 bytes of the MAC address are formed by the VMAC while the last 2 bytes are formed from the DLCI number. The last 2 bytes of the VMAC must be configured as zeros.
|
hmac hmac
|
MAC address of the CIP adapter or LAN-attached host.
|
hsap hsap
|
(Optional) Host SAP. If this parameter is not specified, the host SAP value used will match fr-lsap.
|
Defaults
FRAS Host for BNN is disabled for the Frame Relay subinterface.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Examples
The following example enables the FRAS Host function for BNN:
fras-host bnn Serial0 fr-lsap 04 vmac 4005.3003.0000 hmac 4001.3745.0001
Related Commands
fras-host dlsw-local-ack
To enable LLC2 local termination for FRAS Host connections using the virtual Token Ring, use the fras-host dlsw-local-ack interface configuration command. To disable LLC2 local termination, use the no form of this command.
fras-host dlsw-local-ack
no fras-host dlsw-local-ack
Syntax Description
This command has no arguments or keywords.
Defaults
The default state is FRAS Host LLC2 local termination disabled.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Examples
The following example enables LLC2 local termination for FRAS Host connections using the virtual Token Ring:
Related Commands
fras map llc
To associate an LLC connection with a Frame Relay DLCI, use the fras map llc interface configuration command. To disable the association, use the no form of this command.
fras map llc lan-lsap serial interface frame-relay dlci dlci fr-rsap
no fras map llc lan-lsap serial interface frame-relay dlci dlci fr-rsap
Syntax Description
lan-lsap
|
LLC2 LAN SAP that is the local SAP address of the router.
|
serial interface
|
Serial interface on which Frame Relay is configured.
|
frame-relay dlci dlci
|
Frame Relay DLCI.
|
fr-rsap
|
LLC2 Frame Relay SAP that is the destination SAP of the router on the Frame Relay side.
|
Defaults
The default state is FRAS BNN enhancement is disabled.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Usage Guidelines
If the destination SAP specified by the end station is equal to lan-lsap, the router associates the LLC (LAN) connection with the Frame Relay DLCI.
The MAC address and the SAP address of the end station are no longer required for the BNN enhanced configuration.
Examples
In the FRAS BNN enhancement, the revised fras map llc command achieves the same result as using multiple fras map llc commands in the original FRAS BNN implementation. The following example provides one map definition for both end stations:
fras map llc 4 Serial 0 frame-relay dlci 16 04
Related Commands
Command
|
Description
|
show fras
|
Displays notification that the FRAS dial backup over DLSw+ feature is active, information about the connection state in FRAS, and information about current BNN, BAN, and dial backup.
|
show llc2
|
Displays the LLC2 connections active in the router.
|
fras map sdlc
To associate an SDLC link with a Frame Relay DLCI, use the fras map sdlc interface configuration command. To cancel the association, use the no form of this command.
fras map sdlc sdlc-address serial port frame-relay dlci fr-lsap fr-rsap [pfid2 | afid2 | fid4]
no fras map sdlc sdlc-address serial port frame-relay dlci fr-lsap fr-rsap [pfid2 | afid2 | fid4]
Syntax Description
sdlc-address
|
SDLC address of the downstream SNA device in hexadecimal.
|
serial port
|
Serial interface on which Frame Relay is configured.
|
frame-relay dlci
|
Frame Relay DLCI.
|
fr-lsap
|
Local SAP address of the logical link connection on the Cisco Frame Relay Access Device (CFRAD).
|
fr-rsap
|
Destination SAP address on the host.
|
pfid
|
(Optional) FID2 SNA transmission header for SNA peripheral traffic.
|
afid2
|
(Optional) FID2 transmission header for APPN traffic.
|
fid4
|
(Optional) Transmission header used on SNA subarea flows.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
You can map multiple SDLC links to a DLCI.
Examples
The following example associates an SDLC link with a Frame Relay DLCI:
fras map sdlc c1 serial 0 frame-relay 200 4 4
Related Commands
Command
|
Description
|
frame-relay map llc2
|
Configures BSTUN over Frame Relay when using Bisync local acknowledgment.
|
interface virtual-tokenring
To create a virtual Token Ring interface, use the interface virtual-tokenring interface configuration command. To cancel the configuration, use the no form of this command.
interface virtual-tokenring number
no interface virtual-tokenring
Syntax Description
number
|
Number of the virtual Token Ring.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Examples
The following example configures the virtual Token Ring interface:
interface virtual-tokenring 0
Related Commands
Command
|
Description
|
source-bridge
|
Configures an interface for SRB.
|
fras ban
|
Associates bridging over a Frame Relay network using BAN.
|
fras-host bnn
|
Enables the FRAS Host function for BNN.
|
llc2 dynwind
To enable dynamic window congestion management, use the llc2 dynwind interface configuration command. To cancel the configuration, use the no form of this command.
llc2 dynwind [nw nw-number] [dwc dwc-number]
no llc2 dynwind [nw nw-number] [dwc dwc-number]
Syntax Description
nw nw-number
|
(Optional) Specifies a number of frames that must be received to increment the working window value by 1. The default is 4.
|
dwc dwc-number
|
(Optional) Specifies the number by which the working window value is divided when BECN occurs. Valid numbers are 1, 2, 4, 8, and 16. 1 is a special value that indicates that the working window value should be set to 1 when BECN is indicated. The default is 1.
|
Defaults
The default nw-number value is 4.
The default dwc-number value is 1.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Examples
The following example specifies that to increment the working window 6 frames must be received, and the working window value should be set to 1 when BECN occurs:
show fras
To view notification that the FRAS dial backup over DLSw+ feature is active, information about the connection state in FRAS, and information about current BNN, BAN, and dial backup, use the show fras privileged EXEC command.
show fras
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Examples
The following is sample output from the show fras command:
Boundary Network Node (BNN):
Type Destination Int LSap RSap Role State
fr 4 4 S ls_reset (Backup is enabled)
llc 0000.f63a.2f50 To0 4 4 P ls_contacted
Table 46 describes significant fields shown in the display.
Table 46 show fras Field Descriptions
Field
|
Description
|
Type
|
Connection type. The display example shows LLC and Frame Relay.
|
Destination
|
Destination MAC address from the perspective of the Cisco IOS software.
|
Int
|
Interface on which the connection resides.
|
LSap
|
Local SAP value.
|
RSap
|
Remote SAP value.
|
Role
|
Local link station role; P means primary and S means secondary.
|
State
|
Link station protocol machine state. This value may be one of the following states:
• ls_reset—Initial state.
• ls_RqOpnStnSent—TEST frame sent; request to open a connection endpoint.
• ls_ExchgXid—XID negotiation taking place.
• ls_ConnRqSent—SABME sent (connecting side).
• ls_SigStnWait—Waiting for signal to clean up the congestion and respond to polling with an RNR.
• ls_ConnRspWait—Wait for the other connection endpoint to bring up the link.
• ls_ConnRspSent—A UA has been sent and the router is waiting for a RR to clear up the flow.
• ls_Contacted—Everything is connected
• ls_DiscWait—Wait for acknowledge to disconnect request.
|
Backup is enabled
|
Notification displayed when the FRAS dial backup feature is configured.
|
show fras-host
To display the status of LLC2 sessions using FRAS Host, use the show fras-host EXEC command.
show fras-host [interface] [dlci dlci-num] [detail]
Syntax Description
interface
|
(Optional) Only display LLC2 sessions from a specified Frame Relay interface or subinterface.
|
dlci dlci-number
|
(Optional) Only display LLC2 sessions from a specified DLCI.
|
detail
|
(Optional) Display additional information such as the routing information fields (RIFs) and statistics associated with the LLC2 sessions.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2 F
|
This command was introduced.
|
Examples
The following is sample output from the show fras-host command:
Number of Active Control Blocks = 2
Number of Available Control Blocks in Pool = 126
Port DLCI Type FrRsap FrLSap HostSap VMac HostMac
Se0 16 BNN 04 08 04 4000.ABBA.001E 4000.3000.2000
Se1 37 BAN 04 04 04 4000.0223.0019 4000.3000.2000
Table 47 describes significant fields shown in the display.
Table 47 show fras-host Field Descriptions
Field
|
Description
|
Port
|
Frame Relay interface or subinterface associated with this LLC2 session.
|
DLCI
|
DLCI number associated with this LLC2 session
|
Type
|
FRAS encapsulation type associated with this LLC2 session
|
FrRsap
|
Frame Relay Remote LLC2 SAP associated with this LLC2 session. This SAP is the source sap on LLC2 frames sent by the remote FRAD.
|
FrLSap
|
Frame Relay Local LLC2 SAP associated with this LLC2 session. This SAP is the destination SAP on LLC2 frames sent by the remote FRAD.
|
HostSap
|
Destination SAP on LLC2 frames sent to the CIP or LAN-attached AS/400. This SAP is identical to FrLsap unless the hsap keyword is specified on the fras-host bnn command.
|
VMac
|
MAC address associated with the remote FRAD for this LLC2 session.
|
HostMac
|
MAC address associated with the host for this LLC2 session.
|
Related Commands
show fras map
To display the mapping and connection state of FRAS, use the show fras map privileged EXEC command.
show fras map
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Examples
The following is sample output from the show fras map command:
Type Destination Int LSap RSap Role State
tr 0800.5a8f.8802 tr0 4 4 P ls_contacted
fr 200 s0 4 4 S ls_contacted
Table 48 describes significant fields shown in the display.
Table 48 show fras map Field Descriptions
Field
|
Description
|
Type
|
Interface type.
|
Destination
|
Destination address.
|
Int
|
Interface.
|
LSap
|
Local SAP.
|
RSap
|
Remote SAP.
|
Role
|
Local link station role; P means primary, S means secondary.
|
State
|
Link station protocol machine state.
|