Cisco IOS Wide-Area Networking Command Reference, Release 12.3
Wide-Area Networking Commands: forward through frame-relay lmi-type

Table Of Contents

forward accounting-start-stop

frame-relay accounting adjust

frame-relay adaptive-shaping

frame-relay address registration auto-address

frame-relay address registration ip

frame-relay address-reg enable

frame-relay bc

frame-relay be

frame-relay broadcast-queue

frame-relay cir

frame-relay class

frame-relay congestion threshold de

frame-relay congestion threshold ecn

frame-relay congestion-management

frame-relay custom-queue-list

frame-relay de-group

frame-relay de-list

frame-relay end-to-end keepalive error-threshold

frame-relay end-to-end keepalive event-window

frame-relay end-to-end keepalive mode

frame-relay end-to-end keepalive success-events

frame-relay end-to-end keepalive timer

frame-relay fair-queue

frame-relay fragment

frame-relay fragment end-to-end

frame-relay fragmentation voice-adaptive

frame-relay holdq

frame-relay idle-timer

frame-relay interface-dlci switched

frame-relay interface-dlci

frame-relay intf-type

frame-relay inverse-arp

frame-relay ip tcp compression-connections

frame-relay ip tcp header-compression

frame-relay lapf frmr

frame-relay lapf k

frame-relay lapf n200

frame-relay lapf n201

frame-relay lapf t200

frame-relay lapf t203

frame-relay lmi-n391dte

frame-relay lmi-n392dce

frame-relay lmi-n392dte

frame-relay lmi-n393dce

frame-relay lmi-n393dte

frame-relay lmi-t392dce

frame-relay lmi-type


forward accounting-start-stop

To proxy accounting start, stop, and update packets generated by any RADIUS clients to the authentication, authorization, and accounting (AAA) server, use the forward accounting-start-stop command in SSG-radius-proxy configuration mode. To stop forwarding accounting start, stop, and update packets, use the no form of this command.

forward accounting-start-stop

no forward accounting-start-stop

Syntax Description

This command has no arguments or keywords.

Defaults

Forward accounting-start-stop is disabled by default.

Command Modes

SSG-radius-proxy configuration

Command History

Release
Modification

12.2(4)B

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.


Usage Guidelines

Use this command to proxy accounting start, stop, and update packets generated by all RADIUS clients to the AAA server. Disabling this command reduces RADIUS packet traffic and processing for deployments where the billing server is not using these packets for billing purposes.


Note The forward accounting-start-stop command does not affect accounting on and off packets, which are forwarded regardless of this command.


Examples

The following example shows how to proxy accounting packets generated by all RADIUS clients to the AAA server:

ssg radius-proxy
 server-port auth 1645 acct 1646
 client-address 10.1.2.2 key secret1
 client-address 10.2.25.90 key secret2
 client-address 10.0.0.1 key secret3
 client-address 10.23.3.2 key secret4
 idle-timeout 30
 forward accounting-start-stop
 address-pool 10.1.1.1 10.1.40.250
 address-pool 10.1.5.1 10.1.5.30 domain ssg.com

Related Commands

Command
Description

address-pool

Defines local IP pools to be used by SSG to assign IP addresses to users for which SSG is acting as a RADIUS client.

clear ssg radius-proxy client-address

Clears all hosts connected to a specific RADIUS client.

clear ssg radius-proxy nas-address

Clears all hosts connected to a specific NAS.

idle-timeout (SSG)

Configures a host object timeout value.

server-port

Defines the ports for the SSG RADIUS proxy.

show ssg tcp-redirect group

Displays the pool of IP addresses configured for a router or for a specific domain.

ssg enable

Enables SSG.

ssg radius-proxy

Enables SSG RADIUS Proxy.


frame-relay accounting adjust

To enable byte count adjustment at the permanent virtual circuit (PVC) level so that the number of bytes sent and received at the PVC corresponds to the actual number of bytes sent and received on the physical interface, use the frame-relay accounting adjust command in interface configuration mode. To disable byte count adjustment, use the no form of this command.

frame-relay accounting adjust

no frame-relay accounting adjust [frf9]

Syntax Description

frf9

(Optional) Payload compression using the Stacker method.


Note Use the frf9 keyword only with the no form of this command.



Defaults

Byte count adjustment is enabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.2

This command was introduced.

