- Cisco IOS Wide-Area Networking Command Reference, Release 12.2
Table Of Contents
oam ais-rdi
To configure an ATM permanent virtual circuit (PVC) to be brought down after a specified number of Operation, Administration, and Maintenance (OAM) alarm indication signal/remote defect indication (AIS/RDI) cells have been received on the PVC or brought up if no OAM AIS/RDI cells have been received in a specified interval, use the oam ais-rdi command in ATM VC configuration or VC class configuration mode. To return OAM AIS/RDI behavior to the default, use the no form of this command.
oam ais-rdi [down-count [up-count]]
no oam ais-rdi [down-count [up-count]]
Syntax Description
Defaults
Down count: 1
Up count: 3Command Modes
ATM VC configuration
VC class configurationCommand History
Usage Guidelines
The default values for the OAM AIS/RDI down count and up count are used in the following situations:
•
If the oam ais-rdi command has not been entered
•
•
If the oam ais-rdi command is entered without the up-count or down-count argument, the command will not appear in the show running-config command output.
Examples
In the following example, PVC 0/400 will be brought down after 25 consecutive OAM AIS/RDI cells have been received on the PVC. The PVC will be brought up when no OAM AIS/RDI cells have been received for 5 seconds.
interface ATM2/0/0ip address 172.2.222.20 255.255.255.0no ip route-cache cefno ip route-cache distributedno atm ilmi-keepalivepvc 0/400protocol ip 172.2.223.21oam-pvc manage 30oam ais-rdi 25 5oam-pvc
To enable end-to-end F5 Operation, Administration, and Maintenance (OAM) loopback cell generation and OAM management for an ATM permanent virtual circuit (PVC) or virtual circuit (VC) class, use the oam-pvc command in the appropriate command mode. To disable generation of OAM loopback cells and OAM management, use the no form of this command.
oam-pvc [manage] [frequency]
no oam-pvc [manage] [frequency]
Syntax Description
manage
(Optional) Enable OAM management.
frequency
(Optional) Time delay (0 to 600 seconds) between transmitting OAM loopback cells.
Defaults
10 seconds
Command Modes
Interface-ATM-VC configuration (for an ATM PVC)
VC-class configuration (for a VC class)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
11.3
This command was introduced.
12.1(5)T
This command was made available in PVC-in-range configuration mode.
Usage Guidelines
If OAM management is enabled, further control of OAM management is configured using the oam retry command.
If the oam-pvc command is not explicitly configured on an ATM PVC, the PVC inherits the following default configuration (listed in order of precedence):
•
•
•
•
Examples
The following example enables end-to-end F5 OAM loopback cell transmission and OAM management on an ATM PVC with a transmission frequency of 3 seconds:
oam-pvc manage 3Related Commands
Enables ILMI management on an ATM PVC.
Configures parameters related to OAM management for ATM PVC, SVC, or VC class.
oam retry
To configure parameters related to Operation, Administration, and Maintenance (OAM) management for an ATM permanent virtual circuit (PVC), switched virtual circuit (SVC), VC class, or VC bundle, use the oam retry command in the appropriate command mode. To remove OAM management parameters, use the no form of this command.
oam retry up-count down-count retry-frequency
no oam retry up-count down-count retry-frequency
Syntax Description
Defaults
up-count = 3
down-count = 5
retry-frequency = 1 second
This set of defaults assumes that OAM management is enabled using the oam-pvc or oam-svc command.
Command Modes
Interface-ATM-VC configuration (for an ATM PVC or SVC)
VC-class configuration (for a VC class)
Bundle configuration mode (for a VC bundle)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
Usage Guidelines
The up-count argument does not apply to SVCs.
If the oam retry command is not explicitly configured on an ATM PVC, SVC, or VC bundle, the VC inherits the following default configuration (listed in order of precedence):
•
•
•
•
To use this command in bundle configuration mode, enter the bundle command to create the bundle or to specify an existing bundle before you enter this command.
If you use the oam retry command to configure a VC bundle, you configure all VC members of that bundle. VCs in a VC bundle are further subject to the following inheritance rules (listed in order of precedence):
•
•
•
Examples
The following example configures the OAM management parameters with up-count 3, down-count 3, and the retry-frequency at 10 seconds:
oam retry 3 3 10Related Commands
oam-svc
To enable end-to-end F5 Operation, Administration, and Maintenance (OAM) loopback cell generation and OAM management for an ATM switched virtual circuit (SVC) or virtual circuit (VC) class, use the oam-svc command in the appropriate command mode. To disable generation of OAM loopback cells and OAM management, use the no form of this command.
oam-svc [manage] [frequency]
no oam-svc [manage] [frequency]
Syntax Description
manage
(Optional) Enable OAM management.
frequency
(Optional) Time delay (0 to 600 seconds) between transmitting OAM loopback cells.
Defaults
10 seconds
Command Modes
Interface-ATM-VC configuration (for an ATM SVC)
VC-class configuration (for a VC class)
Command History
Usage Guidelines
If OAM management is enabled, further control of OAM management is configured using the oam retry command.
Note
If the oam-svc command is not explicitly configured on an ATM SVC, the SVC inherits the following default configuration (listed in order of precedence):
•
•
•
•
Examples
The following example enables end-to-end F5 OAM loopback cell transmission and OAM management on an ATM SVC with a transmission frequency of 3 seconds:
oam-svc manage 3Related Commands
Configures parameters related to OAM management for an ATM PVC, SVC, or VC class.
partial-fill
To configure the number of AAL1 user octets per cell for the ATM circuit emulation service (CES) on the OC-3/STM-1 Circuit Emulation Service network module, use the partial-fill interface-CES-VC command. To delete the CES partial-fill value, use the no form of this command.
partial-fill octet
no partial-fil octet
Syntax Description
Defaults
No partial-fill
Command Modes
Interface-CES-VC configuration
Command History
Usage Guidelines
The partial-fill command applies to CES SVCs and PVCs configured on Cisco 2600 series and Cisco 3600 series routers that have OC-3/STM-1 ATM CES network modules.
Examples
The following example sets the CES partial cell fill to 50 octets per cell for SVC "ces1":
interface atm 1/0svc ces1 nsap 47.00.00......01.01.00 cespartial fill 40Related Commands
svc
Creates an ATM SVC and specifies the destination NSAP address on a main interface or subinterface.
protocol (ATM)
To configure a static map for an ATM permanent virtual circuit (PVC), switched virtual circuit (SVC), or virtual circuit (VC) class or to enable Inverse Address Resolution Protocol (ARP) or Inverse ARP broadcasts on an ATM PVC, use the protocol command in the appropriate mode. To remove a static map or disable Inverse ARP, use the no form of this command.
protocol protocol {protocol-address [virtual-template] | inarp} [[no] broadcast]
no protocol protocol {protocol-address [virtual-template] | inarp} [[no] broadcast]
Syntax Description
Defaults
Inverse ARP is enabled for IP and IPX if the protocol is running on the interface and no static map is configured.
Command Modes
Interface-ATM-VC configuration (for an ATM PVC or SVC)
VC-class configuration (for a VC class)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)Command History
Usage Guidelines
Command Application
Use this command to perform either of the following tasks:
•
•
PVC range and PVC-in-range configuration modes support only the protocols that do not require static map configuration. Those protocol options are ip and ipx.
Default Configurations
If the protocol command is not explicitly configured on an ATM PVC or SVC, the VC inherits the following default configuration (listed in order of precedence):
•
•
•
•
Examples
The following example creates a static map on a VC, indicates that 10.68.34.237 is connected to this VC, and sends ATM pseudobroadcasts:
protocol ip 10.68.34.237 broadcastThe following example enables Inverse ARP for IPX and does not send ATM pseudobroadcasts:
protocol ipx inarp no broadcastThe following example removes a static map from a VC and restores the default behavior for Inverse ARP (Refer to the "Default" section described above):
no protocol ip 10.68.34.237In the following example, the VC carries PPP traffic and its associated parameters.
protocol ppp 10.68.34.237 virtual-templatepvc
To create or assign a name to an ATM permanent virtual circuit (PVC), to specify the encapsulation type on an ATM PVC, and to enter interface-ATM-VC configuration mode, use the pvc command in interface or subinterface configuration mode. To remove an ATM PVC, use the no form of this command.
pvc [name] vpi/vci [ces | ilmi | qsaal | smds]
no pvc [name] vpi/vci [ces | ilmi | qsaal | smds]
Syntax Description
Defaults
No PVC is defined. When a PVC is defined, the global default of the encapsulation command applies (aal-encap = aal5snap).
Command Modes
Interface or subinterface configuration
Command History
Usage Guidelines
Creating and Configuring PVCs
The pvc command replaces the atm pvc command, which, although still supported and available, will become obsolete in the near future. Use the pvc command to configure a single ATM VC only, not a VC that is a bundle member. We recommend that you use the pvc command in conjunction with the encapsulation and random-detect attach commands instead of the atm pvc command.
The pvc command creates a PVC and attaches it to the VPI and VCI specified. Both the vpi and vci arguments cannot be simultaneously specified as 0; if one is 0, the other cannot be 0.
When configuring an SVC, use the pvc command to configure the PVC that handles SVC call setup and termination. In this case, specify the qsaal keyword. See the second example that follows.
ATM PVC Names
Once you specify a name for a PVC, you can reenter interface-ATM-VC configuration mode by simply entering the pvc name command. You can remove a PVC and any associated parameters by entering no pvc name or no pvc vpi/vci.
Note
Encapsulation Types on ATM PVCs
Specify CES, ILMI, QSAAL, or SMDS as the encapsulation type on an ATM PVC. (To configure other encapsulations types, see the encapsulation command.)
Configuring CES encapsulation on a PVC is equivalent to creating a constant bit rate (CBR) class of service.
Rate Queues
The Cisco IOS software dynamically creates rate queues as necessary to satisfy the requests of the pvc commands.
Default Configurations
If ilmi, qsaal, or smds encapsulation is not explicitly configured on the ATM PVC, the PVC inherits the following default configuration (listed in order of precedence):
•
•
•
•
Examples
The following example creates a PVC with VPI 0 and VCI 16, and communication is set up with the ILMI:
pvc cisco 0/16 ilmiexitThe following example creates a PVC used for ATM signalling for an SVC. It specifies VPI 0 and VCI 5:
pvc cisco 0/5 qsaalexit
The following example configures the PVC called "cisco" to use class-based weighted fair queueing (CBWFQ). It attaches a policy map called "policy1" to the PVC. The classes the make up "policy1" determine the service policy for the PVC:pvc cisco 0/5 service-policy output policy1vbr-nrt 2000 2000 encap aal5snapRelated Commands
retry
To configure a router to periodically attempt to bring up an active SVC connection after the initial call setup failed, use the retry interface-CES-VC command. To disable the retry mechanism, use the no form of this command.
retry timeout_value [retry_limit] [first_retry_interval]
no retry
Syntax Description
Defaults
There is no default timeout_value.
The default retry_limit is 0.
The default first_retry_interval argument is 10 seconds.
Command Modes
Interface-CES-VC configuration
Command History
Usage Guidelines
This command is used on Cisco 2600 series and 3600 series routers that have OC-3/STM-1 ATM CES network modules.
The retry command applies only to active SVCs.
Examples
In the following example, the router is configured to make up to 20 attempts to bring up a connection on SVC "ces1". The interval between attempts is set at 10 seconds.
interface atm 1/0svc ces1 nsap 47.0091.81.000000.0040.0B0A.2501.ABC1.3333.3333.05 cesretry 10 20Related Commands
Configures CES on a router port and enters CES configuration mode.
svc
Creates an ATM SVC and specifies the destination NSAP address on a main interface or subinterface.
scrambling cell-payload
To improve data reliability by randomizing the ATM cell payload frames on Cisco 7100, 7200, or 7500 series routers, use the scrambling cell-payload interface configuration command. To disable scrambling, use the no form of this command.
scrambling cell-payload
no scrambling cell-payload
Syntax Description
This command has no arguments or keywords.
Defaults
No scrambling
Command Modes
Interface configuration
Command History
12.0(5)XE
This command was introduced.
12.0(7)XE1
Support for Cisco 7100 series routers added.
12.1(5)T
This command was integrated into Cisco IOS Release 12.1(5)T.
Usage Guidelines
Normally, you do not issue the scrambling cell-payload command explicitly, because the default value is sufficient. On T1 links, the default b8zs line encoding normally assures sufficient reliability. The default for E1 is hdb3.
The scrambling setting must match that of the far-end receiver.
Examples
On Cisco 7100 or 7200 series routers, the following example sets the link on interface 1 on the port adapter in slot 0 to no scrambling:
interface atm0/1no scrambling cell-payloadRelated Commands
Improves data reliability by randomizing the ATM cell payload frames on Cisco 2600 and 3600 series routers.
scrambling-payload
To improve data reliability by randomizing the ATM cell payload frames on Cisco 2600 or 3600 series routers, use the scrambling-payload interface configuration command. To disable scrambling, use the no form of this command.
scrambling-payload
no scrambling-payload
Syntax Description
This command has no arguments or keywords.
Defaults
By default, payload scrambling is on for E1 links and off for T1 links.
Command Modes
Interface configuration
Command History
12.0(5)XK
This command was introduced.
12.0(5)T
This command was integrated into Cisco IOS Release 12.0(5)T.
Usage Guidelines
Normally, you do not issue the scrambling-payload command explicitly, because the default value is sufficient. On T1 links, the default B8ZS line encoding normally assures sufficient reliability.
The scrambling setting must match that of the far end.
Examples
On a Cisco 2600 or 3600 series router, the following example sets the link on interface 1 on the module in slot 0 to no scrambling:
interface atm0/1no scrambling-payloadRelated Commands
Improves data reliability by randomizing the ATM cell payload frames on Cisco 7100, 7200, or 7500 series routers.
show atm arp-server
To display the ATM Address Resolution Protocol (ARP) server's information about one specific interface or all interfaces, use the show atm arp-server user EXEC command.
AIP on Cisco 7500 series with AIP; Cisco 7200 series with ATM, ATM-CES, and enhanced ATM port adapters; Cisco 2600 and 3600 series with 1-port ATM-25 network module
show atm arp-server [atm slot/port[.subinterface-number]]
Cisco 7500 series with ATM and enhanced ATM port adapters
show atm arp-server [atm slot/port-adapter/port[.subinterface-number]]
Cisco 4500 and 4700 series with NPM
show atm arp-server [atm number[.subinterface-number]]
Syntax Description
Command Modes
User EXEC
Command History
Examples
The following is sample output from the show atm arp-server command when no interface is specified:
Router# show atm arp-serverNote that a '*' next to an IP address indicates an active callIP Address TTL ATM AddressATM1/0:* 4.4.4.2 19:50 ac15336602000000000000000000000000000000* 4.4.4.6 19:50 ac15336606000000000000000000000000000000* 4.4.4.15 19:14 ac15336615000000000000000000000000000000ATM1/0.23:* 10.0.0.2 19:50 ac15336602000000000000000000000000000023* 10.0.0.6 19:50 ac15336606000000000000000000000000000023The following is sample output from the show atm arp-server command when a slot and port are specified on the Cisco 7500:
Router# show atm arp-server atm 1/0Note that a '*' next to an IP address indicates an active callIP Address TTL ATM Address* 4.4.4.2 19:00 ac15336602000000000000000000000000000000* 4.4.4.6 19:00 ac15336606000000000000000000000000000000* 4.4.4.15 19:14 ac15336615000000000000000000000000000000Related Commands
Identifies an ATM ARP server for the IP network or sets TTL values for entries in the ATM ARP table.
show atm class-links
To display virtual circuit (VC) parameter configurations and where the parameter values are inherited from, use the show atm class-links privileged EXEC command.
show atm class-links {vpi/vci | name}
Syntax Description
vpi/vci
The ATM VPI and VCI numbers. The absence of the slash character (/) and a vpi value defaults the vpi value to 0.
name
Name of the VC.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show atm class-links command for VPI 0 and VCI 66:
Router# show atm class-links 0/66Displaying vc-class inheritance for ATM2/0.3, vc 0/66:broadcast - VC-class configured on main-interfaceencapsulation aal5mux ip - VC-class configured on subinterfaceno ilmi manage - Not configured - using defaultoam-pvc manage 3 - VC-class configured on vcoam retry 3 5 1 - Not configured - using defaultubr 10000 - Configured on vc directlyshow atm ilmi-configuration
To display ILMI configuration information, use the show atm ilmi-configuration command in privileged EXEC mode.
show atm ilmi-configuration
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Examples
The following example shows sample output for the show atm ilmi-configuration command:
Router# show atm ilmi-configurationLECS Address(s):1122334455667788990011223344556677889900Table 4 describes the fields shown in the display.
Table 4 show atm ilmi-configuration Field Descriptions
LECS Address(s)
Current ATM LAN Emulation Clients (LECs) addresses.
Related Commands
show atm ilmi-status
To display ILMI-related status information, use the show atm ilmi-status command in privileged EXEC configuration mode.
show atm ilmi-status [atm interface-number]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Entering the show atm ilmi-status command without specifying an interface will display ILMI-related status information for all of the ATM interfaces.
Examples
The following example is sample output for the show atm ilmi-status command:
Router# show atm ilmi-statusInterface :ATM2/0 Interface Type :UnknownILMI VCC :(0, 16) ILMI Keepalive :DisabledILMI State: RestartingInterface :ATM5/0 Interface Type :Private UNI (User-side)ILMI VCC :(0, 16) ILMI Keepalive :DisabledILMI State: UpAndNormalPeer IP Addr: 10.0.52.17 Peer IF Name: ATM1/1/0Peer MaxVPIbits: 8 Peer MaxVCIbits: 14Active Prefix(s) :47.0091.8100.0000.0040.0b0a.2501End-System Registered Address(s) :47.0091.8100.0000.0040.0b0a.2501.bbbb.ccdd.eeff.12(Confirmed)Table 5 describes the fields shown in the display.
Related Commands
show atm interface atm
To display ATM-specific information about an ATM interface, use the show atm interface atm privileged EXEC command.
Cisco 7500 series with AIP; Cisco 7200 series with ATM, ATM-CES, and enhanced ATM port adapters; Cisco 2600 and 3600 series with 1-port ATM-25 network module
show atm interface atm slot/port
Cisco 7500 series with ATM and enhanced ATM port adapters
show atm interface atm slot/port-adapter/port
Cisco 4500 and 4700 series with NPM
show atm interface atm number
Syntax Description
Command Modes
Privileged EXEC
Command History
10.0
This command was introduced.
11.0
The number argument was added.
11.2
The slot/port-adapter/port arguments were added.
Examples
The following is sample output for the ATM-CES port adapter to display statistics on slot 4, port 0:
Router# show atm interface atm 4/0ATM interface ATM4/0:AAL enabled: AAL5, Maximum VCs: 1024, Current VCs: 6Tx buffers 256, Rx buffers 256, Exception Queue: 32, Raw Queue: 32VP Filter: 0x7B, VCIs per VPI: 1024, Max Datagram Size:4496, MIDs/VC:16PLIM Type:4B5B - 100Mbps, No Framing, TX clocking: LINE4897 input, 2900 output, 0 IN fast, 0 OUT fastRate-Queue 1 set to 100Mbps, reg=0x4EA DYNAMIC, 1 VCCsATM4/0.1:AAL3/4-SMDS address c111.1111.1111 Multicast e222.2222.222Config. is ACTIVEThe following is sample output for the enhanced ATM port adapter to display statistics on slot 6, port 0:
Router# show atm interface atm 6/0ATM interface ATM6/0AAL enabled: AAL5, Maximum VCs: 2048, Current VCs: 3Maximum Transmit Channels: 64Tx buffers: 256, Rx buffers 256, Exception Queue: 32, Raw Queue: 32VP Filter: 0x7B, VCIs per VPI: 1024, Max Datagram Size: 4496PLIM Type: SONET - 155Mbps, TX clocking: INTERNAL0 input, 59 output, 0 IN fast, 0 OUT fastABR parameters, rif: 16 rdf: 16Config. is ACTIVETable 6 describes the fields shown in the display.
