ATM Switch Router Command Reference, 12.0(13)W5(19) through 12.0(22)W5(25)
F Commands

Table of Contents

F Commands
facility-alarm (Catalyst 8540 MSR)
failed-attempts
fdl (Catalyst 8510 MSR and LightStream 1010)
format
frame-relay bc-default
frame-relay connection-traffic-table-row
frame-relay input-queue
frame-relay intf-type
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
frame-relay output-queue
frame-relay overbooking
frame-relay pvc
frame-relay soft-vc
frame-relay upc-intent
framing (controller)
framing (interface)

F Commands


The commands shown in this chapter apply to the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. Where an entire command or certain attributes of a command have values specific to a particular switch or switch router, an exception is indicated by the following callouts:

  • Catalyst 8540 MSR
  • Catalyst 8510 MSR and LightStream 1010

  • Note   Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter.


    Note   Commands that no longer function as expected in ATM environments have also been removed from this chapter.

Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.

facility-alarm (Catalyst 8540 MSR)

To configure the temperatures so that the ATM switch router declares a major or minor alarm condition, use the facility-alarm command. You can configure explicit threshold temperatures
(in degrees Celsius [° C]) to override the defaults for major and minor alarms. Use the no form of this command to disable alarms for that threshold and reset the threshold to the default value.

facility-alarm core-temperature {major [temperature] | minor [temperature]}
no facility-alarm core-temperature {major [temperature] | minor [temperature]}

Syntax Description

major [temperature]

Major alarm threshold temperature threshold in degrees C.
The default value is 53° C.

minor [temperature]

Minor alarm threshold temperature threshold in degrees C.
The default value is 45° C.

Defaults

major is 53° C.
minor is 45° C.

Command Modes

Global configuration

Command History

Release  Modification 

12.0(3c)W5(9)

New command

Usage Guidelines

You cannot disable or adjust the system critical alarms threshold. A "critical" alarm is standard Telco terminology for the alarm just before the system powers itself off.

Examples

The following example shows how to configure facility alarms to 50° C for major alarms, and 38° C for minor alarms.

Switch(config)# facility-alarm core-temperature major 50
Switch(config)# facility-alarm core-temperature minor 38

Related Commands

Command  Description 

clear facility-alarm (Catalyst 8540 MSR)

Clears alarm conditions and resets the alarm contacts.

show facility-alarm status (Catalyst 8540 MSR)

Displays the current major and minor alarm status, if any, and displays the configuration of the alarm thresholds.

failed-attempts

To configure the writing of records for initial connection attempts, use the failed-attempts ATM accounting file subcommand. To disable this feature, use the no form of this command.

failed-attempts [none | [regular | soft]]
no failed-attempts

Syntax Description

none

Does not record failed attempts.

regular

Records regular SVC/SVP numbers that originate or terminate at the switch router interface.

soft

Records soft PVC/PVP numbers that originate or terminate at the switch router interface.

Defaults

regular and soft

Command Modes

ATM accounting file

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Examples

The following example shows entering the ATM accounting file configuration mode and configuring failed-attempts to record failed attempts for SVC/SVP connections in the accounting file.

Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)# failed-attempts regular

Related Commands

Command  Description 

atm accounting file

Enables an ATM accounting file and employs the accounting file configuration mode.

collection-modes

Initializes the collection mode and specifies at what time accounting data is recorded in the accounting file.

min-age

Configures the value of the minimum age of the VC for on-release or periodic collection of accounting records.

fdl (Catalyst 8510 MSR and LightStream 1010)

To enable the FDL capability provided on the T1 board, use the fdl interface configuration command. To restore the default, use the no form of this command.

fdl {ansi | att}
no fdl

Syntax Description

ansi

Enables ANSI mode for FDL queries from the remote end.

att

Enables ATT mode for FDL queries from the remote end.

Defaults

Both ansi and att are disabled.

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(4a)W5(11a)

New command

Usage Guidelines

The T1 board responds to requests in both ANSI and ATT format, but is only able to gather the remote end data in ANSI format. The T1 board complies to ANSI standard T1.403

FDL packets are used to collect data from the remote end. To enable the FDL capability, it is necessary to know whether the remote end supports FDL functionality.

The mode selected depends upon which mode is supported on the remote end.

Examples

The following example shows how to enable FDL capabilities in both ANSI and ATT mode.

Switch(Config)# interface atm 0/1/0
Switch(Config-if)# fdl ansi
Switch(Config)# interface atm 0/1/0
Swith(Config-if)# fdl att