12.2 T

This command was integrated into Cisco IOS Release 12.2 T.

12.2 S

This command was integrated into Cisco IOS Release 12.2 S.

12.3

This command was integrated into Cisco IOS Release 12.3.


Usage Guidelines

Use this command to return the number of bytes shown at the PVC level back to the number of bytes received at the PVC level without any adjustments. This command takes into consideration any dropped packets as well as compression and decompression that may occur after initial processing.

If you use the no frame-relay accounting adjust frf9 command, then byte count includes dropped packets and traffic shaping, but not compression and decompression savings from FRF.9.

Examples

The following example enables Frame-Relay accounting adjustment:

Router# configure terminal
Router(config)# interface serial3/0
Router(config-if) frame-relay accounting adjust

The following example disables Frame-Relay accounting adjustment:

Router# configure terminal
Router(config)# interface serial3/0
Router(config-if) no frame-relay accounting adjust
Router(config-if)# end

The following example verifies that Frame-Relay accounting adjustment is disabled:

Router# show run interface serial3/0

Building configuration...

Current configuration :266 bytes
!
interface Serial3/0
 no ip address
 encapsulation frame-relay
 no frame-relay accounting adjust
end

Related Commands

Command
Description

show frame-relay pvc

Displays the total input and output bytes for a PVC and an interface as equal.

Note In order for the PVC and the interface input and output byte count to be equal, no other PVCs or network traffic can be passing data. Otherwise the interface shows aggregate totals for PVCs, the Local Management Interface (LMI), and other network traffic.


frame-relay adaptive-shaping

To enable Frame Relay adaptive traffic shaping, use the frame-relay adaptive-shaping command in map-class configuration mode. To disable adaptive traffic shaping, use the no form of this command.

frame-relay adaptive-shaping {becn | foresight | interface-congestion [queue-depth]}

no frame-relay adaptive-shaping {becn | foresight | interface-congestion}

Syntax Description

becn

Enables rate adjustment in response to backward explicit congestion notification (BECN).

foresight

Enables rate adjustment in response to ForeSight messages.

interface-congestion

Enables rate adjustment in response to interface congestion.

queue-depth

(Optional) Maximum number of packets that can be in the interface queue before the interface is considered congested. The range is from 0 to 40 packets. The default is 0 packets.


Defaults

Frame Relay adaptive traffic shaping is not enabled.
Queue depth: 0 packets

Command Modes

Map-class configuration

Command History

Release
Modification

11.3

This command was introduced.

12.2(4)T

This command was modified to configure adaptive traffic shaping for interface congestion.


Usage Guidelines

This command replaces the frame-relay becn-response-enable command. If you use the frame-relay becn-response-enable command in scripts, you should replace it with the frame-relay adaptive-shaping command.

The frame-relay adaptive-shaping command configures a router to adjust virtual circuit (VC) sending rates in response to BECN or ForeSight backward congestion notification messages or interface congestion.

Include this command in a map-class definition and apply the map class either to the main interface or to a subinterface.

Adaptive traffic shaping for interface congestion can be configured along with BECN or ForeSight. When adaptive shaping for interface congestion is used with BECN or ForeSight, if interface congestion exceeds the queue depth, then the PVC send rate is reduced to minimum committed information rate (minCIR). When interface congestion drops below the queue depth, then the send rate is adjusted in response to BECN or ForeSight.


Note For adaptive traffic shaping for interface congestion to work, the sum of the minCIR values for all PVCs on the interface must be less than the usable interface bandwidth.


Examples

ForeSight Example

This example shows the map-class definition for a router configured with traffic shaping and Router ForeSight enabled:

interface Serial0
 no ip address
 encapsulation frame-relay
 frame-relay traffic-shaping
 frame-relay class control-A
!
map-class frame-relay control-A
 frame-relay adaptive-shaping foresight
 frame-relay cir 56000
 frame-relay bc 64000

Adaptive Shaping for Interface Congestion Example

In the following example, the queue depth is set at 10 packets. If the number of packets in the interface queue exceeds 10, the rate of traffic destined for PVC 200 will be reduced to the minCIR. When the number of packets in the interface queue drops below 10, then the traffic rate will immediately return to the CIR.

interface serial0
 encapsulation frame-relay
 frame-relay traffic-shaping
 frame-relay interface-dlci 200
 class adjust_vc_class_rate
