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
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 theno 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.
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.
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 configurationcommand. To disable the committed burst size, use the no form of this command.
frame-relay bc-defaultbc_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.
To create a table entry in the Frame Relay connection-traffic table, use the frame-relay connection-traffic table-row global configurationcommand. To delete an entry, use the no form of this command.
no frame-relay connection-traffic table-row [indexrow-index]
Syntax Description
indexrow-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
To configure discard marking thresholds on a Frame Relay interface in the input direction, use the frame-relay input queue interface configurationcommand. Use the no form of the command to revert to default values for the threshold.
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
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 configurationcommand. 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.
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 configurationcommand. To restore the default interval value, use the no form of this command.
frame-relay lmi-n391dtekeep-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.
To set the error threshold on DCE and NNI interfaces, use the frame-relay lmi-n392dce interface configurationcommand. To remove the setting, use the no form of this command.
frame-relay lmi-n392dcethreshold
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.
To set the error threshold on DTE or NNI interfaces, use the frame-relay lmi-n392dte interface configurationcommand. To remove the setting, use the no form of this command.
frame-relay lmi-n392dtethreshold
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.
To set the monitored events count on DCE and NNI interfaces, use the frame-relay lmi-n393dce interface configurationcommand. To remove the setting, use the no form of this command.
frame-relay lmi-n393dceevents
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.
To set the monitored event count on DTE and NNI interfaces, use the frame-relay lmi-n393dte interface configurationcommand. To remove the setting, use the no form of this command.
frame-relay lmi-n393dteevents
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.
To set the polling verification timer on DCE and NNI interfaces, use the frame-relay lmi-t392dce interface configurationcommand. To remove the current setting, use the no form of this command.
frame-relay lmi-t392dceseconds
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.
To select the LMI type, use the frame-relay lmi-type interface configurationcommand. 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.
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 configurationcommand. To restore tthe default values for the threshold, use the no form of this command .
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
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 exceed the actual access rate of an interface even if the CIR overbooking factor is configured.
Note You should have a thorough understanding of network traffic patterns when using the
frame relay overbooking command. Excess traffic arriving at an overbooked Frame
Relay interface might lead to discarded or DE tagged frames.
Examples
The following example configures the Frame Relay serial interface to allow overbooking the CIR to 200 percent.
Displays the current resource allocation on a Frame Relay interface.
frame-relay pvc
To create a Frame Relay-to-ATM network interworking or service interworking PVC or Frame-Relay- to-Frame Relay cross-connected PVC, use the frame-relay pvc interface configuration command. To remove a Frame Relay PVC, use the no form of this command.
For Frame Relay-to-ATM network interworking, use the following syntax:
Data-link connection identifier, ranging from 16 to 1007, which specifies a PVC in a Frame Relay network.
upcupc
Usage parameter control, specified as pass or tag-drop. The default is pass, which derives from the per-interface default value configured through the frame-relay upc-intent command.
rx-cttrindex
Frame Relay connection-traffic table row index in the received direction. The default is 100.
tx-cttrindex
Frame Relay connection-traffic table row index in the transmitted direction. The default is 100.
network | service {transparent | translation}
Specifies the interworking function that can be either network interworking, service interworking in transparent mode, or service interworking in translation mode.
clp-bit {0 | 1 | map-de}
Sets the mode of DE/CLP mapping in Frame Relay to the ATM direction. Options 0, 1, or map-DE are allowed for both network interworking and service interworking. The default is map-de.
map-de—Specifies mode 1, described in 4.2.1 of FRF.8: "The DE field in the Q.922 core frame shall be mapped to the ATM CLP field of every cell generated by the segmentation process of the AAL5 PDU containing the information of that frame." Similarly, it applies to mode 1 of 4.4.1 of FRF.5.
0 or 1—Specifies mode 2, described in 4.2.1 of FRF.8: "The ATM CLP of every ATM cell generated by the segmentation process of the AAL5 PDU containing the information of that frame shall be set to a constant value (either 0 or 1) configured at service subscription time." Similarly, it applies to mode 2 of 4.4.1 of FRF.5.
de-bit [0 | 1 | map-de | map-clp | map-clp-or-de]
Sets the mode of CLP/DE mapping in ATM to the Frame Relay direction.
For network interworking:
Options map-de, or map-clp-or-de are allowed. The default value is map-clp-or-de.
map-clp-or-de—Specifies mode 1 described in 4.4.2 of FRF.5: "If one or more ATM cells belonging to a frame has its CLP field set to 1 or if the DE field of the FR-SSCS PDU is set to 1, the IWF shall set the DE field of the Q.922 core frame."
map-de—Specifies mode 2 described in 4.4.2 of FRF.5: "No mapping is performed from the ATM layer to Q.922 core layer. The FR-SSCS PDU DE field is copied unchanged to the Q.922 core frame DE field, independent of CLP indication(s) received at the ATM layer."
For service interworking:
Options 0, 1, or map-clp are allowed. The default value is map-clp.
map-clp—Specifies mode 1, described in 4.2.2 of FRF.8: "If one or more cells belonging to a frame has its CLP field set, the IWF shall set the DE field of the Q.922 Core frame."
0 or 1—Specifies mode 2, described in 4.2.2 of FRF.8: "The DE field of the Q.922 Core frame shall be set to a constant value (either 0 or 1) configured at service subscription time."
card/subcard/port
Card, subcard, and port number for the ATM interface.
vpi
VPI of this PVC, from 0 to 255. The VPI is an 8-bit field in the header of the ATM cell. The VPI value is unique only on an interface, not throughout the ATM network (it has local significance only).
vci
VCI of this PVC. The range is normally 32 to 16383, but can be expanded from 5 to 16383 in manual-well-known-vc mode. The VCI is a 16-bit field in the header of the ATM cell. The VCI value is unique only on a single interface, not throughout the ATM network (it has local significance only).
pd {off | on}
Specifies the intelligent packet discard option as on or off. The default is off.
efci-bit {0 | map-fecn}
Sets the mode of FECN/EFCI mapping in Frame Relay to the ATM direction. The default value is 0.
card/subcard/port:cgn
Card, subcard, port number, and channel group number for the serial interface.
encap {aal5mux ip | aal5snap}
AAL encapsulation type applies only to terminating connections. (For service interworking connections only.)
aal5snap— LLC/SNAP precedes the protocol datagram. This is the only encapsulation supported for Inverse ARP. (For translation mode only.)
inarpminutes
Specifies how often Inverse ARP datagrams are sent on this virtual connection and applies only to terminating connections. (For service interworking translation mode only.) The default value is 15 minutes.
Defaults
See "Syntax Description."
Command Modes
Interface configuration
Command History
Release
Modification
12.0(1a)W5(5b)
New command
Usage Guidelines
You can set the upc option to tag or drop only under the following conditions:
The ATM interface in UNI is on the network side.
The ATM interface is not the route processor port (ATM 0) or a logical port (VP tunnel).
The connection is not the leaf of a point-to-multipoint connection.
The following example creates a service translation cross-connection between Frame Relay interface 11/0/0:1 on PVC 66 and ATM interface 10/0/0 100 250.
Displays active virtual circuits (PVCs, SVCs, and soft VCs).
frame-relay soft-vc
To create Frame Relay soft PVCs on the switch router, use the frame-relay soft-vc interface configuration command. You can use this command to create soft PVCs between two Frame Relay connections or between a Frame Relay connection and an ATM connection.
To create a soft PVC between two Frame Relay connections, use the following syntax:
For existing Frame Relay soft PVCs, you can enable or disable the connection and use the redo-explicit keyword to respecify the explicit-path configuration.
To remove Frame Relay soft PVCs, use the no form of this command.
no frame-relay soft-vc dlci-a
Syntax Description
dlci_a
Specifies the data-link connection identifier, ranging from 16 to 1007, which specifies a PVC in a Frame Relay network.
dest-addressaddress
Specifies the destination address.
dlcidlci_b
Specifies the data-link connection identifier, ranging from 16 to 1007, which specifies a PVC in a Frame Relay network.
vbi_b
ATM virtual path identifier.
vci_b
ATM virtual channel identifier.
upcupc
Usage parameter control, specified as pass |tag-drop. It gets its default value from the per-interface default value configured with the frame-relay upc-intent command.
rx-cttrindex
Connection traffic table row index in the received direction. The default is 100.
The cttr should be configured before using the atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the rx-cttr.
tx-cttrindex
Connection traffic table row index in the transmitted direction. The default is 100.
The cttr should be configured before using the atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the tx-cttr.
pd {on |off}
Specifies the intelligent packet discard option as on or off. The default is off.
retry-interval
Configures retry interval timers for a soft PVC.
first retry-interval
Retry interval for the first retry after the first failed attempt, specified in milliseconds.
If the first retry after the first failed attempt also fails, the subsequent attempts are made at intervals computed using the firstretry-interval, as follows:
(2 ** (k-1)) * first retry-interval
Where the value of k is 1 for the first retry after the first failed attempt and is incremented by 1 for every subsequent attempt.
Range is from 100 to 3600000 milliseconds; the default is 5000 milliseconds.
maximum retry-interval
The maximum retry interval between any two attempts, specified in seconds.
Once the retry interval is computed in the firstretry-interval and becomes equal to or greater than themaximum retry-interval configured, the subsequent retries are done at regular intervals of maximum retry-interval seconds until the call is established.
Range is from 1 to 65535 seconds; the default is 60.
Specifies the interworking function, which can be either network or service interworking.
For soft PVCs that originate from a Frame Relay interface and end on a Frame Relay interface, the default is network interworking.
For soft PVCs that originate from a Frame Relay interface and end on an ATM interface, the default is service interworking.
clp-bit
Sets the mode of DE/CLP mapping in the Frame Relay to ATM direction. Values 0, 1, or map-de are allowed for both network interworking and service interworking. The default is map-de.
de-bit
Sets the mode of DE/CLP mapping in ATM to Frame Relay direction.
For network interworking, values map-de or map-clp-or-de are allowed.The default value is map-clp-or-de.
For service interworking, values 0, 1, or map-clp are allowed. The default is map-clp.
[network | service [transparent | translation]]
Specifies the interworking function, which can be either network interworking or service interworking in transparent mode, or service interworking in translation mode.
efci-bit {0 | map-fecn}
For service interworking only. Sets the mode of FECN/EFCI mapping in the Frame Relay-to-ATM direction. The default value is 0. Values 0 or map-fecn are allowed.
enable
Enables the soft connection, and allows it to be set up. This is the default for the initial soft connection configuration.
However, if the frame-relay soft-vc command is reentered for an existing connection, the default is to remain in the current enabled or disabled state.
disable
Disables the soft connection, which prevents it from being set up initially, or tears down an existing connection.
explicit-path
The PNNI explicit path that is manually configured for routing a soft PVC, using the atm pnni explicit-path command.
precedence
The precedence number by which ATM PNNI explicit paths are assigned, from 1 to 3. Up to three explicit paths can be assigned to a soft PVC.
name path-name
The name of the ATM PNNI explicit path for routing soft PVCs.
identifierpath-id
The name of the ATM PNNI explicit path for routing soft PVCs.
upto partial-entry-index
Allows a subset of a longer explicit path to be used, so that all included nodes after the specified entry-index are disregarded.
If the destination is reachable at any next node or segment target, the remaining included nodes in the explicit path are disregarded automatically.
only-explicit
If one or more explicit paths have been specified and the explicit path fails, the soft connection remains down until it is retried at its next retry interval.
If this option is not specified, the system uses the standard on-demand routing instead of waiting for the next retry interval.
redo-explicit
Applies only to existing soft connections and allows explicit paths to be respecified without tearing down connections.
Existing connections are unaffected unless a reroute takes place, and then they use the newer explicit-path configuration.
Defaults
See "Syntax Description."
Command Modes
Interface configuration
Command History
Release
Modification
12.0(1a)W5(5b)
New command
Usage Guidelines
Obtain the destination port address before configuring a soft PVC by using the show atm interfaceorshow atm addressescommand on the destination switch.
The following list identifies reasons why the creation of a soft PVC is unsuccessful:
There is a VPI or VCI collision at the source or destination switch.
The source or destination interface is not up (or autoconfiguration is not complete).
The specified destination address is not correct.
Up to three explicit paths can be assigned to a soft VC, using precedence numbers 1 through 3. The precedence 1 explicit path is considered the primary path and is tried first. If it fails, then the next precedence path is tried. Explicit paths can be specified either by name or by identifier.
The explicit-path options can be changed without tearing down an existing Frame Relay soft PVC. Use the redo-explicit form of the command to respecify all of the explicit-path options.
After configuring a Frame Relay soft PVC, use the show vc command on the source node (specifying the serial interface and DLCI) to verify that the soft PVC has succeeded and to see the explicit path taken.
Note The show configuration displayed for soft connections with explicit paths is always shown
as two separate lines, with the redo-explicit keyword on the second line, even if it was
originally configured using a single command line.
Examples
The following example shows how to create a soft PVC between two Frame Relay connections.
The following example shows these connections via the show vc command.
Switch# show vc interface serial3/0/0:1
Interface Conn-Id Type X-Interface X-Conn-Id Encap Status
Serial3/0/0:1 50 SoftVC Serial3/0/0:2 50 UP
Serial3/0/0:1 55 PVC Serial3/0/0:2 55 UP
Serial3/0/0:1 60 SoftVC ATM1/1/1 0/35 UP
Serial3/0/0:1 66 PVC Serial3/0/0:2 66 UP
In the show vc example above, the Frame Relay-to-Frame Relay connection originates from Serial 3/0/0:1 and terminates at Serial 3/0/0:2. The Frame Relay-to-ATM connection originates from Serial 3/0/0:1 and goes out through ATM 1/1/1 and ends on an ATM interface on an adjacent switch.
The following example shows how to manually configure an explicit path between two Frame Relay connections. In this example, if the explicit path fails, standard routing is used.
The following example shows how to use the redo-explicit keyword to modify an existing explicit-path configuration to add a second alternate explicit path and to prevent standard routing from being used should both explicit paths fail. Note that the system prompts you to confirm the changes.
Switch(config)# interface atm 0/1/3
Switch(config-if)# frame-relay soft-vc 100 redo-explicit explicit-path 1 name chicago.path1 explicit-path 2 name chicago.path2 only-explicit
Modify with new explicit path options [yes], or abort changes [no]? [yes/no]:y
The following example shows how to remove all explicit paths from an existing Frame Relay soft PVC by using the redo-explicit keyword, with no other options specified. The path will not be changed until a reroute occurs.
Displays active virtual circuits (PVCs, SVCs, and soft VCs).
frame-relay upc-intent
To configure the UPC to be programmed for the soft VCs terminating on an interface, and to configure the default value for the upc option in the frame-relay pvc command, use the frame-relay upc-intent interface configuration command. To assign the default value, use the no form of this command.
frame-relay upc-intent {pass | tag-drop}
no frame-relay upc-intent
Syntax Description
pass | tag-drop
Usage parameter control, specified as pass or tag-drop.
Defaults
Pass
Command Modes
Interface configuration
Command History
Release
Modification
12.0(1a)W5(5b)
New command
Usage Guidelines
This command determines the UPC to use for SVCs and for the destination leg of soft VCs. If you want to configure policing, you can apply it once for traffic entering a network.
Examples
The following example shows how to set the intended UPC for SVCs on an interface to tag-drop.
Displays the configuration information currently running on the terminal.
framing (controller)
To specify the type of framing used by the port on a Frame Relay port adapter, use the framing controller configurationcommand. To restore the default framing type, use the no form of this command.
For the channelized DS3 (CDS3) Frame Relay port adapter, use the following syntax:
framing {c-bit|m23}
no framing {c-bit | m23}
For the channelized E1 (CE1) Frame Relay port adapter, use the following syntax:
framing {crc | no-crc4}
no framing {crc | no-crc4}
Syntax Description
c-bit | m23
Specifies that either C-bit framing or M23 framing is used for the CDS3 Frame Relay controller.
crc4| no-crc4
Specifies CRC-4 E1 framing for the CE1 Frame Relay controller. To select E1 framing without CRC-4 generation, use the no-crc4 option.
Defaults
CDS3 Frame Relay port adapters: m23
CE1 Frame Relay port adapters: crc4
Command Modes
Controller configuration
Command History
Release
Modification
12.0(1a)W5(5b)
New command
Usage Guidelines
The DS3 port adapter has a similar command, but the Frame Relay port adapter does not support the same command options.
Examples
The following example shows how to set the framing for the CE1 Frame Relay port adapter to no CRC4.
Displays information about a physical port device and specifies a channelized E1 interface.
framing (interface)
To select the frame type for the data line, use the framing interface configuration command. To restore the default values, use the no form of this command.
framingframingmode
no framing framingmode
Syntax Description
framingmode
Specifies framingmode as follows:
For DS3: m23adm |m23plcp| cbitadm|cbitplcp
For E3: g832adm |g751adm |g751plcp
For E1: crc4adm |crc4plcp|pcm30adm | pcm30plcp
For E1 IMA: cleare1 | crc4adm| pcm30adm
For T1: esfplcp |sfplcp |sfadm | esfadm
For T1 IMA: esfadm |sfadm
For OC-12: stm-4c| sts-12c
Defaults
For DS3: cbitplcp
For E3: g832adm
For E1: pcm30adm
For E1 IMA: no-crc4
For T1: esfplcp
For T1 IMA: esf
For OC-12: sts-12c
Command Modes
Interface configuration
Command History
Release
Modification
12.0(4a)W5(11a)
Modified: Formerly interface configuration
Usage Guidelines
In the DS3 environment, the framing (interface) subcommand allows selection of DS3 framing mode to M23 ADM, M23 PLCP, C-Bit ADM, or C-Bit PLCP.
In the E3 environment, the framing (interface) subcommand allows selection of E3 framing mode to G.751 PLCP, G.751 ADM, or G.832 ADM.
In the E1 environment, the framing (interface) subcommand allows selection of E1 framing mode to ADM with CRC, PLCP with CRC, PCM 30 ADM, PCM 30 PCLP.
In the E1 IMA environment, the framing (interface) subcommand allows selection of E1 IMA framing mode to clear channel, ADM with CRC, PCM 30 ADM.
In the T1 environment, the framing (interface) subcommand allows selection of T1 framing mode to ESF PLCP, SF PLCP, SF ADM, ESF ADM.
In the T1 IMA environment, the framing (interface) subcommand allows selection of T1 IMA framing mode to SF ADM, ESF ADM.
In the OC-12 environment, the framing (interface) subcommand allows selection of OC-12 framing mode to SONET (STS-12c), SDH (STM-4c).
Note This command is only supported on a system with an OC-12 or OC-48c interface module.
Examples
The following example shows how to select g751plcp as the frame type.