The following example shows how to disable FDL capabilities in both ANSI and ATT mode.

Switch(Config)# interface atm 0/1/0
Switch(Config-if)# no fdl ansi
Switch(Config)# interface atm 0/1/0
Swith(Config-if)# no fdl att

Related Commands

None

format

To format Flash memory, use the format privileged EXEC command.

format device1: [[device2:] [monlib-filename]]

Caution    The following formatting procedure erases all information in the Flash memory. To prevent the loss of important data, proceed carefully.

Syntax Description

device1:

Device to format. The colon (:) is required. Valid devices are as follows:

  • bootflash: This device is the internal Flash memory.
  • slot0: This device is the first PC slot on the route processor card.
  • slot1: This device is the second PC slot on the route processor card.

device2:

Device containing the monlib file to use for formatting device1. The colon (:) is required. Valid devices are as follows:

  • bootflash: This device is the internal Flash memory.
  • slot0: This device is the first PC slot and is the initial default device.
  • slot1: This device is the second PC slot on the route processor card.

monlib-filename

Name of the ROM monitor library file (monlib file) to use for formatting device1. The default monlib file is the one bundled with the system software.

Defaults

The default monlib file is the one bundled with the system software.

Command Modes

Privileged EXEC

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

Use the format command to format internal Flash memory (bootflash) or your Flash memory cards.

In some cases, you might need to insert a new PCMCIA Flash memory card and load images or backup configuration files onto it. Before you can use a new Flash memory card, you must format it.

Flash memory cards have sectors that can fail. You can reserve certain Flash memory sectors as "spares" for use when other sectors fail. Use the format command to specify between 0 and 16 sectors as spares. If you reserve a small number of spare sectors for emergencies, you do not waste space because you can use most of the Flash memory card. If you specify zero spare sectors and some sectors fail, you must reformat the Flash memory card and thereby erase all existing data.

The monlib file is the ROM monitor library. The ROM monitor uses the monlib file to access files in the Flash file system.

In the command syntax, device1 is the device to format, and device2 contains the monlib file to use. When you omit the [[device2:][monlib-filename]] argument, the system formats device1 using the monlib file that is bundled with the system software. When you omit device2 from the [[device2:][monlib-filename]] argument, the system formats device1 using the named monlib file from the device specified by the cd command. When you omit monlib-filename from the [[device2:][monlib-filename]] argument, the system formats device1 using device2's monlib file. When you specify the whole [[device2:][monlib-filename]] argument, the system formats device1 using the specified monlib file from the specified device. Note that you can specify device1's own monlib file in this argument. When the system cannot find a monlib file, the system terminates the formatting process.

Examples

The following example shows the format command that formats a Flash memory card inserted in slot 0 of the route processor card.

Switch# format slot0:
Running config file on this device, proceed? [confirm]y
All sectors will be erased, proceed? [confirm]y
Enter volume id (up to 31 characters): <Return>
Formatting sector 1 (erasing)
Format device slot0 completed

When the switch returns you to the EXEC prompt, the new Flash memory card is successfully formatted and ready for use.

Related Commands

Command  Description 

copy flash

Copies a file from Flash memory to another destination.

dialer-list list

This command or some of its parameters might not function as expected.

frame-relay bc-default

To configure the committed burst size for ABR or UBR soft VCs terminating on an interface, use the frame-relay bc-default interface configuration command. To disable the committed burst size, use the no form of this command.

frame-relay bc-default bc_default
no frame-relay bc-default

Syntax Description

bc_default

Default committed burst size in bits for ABR or UBR soft VCs terminating on this interface.

Defaults

32768

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

Use the frame-relay bc-default interface parameter to configure the committed burst size
(in bits) on the destination interface of a UBR or ABR soft VC connection.

The configured committed burst size is then effective for any subsequent connections.

Examples

The following example shows how to configure the Frame Relay committed burst size to 16384 for serial interface 11/0/0:1.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay bc-default 16384

Related Commands

Command  Description 

show frame-relay connection-traffic-table-row

Displays the Frame Relay traffic table.

frame-relay connection-traffic-table-row

To create a table entry in the Frame Relay connection-traffic table, use the frame-relay connection-traffic table-row global configuration command. To delete an entry, use the no form of this command.

frame-relay connection-traffic table-row [index row-index] cirval bcval pirval [beval]
{
abr | vbr-nrt | ubr} [arrow-index]
no frame-relay connection-traffic table-row [index row-index]