!
map-class frame-relay adjust_vc_class_rate   
 frame-relay cir 64000
 frame-relay mincir 32000
 frame-relay adaptive-shaping interface-congestion 10

Related Commands

Command
Description

frame-relay traffic-shaping

Enables both traffic shaping and per-VC queueing for all PVCs and SVCs on a Frame Relay interface.

map-class frame-relay

Specifies a map class to define QoS values for an SVC.


frame-relay address registration auto-address

To enable a router to automatically select a management IP address for Enhanced Local Management Interface (ELMI) address registration, use the frame-relay address registration auto-address command in global configuration mode. To disable automatic address selection, use the no form of this command.

frame-relay address registration auto-address

no frame-relay address registration auto-address

Syntax Description

This command has no arguments or keywords.

Defaults

Auto address selection is enabled.

Command Modes

Global configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.


Usage Guidelines

During system initialization, if no management IP address is configured, then the router automatically selects the IP address of one of the interfaces. The router will choose an Ethernet interface first and then serial and other interfaces. If you do not want the router to select a management IP address during system initialization, you can store the no form of this command in the configuration.

When automatic address selection is disabled and an IP address has not been configured using the frame-relay address registration ip global configuration command, the IP address for ELMI address registration will be set to 0.0.0.0.

The no frame-relay address registration ip command will set the IP address to 0.0.0.0, even when Frame Relay automatic address selection is enabled.

If you configure the IP address using the frame-relay address registration ip global configuration command, the IP address you configure will overwrite the IP address chosen automatically by the router.

If you enable automatic address selection after configuring the IP address using the frame-relay address registration ip global configuration command, the IP address chosen automatically by the router will overwrite the IP address you originally configured.

Examples

The following example shows ELMI enabled on serial interface 0. The automatic IP address selection mechanism is disabled, and no other management IP address has been configured, so the device will share a valid ifIndex and a management IP address of 0.0.0.0.

interface Serial 0
 no ip address
 encapsulation frame-relay
 frame-relay lmi-type ansi
 frame-relay qos-autosense
!
no frame-relay address registration auto-address

Related Commands

Command
Description

frame-relay address-reg enable

Enables ELMI address registration on an interface.

frame-relay address registration ip

Configures the IP address to be used for ELMI address registration.

frame-relay qos-autosense

Enables ELMI on the Cisco router.


frame-relay address registration ip

To configure the IP address for Enhanced Local Management Interface (ELMI) address registration, use the frame-relay address registration ip command in global configuration mode. To set the IP address to 0.0.0.0, use the no form of this command.

frame-relay address registration ip address

no frame-relay address registration ip

Syntax Description

address

IP address to be used for ELMI address registration.


Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.


Usage Guidelines

A management IP address configured by using the frame-relay address registration ip command will overwrite the IP address chosen by the router when automatic address selection is enabled.

The no frame-relay address registration ip command will disable automatic IP address selection and set the management IP address to 0.0.0.0.

If you enable automatic address selection with the frame-relay address registration auto-address global command after configuring the IP address using the frame-relay address registration ip global configuration command, the IP address chosen automatically by the router will overwrite the IP address you originally configured.

Examples

The following example shows ELMI enabled on serial interface 0. The IP address to be used for ELMI address registration is configured, so automatic IP address selection is disabled by default.

interface Serial 0
 no ip address
 encapsulation frame-relay
 frame-relay lmi-type ansi
 frame-relay qos-autosense
!
frame-relay address registration ip address 10.1.1.1

Related Commands

Command
Description

frame-relay address-reg enable

Enables ELMI address registration on an interface.

frame-relay address registration auto-address

Enables a router to automatically select the IP address to be used for ELMI address registration.

frame-relay qos-autosense

Enables ELMI on a Cisco router.


frame-relay address-reg enable

To enable Enhanced Local Management Interface (ELMI) address registration on an interface, use the frame-relay address-reg enable command in interface configuration mode. To disable ELMI address registration, use the no form of this command.

frame-relay address-reg enable

no frame-relay address-reg enable

Syntax Description

This command has no arguments or keywords.

Defaults

ELMI address registration is enabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.


Usage Guidelines

ELMI address registration is enabled by default when ELMI is enabled.

Examples

The following example shows ELMI address registration disabled on serial interface 0.

interface Serial 0
 no ip address
 encapsulation frame-relay
 frame-relay lmi-type ansi
 frame-relay qos-autosense
 no frame-relay address-reg enable

Related Commands

Command
Description

frame-relay address registration auto-address

Enables a router to automatically select the IP address to be used for ELMI address registration.

frame-relay address registration ip

Configures the IP address to be used for ELMI address registration.

frame-relay qos-autosense

Enables ELMI on a Cisco router.


frame-relay bc

To specify the incoming or outgoing committed burst size (Bc) for a Frame Relay virtual circuit, use the frame-relay bc command in map-class configuration mode. To reset the committed burst size to the default, use the no form of this command.

frame-relay bc {in | out} bits

no frame-relay bc {in | out} bits

Syntax Description

in | out

Incoming or outgoing; if neither is specified, both in and out values are set.

bits

Committed burst size, in bits. Range is from 300 to 16000000. Default is 7000.


Defaults

7000 bits

Command Modes

Map-class configuration

Command History

Release
Modification

11.2

This command was introduced.


Usage Guidelines

The Frame Relay committed burst size is specified within a map class to request a certain burst rate for the circuit. Although it is specified in bits, an implicit time factor is the sampling interval Tc on the switch, which is defined as the burst size divided by the committed information rate (CIR).

Examples

In the following example, the serial interface already has a basic configuration, and a map group called "group1" has already been defined. The example shows a map-list configuration that defines the source and destination addresses for bermuda, provides IP and IPX addresses, and ties the map list definition to the map class called "class1". Then traffic-shaping parameters are defined for the map class.

map-list group1 local-addr X121 31383040703500 dest-addr X121 31383040709000
 ip 172.21.177.26 class class1 ietf
 ipx 123.0000.0c07.d530 class class1 ietf

map-class frame-relay class1
 frame-relay cir in 2000000
 frame-relay mincir in 1000000
 frame-relay cir out 15000
 frame-relay mincir out 10000
 frame-relay bc in 15000
 frame-relay bc out 9600
 frame-relay be in 10000
 frame-relay be out 10000
 frame-relay idle-timer 30

Related Commands

Command
Description

frame-relay be

Sets the incoming or outgoing excess burst size (Be) for a Frame Relay VC.

frame-relay cir

Specifies the incoming or outgoing CIR for a Frame Relay VC.


frame-relay be

To set the incoming or outgoing excess burst size (Be) for a Frame Relay virtual circuit, use the frame-relay be command in map-class configuration mode. To reset the excess burst size to the default, use the no form of this command.

frame-relay be {in | out} bits

no frame-relay be {in | out} bits

Syntax Description

in | out

Incoming or outgoing.

bits

Excess burst size, in bits.


Defaults

7000 bits

Command Modes

Map-class configuration

Command History

Release
Modification

11.2

This command was introduced.


Usage Guidelines

The Frame Relay excess burst size is specified within a map class to request a certain burst rate for the circuit. Although it is specified in bits, an implicit time factor is the sampling interval Tc on the switch, which is defined as the burst size divided by the committed information rate (CIR).

Examples

In the following example, the serial interface already has a basic configuration, and a map group called "bermuda" has already been defined. The example shows a map-list configuration that defines the source and destination addresses for bermuda, provides IP and IPX addresses, and ties the map list definition to the map class called "jamaica". Then traffic-shaping parameters are defined for the map class.

map-list bermuda local-addr X121 31383040703500 dest-addr X121 31383040709000
 ip 172.21.177.26 class jamaica ietf
 ipx 123.0000.0c07.d530 class jamaica ietf

map-class frame-relay jamaica
 frame-relay cir in 2000000
 frame-relay mincir in 1000000
 frame-relay cir out 15000
 frame-relay mincir out 10000
 frame-relay bc in 15000
 frame-relay bc out 9600
 frame-relay be in 10000
 frame-relay be out 10000
 frame-relay idle-timer 30

Related Commands

Command
Description

frame-relay bc

Specifies the incoming or outgoing committed burst size (Bc) for a Frame Relay VC.

frame-relay cir

Specifies the incoming or outgoing CIR for a Frame Relay VC.


frame-relay broadcast-queue

To create a special queue for a specified interface to hold broadcast traffic that has been replicated for transmission on multiple data-link connection identifiers (DLCIs), use the frame-relay broadcast-queue command in interface configuration mode.