Syntax Description

index row-index

Specifies the index of the entry created in the Frame Relay connection-traffic table. A positive integer from 1 to 1073741823.

cirval

CIR, in bps. A positive integer from 0 to 2048000.

bcval

Bc, in bits. A positive integer from 0 to 32768.

pirval

Peak information rate, in bps. A positive integer from 0 to 2048000.

beval

Excess burst size, in bits. A positive integer from 0 to 32768.
The default is 32768.

abr | vbr-nrt | ubr

Selects the ATM service category for an interworking connection.

arrow-index

Specifies the index of the entry created in the ATM connection-traffic table,
a positive integer from 1 to 1073741823.

Defaults

See "Syntax Description."

Command Modes

Global configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

When you create a connection traffic table row, the Frame Relay parameters are converted into the ATM equivalent parameters and a row is added to the ATM connection-traffic table. The table index values are shared by the Frame Relay connection table and the ATM connection table. If you specify the index in the command, the index value is available in the ATM connection table.


Note   Since the index value is linked to the ATM connection-traffic table, the index values in the Frame Relay connection-traffic table might not be contiguous.

Examples

The following example shows how to create a table entry with a row index of 150, committed information rate of 1024000, committed burst size of 16334, peak information rate of 1024000, excess burst size of 20, and the abr service category with an ATM row index of 250.

Switch# configure terminal
Switch(config)# frame-relay connection-traffic-table-row index 150 1024000 16334 1024000 16334 20 abr 250

Related Commands

Command  Description 

show frame-relay connection-traffic-table-row

Displays the Frame Relay traffic table.

frame-relay input-queue

To configure discard marking thresholds on a Frame Relay interface in the input direction, use the frame-relay input queue interface configuration command. Use the no form of the command to revert to default values for the threshold.

frame-relay input-queue {abr | ubr | vbr-nrt} {discard-threshold |
marking-threshold} percent
no frame-relay input-queue {abr | ubr | vbr-nrt} {discard-threshold |
marking-threshold} percent

Syntax Description

abr | ubr | vbr-nrt

Service categories for which the threshold is configured

discard-threshold

Threshold where the cell is discarded. If the queue fills up above this level, any frame arriving from an external device with the DE bit set is discarded by the interface. The default is 87 percent.

marking-threshold

Threshold where the cell is marked for EFCI. If the queue fills up above this level, all frames arriving from an external device have the EFCI bit set as they are converted into cells. For cells entering the Frame Relay interface from the switch fabric, the BECN bit is set in the outgoing frame header. The default is 75 percent.

percent

Threshold number as percent of queue size.

Defaults

See "Syntax Description."

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

This command affects all existing connections on the interface, as well as subsequent connections.

Examples

The following example sets the Frame Relay input queue for ABR connects to allow EFCI marking for cells over 75 percent of capacity.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay input-queue abr marking-threshold 75

Related Commands

Command  Description 

show frame-relay connection-traffic-table-row

Displays the Frame Relay traffic table.

frame-relay output-queue

Configures discard marking thresholds on a Frame Relay interface in the output direction.

frame-relay intf-type

To configure an interface as DCE or NNI, use the frame-relay intf-type interface configuration command. To disable the configuration, use the no form of this command.

frame-relay intf-type {dce | nni}
no frame-relay intf-type {dce | nni}

Syntax Description

dce

Data communications equipment.

nni

Network-to-Network Interface.

Defaults

nni

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

When you specify DCE, the ATM switch router supports only network-side PVC status
management procedures. When you specify NNI, the ATM switch router supports both user-side
and network-side PVC status management procedures.


Note   Frame Relay DTE is not supported.

Examples

The following example configures serial interface 11/0/0:1 as Frame Relay interface, type DCE.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay intf-type dce

Related Commands

Command  Description 

show frame-relay interface resource

Displays the current resource allocation on a Frame Relay interface.

frame-relay lmi-n391dte

To set a full status polling interval, use the frame-relay lmi-n391dte interface configuration command. To restore the default interval value, use the no form of this command.

frame-relay lmi-n391dte keep-exchanges
no frame-relay lmi-n391dte keep-exchanges

Syntax Description

keep-exchanges

Number of keep exchanges to be completed before requesting a full status message. The value must be a positive integer from 1 to 255.

Defaults

6 keep exchanges

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

To set the full status message polling interval, use this command when the interface is configured
as NNI.

Examples