frame-relay broadcast-queue size byte-rate packet-rate

Syntax Description

size

Number of packets to hold in the broadcast queue.

byte-rate

Maximum number of bytes to be sent per second.

packet-rate

Maximum number of packets to be sent per second.


Defaults

size: 64 packets
byte-rate: 256000 bytes per second
packet-rate: 36 packets per second

Command Modes

Interface configuration

Command History

Release
Modification

10.3

This command was introduced.


Usage Guidelines

For purposes of the Frame Relay broadcast queue, broadcast traffic is defined as packets that have been replicated for transmission on multiple DLCIs. However, the broadcast traffic does not include the original routing packet or service access point (SAP) packet, which passes through the normal queue. Because of timing sensitivity, bridged broadcasts and spanning-tree packets are also sent through the normal queue. The Frame Relay broadcast queue is managed independently of the normal interface queue. It has its own buffers and a configurable service rate.

A broadcast queue is given a maximum transmission rate (throughput) limit measured in bytes per second and packets per second. The queue is serviced to ensure that only this maximum is provided. The broadcast queue has priority when transmitting at a rate below the configured maximum, and hence has a guaranteed minimum bandwidth allocation. The two transmission rate limits are intended to avoid flooding the interface with broadcasts. The actual limit in any second is the first rate limit that is reached.

Given the transmission rate restriction, additional buffering is required to store broadcast packets. The broadcast queue is configurable to store large numbers of broadcast packets.

The queue size should be set to avoid loss of broadcast routing update packets. The exact size will depend on the protocol being used and the number of packets required for each update. To be safe, set the queue size so that one complete routing update from each protocol and for each DLCI can be stored. As a general rule, start with 20 packets per DLCI. Typically, the byte rate should be less than both of the following:

N/4 times the minimum remote access rate (measured in bytes per second), where N is the number of DLCIs to which the broadcast must be replicated.

1/4 the local access rate (measured in bytes per second).

The packet rate is not critical if you set the byte rate conservatively. Set the packet rate at 250-byte packets.

Examples

The following example specifies a broadcast queue to hold 80 packets, to have a maximum byte transmission rate of 240000 bytes per second, and to have a maximum packet transmission rate of 160 packets per second:

frame-relay broadcast-queue 80 240000 160

frame-relay cir

To specify the incoming or outgoing committed information rate (CIR) for a Frame Relay virtual circuit, use the frame-relay cir command in map-class configuration mode. To reset the CIR to the default, use the no form of this command.

frame-relay cir {in | out} bps

no frame-relay cir {in | out} bps

Syntax Description

in | out

Incoming or outgoing.

bps

CIR in bits per second.


Defaults

56000 bits per second

Command Modes

Map-class configuration

Command History

Release
Modification

11.2

This command was introduced.


Usage Guidelines

Use this command to specify a CIR for an SVC. The specified CIR value is sent through the SETUP message to the switch, which then attempts to provision network resources to support this value.

Examples

The following example sets a higher committed information rate for incoming traffic than for outgoing traffic (which is going out on a slow WAN line):

frame-relay cir in 2000000
frame-relay cir out 9600

Related Commands

Command
Description

frame-relay bc

Specifies the incoming or outgoing committed burst size (Bc) for a Frame Relay VC.

frame-relay be

Sets the incoming or outgoing excess burst size (Be) for a Frame Relay VC.


frame-relay class

To associate a map class with an interface or subinterface, use the frame-relay class command in interface configuration mode. To remove the association between the interface or subinterface and the named map class, use the no form of this command.

frame-relay class name

no frame-relay class name

Syntax Description

name

Name of the map class to associate with this interface or subinterface.


Defaults

No map class is defined.

Command Modes

Interface configuration

Command History

Release
Modification

11.2

This command was introduced.


Usage Guidelines

This command can apply to interfaces or subinterfaces.

All relevant parameters defined in the name map class are inherited by each virtual circuit created on the interface or subinterface. For each virtual circuit, the precedence rules are as follows:

1. Use the map class associated with the virtual circuit if it exists.

2. If not, use the map class associated with the subinterface if the map class exists.

3. If not, use map class associated with interface if the map class exists.

4. If not, use the interface default parameters.

Examples

The following example associates the slow_vcs map class with the serial 0.1 subinterface and defines the slow_vcs map class to have an outbound CIR value of 9600:

interface serial 0.1
 frame-relay class slow_vcs

map-class frame-relay slow_vcs 
 frame-relay cir out 9600 

If a virtual circuit exists on the serial 0.1 interface and is associated with some other map class, the parameter values of the second map class override those defined in the slow_vc map class for that virtual circuit.

Related Commands

Command
Description

map-class frame-relay

Specifies a map class to define QoS values for an SVC.


frame-relay congestion threshold de

To configure the threshold at which discard-eligible (DE)-marked packets will be discarded from the traffic-shaping queue of a switched permanent virtual circuit (PVC), use the frame-relay congestion threshold de command in map-class configuration mode. To reconfigure the threshold, use the no form of this command.

frame-relay congestion threshold de percentage

no frame-relay congestion threshold de percentage

Syntax Description

percentage

Threshold at which DE-marked packets will be discarded, specified as a percentage of the maximum queue size.


Defaults

100%

Command Modes

Map-class configuration

Command History

Release
Modification

12.1(2)T

This command was introduced.


Usage Guidelines

The frame-relay congestion threshold de command applies only to default FIFO traffic-shaping queues.

You must enable Frame Relay switching using the frame-relay switching global command before Frame Relay congestion management parameters will be effective on switched PVCs.

Examples

The following example illustrates the configuration of the DE congestion threshold in the Frame Relay map class called "perpvc_congestion":

map-class frame-relay perpvc_congestion
 frame-relay congestion threshold de 50

Related Commands

Command
Description

frame-relay congestion-management

Enables Frame Relay congestion management functions on all switched PVCs on an interface, and enters congestion management configuration mode.

frame-relay congestion threshold ecn

Configures the threshold at which ECN bits are set on packets in the traffic-shaping queue of a switched PVC.

threshold de

Configures the threshold at which DE-marked packets are discarded from switched PVCs on the output interface.

threshold ecn

Configures the threshold at which ECN bits are set on packets in switched PVCs on the output interface.


frame-relay congestion threshold ecn

To configure the threshold at which explicit congestion notice (ECN) bits will be set on packets in the traffic-shaping queue of a switched permanent virtual circuit (PVC), use the frame-relay congestion threshold ecn command in map-class configuration mode. To reconfigure the threshold, use the no form of this command.

frame-relay congestion threshold ecn percentage

no frame-relay congestion threshold ecn percentage

Syntax Description

percentage

Threshold at which ECN bits will be set on packets, specified as a percentage of the maximum queue size.


Defaults

100%

Command Modes

Map-class configuration

Command History

Release
Modification

12.1(2)T

This command was introduced.


Usage Guidelines

The frame-relay congestion threshold ecn command applies only to default FIFO traffic-shaping queues.

One ECN threshold applies to all traffic on a traffic-shaping queue. You cannot configure separate thresholds for committed and excess traffic.

You must enable Frame Relay switching using the frame-relay switching global command before the frame-relay congestion threshold ecn command will be effective on switched PVCs.

Examples

The following example illustrates the configuration of the ECN congestion threshold in the Frame Relay map class called "perpvc_congestion":

map-class frame-relay perpvc_congestion
 frame-relay congestion threshold ecn 50

Related Commands

Command
Description

frame-relay congestion-management

Enables Frame Relay congestion management functions on all switched PVCs on an interface, and enters congestion management configuration mode.

frame-relay congestion threshold de

Configures the threshold at which DE-marked packets are discarded from the traffic-shaping queue of a switched PVC.

threshold de

Configures the threshold at which DE-marked packets are discarded from switched PVCs on the output interface.

threshold ecn

Configures the threshold at which ECN bits are set on packets in switched PVCs on the output interface.


frame-relay congestion-management

To enable Frame Relay congestion management functions on all switched permanent virtual circuits (PVCs) on an interface and to enter Frame Relay congestion management configuration mode, use the frame-relay congestion-management command in interface configuration mode. To disable Frame Relay congestion management, use the no form of this command.

frame-relay congestion-management

no frame-relay congestion-management

Syntax Description

This command has no arguments or keywords.

Defaults

Frame Relay congestion management is not enabled on switched PVCs.

Command Modes

Interface configuration

Command History

Release
Modification

12.1(2)T