The following example shows how to set one out of every four status inquiries to request a full status response from the switch. The remaining three status inquiries request only keepalive exchanges.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay intf-type nni
Switch(config-if)# frame-relay lmi-n391dte 4

Related Commands

Command  Description 

show frame-relay lmi

Displays LMI specific status for an interface.

frame-relay lmi-n392dce

To set the error threshold on DCE and NNI interfaces, use the frame-relay lmi-n392dce interface configuration command. To remove the setting, use the no form of this command.

frame-relay lmi-n392dce threshold
no frame-relay lmi-n392dce threshold

Syntax Description

threshold

Error threshold value. The value must be a positive integer from 1 to 10.

Defaults

Two errors

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

N392 errors must occur within the number defined by the N393 event count for the link to be down. Therefore, the threshold value for this command must be less than the count value defined in the frame-relay lmi-n393dce command.

Examples

The following example configures serial interface 11/0/0:1 with Frame Relay LMI monitoring event count to four.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay lmi-n392dce 4

Related Commands

Command  Description 

frame-relay lmi-n393dce

Sets the monitored events count on DCE and NNI interfaces.

show frame-relay lmi

Displays LMI specific status for an interface.

frame-relay lmi-n392dte

To set the error threshold on DTE or NNI interfaces, use the frame-relay lmi-n392dte interface configuration command. To remove the setting, use the no form of this command.

frame-relay lmi-n392dte threshold
no frame-relay lmi-n392dte threshold

Syntax Description

threshold

Error threshold value. This value must be a positive integer from 1 to 10.

Defaults

Three errors

Command Modes

Interface configuration

Command History

Release  Modification 

TBD

 

 

 

Usage Guidelines

The frame-relay lmi-n392dte and frame-relay lmi-n393dte commands define the condition that causes the link to be declared down. Two "threshold" errors must occur within N393 number of events for the link to be declared down.

Examples

The following example shows how to set the LMI error threshold to six.

Switch# configure terminal
Switch(config)# interface serial 1/0/0:1
Switch(config-if)# frame-relay intf-type nni
Switch(config-if)# frame-relay lmi-n392dte 6

Related Commands

Command  Description 

show frame-relay lmi

Displays LMI specific status for an interface.

frame-relay lmi-n393dce

To set the monitored events count on DCE and NNI interfaces, use the frame-relay lmi-n393dce interface configuration command. To remove the setting, use the no form of this command.

frame-relay lmi-n393dce events
no frame-relay lmi-n393dce events

Syntax Description

events

Monitored events count value. The value must be a positive integer from 1 to 10.

Defaults

Two events

Command Modes

Interface configuration

Command History

Release  Modification 

TBD

 

 

 

Usage Guidelines

This command and the frame-relay lmi-n392dce command define the condition that causes the link to be down. In the Cisco implementation, N392 errors must occur within the events count for the link to be down. Therefore, the events value that you define for this command must be greater than the threshold value defined in the frame-relay lmi-n392dce command.

Examples

The following example shows how to set the LMI monitored event count to three.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay intf-type dce
Switch(config-if)# frame-relay lmi-n393dce 3

Related Commands

Command  Description 

show frame-relay lmi

Displays LMI specific status for an interface.

frame-relay lmi-n393dte

To set the monitored event count on DTE and NNI interfaces, use the frame-relay lmi-n393dte interface configuration command. To remove the setting, use the no form of this command.

frame-relay lmi-n393dte events
no frame-relay lmi-n393dte events

Syntax Description

events

Monitored events count value. This value must be a positive integer from 1 to 10.

Defaults

Four events

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

The frame-relay lmi-n393dte and the frame-relay lmi-n392dte commands define the condition that causes the link to be declared down. N392 errors must occur within the events count for the link to be declared down.


Note   The events value defined in this command must be greater than the threshold value defined in the frame-relay lmi-n392dte command.

Examples

The following example shows how to set the LMI monitored events count to three.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay intf-type NNI
Switch(config-if)# frame-relay lmi-n393dte 3

Related Commands

Command  Description 

show frame-relay lmi

Displays LMI specific status for an interface.

frame-relay lmi-t392dce

To set the polling verification timer on DCE and NNI interfaces, use the frame-relay lmi-t392dce interface configuration command. To remove the current setting, use the no form of this command.

frame-relay lmi-t392dce seconds
no frame-relay lmi-t392dce seconds

Syntax Description

seconds

Polling verification timer value, in seconds. This value must be a positive integer from 5 to 30.

Defaults