This command was introduced.


Usage Guidelines

You must enable Frame Relay switching using the frame-relay switching global command before you can configure Frame Relay congestion management.

Frame Relay congestion management is supported only when the interface is configured with FIFO queueing, weighted fair queueing (WFQ), or PVC interface priority queueing (PIPQ).

Examples

In the following example, the frame-relay congestion-management command enables Frame Relay congestion management on serial interface 1. The command also enters Frame Relay congestion management configuration mode so that congestion threshold parameters can be configured.

interface serial1
 encapsulation frame-relay
 frame-relay intf-type dce
 frame-relay congestion-management
  threshold ecn be 0
  threshold ecn bc 20
  threshold de 40

Related Commands

Command
Description

frame-relay congestion threshold de

Configures the threshold at which DE-marked packets are discarded from the traffic-shaping queue of a switched PVC.

frame-relay congestion threshold ecn

Configures the threshold at which ECN bits are set on packets in the traffic-shaping queue of a switched PVC.

threshold de

Configures the threshold at which DE-marked packets are discarded from switched PVCs on the output interface.

threshold ecn

Configures the threshold at which ECN bits are set on packets in switched PVCs on the output interface.


frame-relay custom-queue-list

To specify a custom queue to be used for the virtual circuit queueing associated with a specified map class, use the frame-relay custom-queue-list command in map-class configuration mode. To remove the specified queueing from the virtual circuit and cause it to revert to the default first-come, first-served queueing, use the no form of this command.

frame-relay custom-queue-list list-number

no frame-relay custom-queue-list list-number

Syntax Description

list-number

Custom queue list number.


Defaults

If this command is not entered, the default queueing is first come, first served.

Command Modes

Map-class configuration

Command History

Release
Modification

11.2

This command was introduced.


Usage Guidelines

Use the queue-list commands to define the custom queue.

Only one form of queueing can be associated with a particular map class; subsequent definitions overwrite previous ones.

Examples

The following example configures a custom queue list for the "fast_vcs" map class:

map-class frame-relay fast_vcs
 frame-relay custom-queue-list 1

queue-list 1 queue 4 byte-count 100

Related Commands

Command
Description

map-class frame-relay

Specifies a map class to define QoS values for an SVC.


frame-relay de-group

To specify the discard eligibility (DE) group number to be used for a specified data-link connection identifier (DLCI), use the frame-relay de-group command in interface configuration mode. To disable a previously defined group number assigned to a specified DLCI, use the no form of this command with the relevant keyword and arguments.

frame-relay de-group group-number dlci

no frame-relay de-group [group-number] [dlci]

Syntax Description

group-number

DE group number to apply to the specified DLCI number, from 1 to 10.

dlci

DLCI number.


Defaults

No DE group is defined.

Command Modes

Interface configuration

Command History

Release
Modification

10.0

This command was introduced.


Usage Guidelines

To disable all previously defined group numbers, use the no form of this command with no arguments.

This command requires that Frame Relay be enabled.

Frame Relay DE group functionality is supported on process-switched packets only.

The DE bit is not set or recognized by the Frame Relay switching code, but must be recognized and interpreted by the Frame Relay network.


Note Frame Relay DE group functionality is being replaced by the Modular QoS CLI (MQC) DE marking functionality. For information about the MQC commands that are used to configure Frame Relay DE marking, refer to the Cisco IOS Quality of Service Configuration Guide and Cisco IOS Quality of Service Command Reference.


Examples

The following example specifies that group number 3 will be used for DLCI 170:

frame-relay de-group 3 170

Related Commands

Command
Description

frame-relay de-list

Defines a DE list specifying the packets that have the DE bit set and thus are eligible for discarding during congestion on the Frame Relay switch.


frame-relay de-list

To define a discard eligibility (DE) list specifying the packets that have the DE bit set and thus are eligible for discarding when congestion occurs on the Frame Relay switch, use the frame-relay de-list command in global configuration mode. To delete a portion of a previously defined DE list, use the no form of this command.

frame-relay de-list list-number {protocol protocol | interface type number} characteristic

no frame-relay de-list list-number {protocol protocol | interface type number} characteristic

Syntax Description

list-number

Number of the DE list.

protocol protocol

One of the following values corresponding to a supported protocol or device:

arp—Address Resolution Protocol.
appletalk—AppleTalk.
bridge—bridging device.
clns—ISO Connectionless Network Service.
clns_es—CLNS end systems.
clns_is—CLNS intermediate systems.
compressedtcp—Compressed TCP.
decnet—DECnet.
decnet_node—DECnet end node.
decnet_router-L1—DECnet Level 1 (intra-area) router.
decnet_router-L2—DECnet Level 2 (interarea) router.
ip—Internet Protocol.
ipx—Novell Internet Packet Exchange Protocol.

interface type

One of the following interface types: serial, null, or ethernet.

number

Interface number.

characteristic

One of the following values:

fragments—Fragmented IP packets
gt bytes—Sets the DE bit for packets larger than the specified number of bytes (including the 4-byte Frame Relay encapsulation).
list access-list-number—Previously defined access list number.
lt bytes—Sets the DE bit for packets smaller than the specified number of bytes (including the 4-byte Frame Relay encapsulation).
tcp port—TCP packets to or from a specified port.
udp port—User Datagram Protocol (UDP) packets to or from a specified port.


Defaults

Discard eligibility is not defined.

Command Modes

Global configuration

Command History

Release
Modification

10.0

This command was introduced.

12.2(13)T

The apollo, vines, and xns arguments were removed because Apollo Domain, Banyan VINES, and Xerox Network Systems are no longer available in the Cisco IOS software.


Usage Guidelines

To remove an entire DE list, use the no form of this command with no options and arguments.

This prioritizing feature requires that the Frame Relay network be able to interpret the DE bit as indicating which packets can be dropped first in case of congestion, or which packets are less time sensitive, or both.

When you calculate packet size, include the data packet size, the ICMP header, the IP header, and the Frame Relay encapsulation bytes. For example, count 92 bytes of data, 8 bytes for the ICMP header, 20 bytes for the IP header, and 4 bytes for the Frame Relay encapsulation, which equals 124 bytes.

Examples

The following example specifies that IP packets larger than 512 bytes (including the 4-byte Frame Relay encapsulation) will have the DE bit set:

frame-relay de-list 1 protocol ip gt 512

frame-relay end-to-end keepalive error-threshold

To modify the keepalive error threshold value, use the frame-relay end-to-end keepalive error-threshold command in map-class configuration mode. To reset the error threshold value to its default, use the no form of this command.

frame-relay end-to-end keepalive error-threshold {send | receive} count

no frame-relay end-to-end keepalive error-threshold {send | receive}

Syntax Description

send

Number of send-side errors in the event window before keepalive status goes from up to down.

receive

Number of receive-side errors in the event window before keepalive status goes from up to down.

count

Number of errors required. The maximum value is 32.


Defaults

The default value for both the send and receive error threshold is 2.

Command Modes

Map-class configuration

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

The send-side value can be configured only in bidirectional and request modes. The receive-side value can be configured only in bidirectional and reply modes. See the frame-relay end-to-end keepalive mode command. When you configure the error threshold, also configure the event window. See the frame-relay end-to-end keepalive event-window command.

Examples

The following example shows increasing the receive-side error threshold to 4 and changing the event window to 7:

map-class frame-relay olga
  frame-relay end-to-end keepalive reply
  frame-relay end-to-end keepalive error-threshold receive 4
  frame-relay end-to-end keepalive event-window receive 7

Related Commands

Command
Description

frame-relay end-to-end keepalive event-window

Modifies the keepalive event window value.

frame-relay end-to-end keepalive mode

Enables Frame Relay end-to-end keepalives.

frame-relay end-to-end keepalive success-events

Modifies the keepalive success events value.

frame-relay end-to-end keepalive timer

Modifies the keepalive timer.

map-class frame-relay

Specifies a map class to define QoS values for an SVC.

show frame-relay end-to-end keepalive

Displays statistics about Frame Relay end-to-end keepalive.


frame-relay end-to-end keepalive event-window

To modify the keepalive event window value, use the frame-relay end-to-end keepalive event-window command in map-class configuration mode. To reset the event window size to the default, use the no form of this command.

frame-relay end-to-end keepalive event-window {send | receive} size

no frame-relay end-to-end keepalive event-window {send | receive}

Syntax Description

send

Send-side event window for which size is being configured.

receive

Receive-side event window for which size is being configured.

size

Number of events in the event window. The maximum value is 32.