15 seconds

Command Modes

Interface configuration

Command History

Release  Modification 

TBD

 

 

 

Usage Guidelines

The value for the timer must be greater than the DTE or NNI keepalive timer.

Examples

The following example shows how to set a polling verification timer on a DCE or NNI interface set to 20 seconds.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay intf-type dce
Switch(config-if)# frame-relay lmi-t392dce 20

Related Commands

Command  Description 

show frame-relay lmi

Displays LMI specific status for an interface.

frame-relay lmi-type

To select the LMI type, use the frame-relay lmi-type interface configuration command. To return to the default LMI type, use the no form of this command.

frame-relay lmi-type [ansi | cisco | q933a]
no frame-relay lmi-type [ansi | cisco | q933a]

Syntax Description

ansi

Annex D defined by the ANSI standard T1.617.

cisco

The LMI type defined jointly by Cisco Systems and three other companies.

q933a

ITU-T Q.933 Annex A.

Defaults

cisco

Command Modes

Interface configuration

Command History

Release  Modification 

11.4(1)

New command

Usage Guidelines

The LMI type is set on a per-interface basis. If you want to display the type that is configured,
use the show interfaces EXEC command.

Examples

The following example shows how to configure an interface for the ANSI LMI type.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# encapsulation frame-relay ietf
Switch(config-if)# frame-relay lmi-type ansi
Switch(config-if)# keepalive 15

Related Commands

Command  Description 

show frame-relay lmi

Displays LMI specific status for an interface.

show ima interface

Displays the IMA interface, IMA group, and ATM layer hardware configuration.

frame-relay output-queue

To configure discard marking thresholds on a Frame Relay interface in the output direction, use
the frame-relay output-queue interface configuration command. To restore tthe default values for the threshold, use the no form of this command .

frame-relay output-queue {abr | ubr | vbr-nrt} {discard-threshold | marking-threshold} percentage
no frame-relay output-queue {abr | ubr | vbr-nrt} {discard-threshold | marking-threshold} percentage

Syntax Description

abr | ubr | vbr-nrt

Service categories for which the threshold is configured:

  • ABR
  • UBR
  • VBR-NRT

discard-threshold

Threshold where the cell is discarded. If the queue fills above this level, any frame arriving from the switch router with DE bit set is discarded by the interface.

The default is 87 percent.

marking-threshold

Threshold where the cell is marked for EFCI. If the queue fills above this level, all frames arriving from the switch router will have the FECN bit set in the frame header as they exit the interface.

For cells entering the Frame Relay interface from an external device, the BECN bit is set in the frame header as it enters the switch.

The default is 75 percent.

percentage

Percentage number.

Defaults

See "Syntax Description."

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(1a)W5(5b)

New command

Usage Guidelines

This command affects all existing connections on the interface, as well as subsequent connections.

Examples

The following example shows how to set the Frame Relay output queue for ABR connects to allow EFCI marking for cells over 65 percent of capacity.

Switch# configure terminal
Switch(config)# interface serial 11/0/0:1
Switch(config-if)# frame-relay output-queue abr marking-threshold 65

Related Commands

Command  Description 

frame-relay input-queue

Configures discard marking thresholds on a Frame Relay interface in the input direction.

show frame-relay interface resource

Displays the current resource allocation on a Frame Relay interface.

frame-relay overbooking

To set the percentage of CIR overbooking, use the frame-relay overbooking command. To disable CIR overbooking, use the no form of this command.

frame-relay overbooking percent
no frame-relay overbooking

Syntax Description

percent

The percent of interface bandwidth from 101 to 1000.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(3c)W5(9)

New command

Usage Guidelines

The allowable overbooking on an access link or interface is a number times the access link or interface speed (access rate), for example, 200 percent of the access rate. The total of all CIRs for all Frame Relay PVCs and Frame Relay soft VCs cannot exceed the CIR overbooking factor times the access rate.

Once configured and used to admit Frame Relay PVCs and Frame Relay soft VCs on an interface, the CIR overbooking factor can only be adjusted within the upper limit and the level which has been overbooked by the existing connections. Disabling the CIR overbooking factor is allowed only when the total of all CIRs for all Frame Relay PVCs and Frame Relay soft VCs does not exceed the interface access rate.

Configuring the CIR overbooking factor increases the available bit rates for the Frame Relay PVC and soft VC but does not increase the actual bandwidth (access rate) and resources available to the Frame Relay interface.

The CIR of a connection is not allowed to ex