Table Of Contents
ATM Commands
atm aal aal3/4
atm address-registration
atm arp-server
atm backward-max-burst-size-clp0
atm backward-max-burst-size-clp1
atm backward-peak-cell-rate-clp0
atm backward-peak-cell-rate-clp1
atm backward-sustainable-cell-rate-clp0
atm backward-sustainable-cell-rate-clp1
atm class
atm clock internal
atm ds3-scramble
atm esi-address
atm exception-queue
atm forward-max-burst-size-clp0
atm forward-max-burst-size-clp1
atm forward-peak-cell-rate-clp0
atm forward-peak-cell-rate-clp1
atm forward-sustainable-cell-rate-clp0
atm forward-sustainable-cell-rate-clp1
atm framing (DS3)
atm framing (E3)
atm idle-timeout
atm ilmi-keepalive
atm maxvc
atm mid-per-vc
atm multicast
atm multipoint-interval
atm multipoint-signaling
atm-nsap
atm nsap-address
atm pvc
atm rate-queue
atm rawq-size
atm rxbuff
atmsig close
atm sig-traffic-shaping strict
atm smds-address
atm sonet
atm txbuff
atm uni-version
atm vc
atm vc-per-vp
atm vp-filter
clear atm arp atm
dxi map
dxi pvc
loopback
map-class atm
map-group
map-list
show atm arp-server
show atm interface atm
show atm map
show atm traffic
show atm vc
show dxi map
show dxi pvc
show sscop
sscop cc-timer
sscop keepalive-timer
sscop max-cc
sscop poll-timer
sscop rcv-window
sscop send-window
ATM Commands
This chapter describes the commands available to configure an Asynchronous Transfer Mode (ATM) interface in the Cisco 7000 series and Cisco 7500 series routers with ATM Interface Processors (AIPs) and Cisco 4500 and Cisco 4700 routers with network processor modules (NPMs), and to configure a serial interface for ATM access in other routers.
Note
ATM is currently not supported on Cisco 2500 series and Cisco AS5100 access servers.
For ATM configuration information and examples, refer to the chapter entitled "Configuring ATM" in the Wide-Area Networking Configuration Guide.
atm aal aal3/4
To enable support for ATM adaptation layer 3/4 (AAL3/4) on the AIP, use the atm aal aal3/4 interface configuration command. To disable support for ATM adaptation layer 3/4 (AAL3/4) on an ATM interface, use the no form of this command.
atm aal aal3/4
no atm aal aal3/4
Syntax Description
This command has no arguments or keywords.
Default
Support for AAL3/4 is disabled.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
This command is supported on Cisco 7000 series and Cisco 7500 series routers. Because Cisco 4500 and Cisco 4700 routers always support both AAL3/4 and AAL5, this command is not required on Cisco 4500 and Cisco 4700 routers.
Only one virtual circuit can exist on a subinterface that is being used for AAL3/4 processing, and that virtual circuit must be an AAL3/4 virtual circuit.
The AAL3/4 support feature requires static mapping of all protocols except IP.
Example
The following example enables AAL3/4 on ATM interface 2/0:
ip address 172.21.177.178 255.255.255.0
Related Commands
A dagger (†) indicates that the command is documented outside this chapter.
atm mid-per-vc
atm multicast
atm pvc
atm smds-address
interface atm †
atm address-registration
To enable the router to engage in address registration and callback functions with the Interim Local Management Interface (ILMI), use the atm address-registration interface configuration command. To disable ILMI address registration functions, use the no form of this command.
atm address-registration
no atm address-registration
Syntax Description
This command has no keywords and arguments.
Default
Enabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
This command enables a router to register its address with the ILMI for callback when specific events occur, such as incoming Simple Network Management Protocol (SNMP) traps or incoming new network prefixes.
Example
The following example enables ATM interface I/O to register its address:
Related Command
atm ilmi-keepalive
atm arp-server
To identify an ATM Address Resolution Protocol (ARP) server for the IP network or set time-to-live (TTL) values for entries in the ATM ARP table, use the arp-server interface configuration command. To remove the definition of an ATM ARP server, use the no form of this command.
atm arp-server [self [time-out minutes] | nsap nsap-address]
no atm arp-server [self [time-out minutes] | nsap nsap-address]
Syntax Description
self
|
(Optional) Specifies the current router as the ATM ARP server.
|
time-out minutes
|
(Optional) Number of minutes a destination entry listed in the ATM ARP server's ARP table will be kept before the server takes any action to verify or time out the entry.
|
nsap nsap-address
|
(Optional) Network service access point (NSAP) address of an ATM ARP server.
|
Defaults
The ARP server process is disabled. The default timeout value is 20 minutes.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
If an NSAP address is specified, the ARP client on this interface uses the specified host as an ARP server. You can specify multiple ATM ARP servers by repeating the command. If self is specified, this interface acts as the ARP server for the logical IP network.
The ATM ARP server takes one of the following actions if a destination listed in the server's ARP table expires:
•
If a virtual circuit still exists to that destination, the server sends an Inverse ARP request. If no response arrives, the entry times out.
•
If a virtual circuit does not exist to the destination, the entry times out immediately.
This implementation follows RFC 1577, Classical IP over ATM.
atm backward-max-burst-size-clp0
To change the maximum number of high-priority cells coming from the destination router to the source router at the burst level on the switched virtual circuit (SVC), use the atm backward-max-burst-size-clp0 map-class configuration command. The no form of this command restores the default.
atm backward-max-burst-size-clp0 cell-count
no atm backward-max-burst-size-clp0
Syntax Description
cell-count
|
Maximum number of high-priority cells coming from the destination router at the burst level. Default is -1.
|
Default
-1. The router does not request this quality of service (QOS) parameter of the ATM switch, so the switch provides a "best effort service." The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series and Cisco 7500 series routers and on Cisco 4500 and Cisco 4700 routers.
This command defines a quality of service (QOS) parameter for the SVC connection.
The keyword clp0 indicates that this command affects only cells with a cell loss priority (CLP) of 0 (high-priority cells).
On the Cisco 7000 and Cisco 7500, the value of this parameter can be a multiple of 32 within the range of 32 to 2016 cells. Any value within this range that is not a multiple of 32 will be rounded to the nearest multiple of 32. On the Cisco 4500 and Cisco 4700 routers, the value of this parameter can be between 1 and 65535 cells.
Example
The following example sets the maximum number of high-priority cells coming from the destination router at the burst level to 800 cells:
atm backward-max-burst-size-clp0 800
atm backward-max-burst-size-clp1
To request the maximum number of low-priority and high-priority cells coming from the destination router to the source router at the burst level on the SVC, use the atm backward-max-burst-size-clp1 map-class configuration command. The no form of this command restores the default value.
atm backward-max-burst-size-clp1 cell-count
no atm backward-max-burst-size-clp1
Syntax Description
cell-count
|
Maximum number of low-priority and high-priority cells coming from the destination router at the burst level. Default is -1.
|
Default
-1. The router does not request this traffic parameter of the ATM switch. The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a traffic parameter for the SVC connection.
The suffix clp1 applies to the cumulative flow of CLP0 and CLP1 (high-priority and low-priority) cells.
On the Cisco 7000 and Cisco 7500, the value of this parameter can be a multiple of 32 within the range of 32 to 2016 cells. Any value within this range that is not a multiple of 32 will be rounded to the nearest multiple of 32. On the Cisco 4500 and Cisco 4700 routers, the value of this parameter can be between 1 and 65535 cells.
Example
The following example requests the maximum number of low-priority and high-priority cells coming from the destination router at the burst level to 2016:
atm backward-max-burst-size-clp1 2016
atm backward-peak-cell-rate-clp0
To change the peak rate of high-priority cells coming from the destination router to the source router on the SVC, use the atm backward-peak-cell-rate-clp0 map-class configuration command. The no form of this command restores the default.
atm backward-peak-cell-rate-clp0 rate
no atm backward-peak-cell-rate-clp0
Syntax Description
rate
|
Maximum rate in kilobits per second (kbps) at which this SVC can receive high-priority cells from the destination router. Default is -1. Maximum upper range is 155,000 kbps.
|
Default
-1. The router does not request this quality of service (QOS) parameter of the ATM switch, so the switch provides a "best effort service." The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500series, Cisco 4500, and Cisco 4700 routers.
This command defines a quality of service (QOS) parameter for the SVC connection.
The suffix clp0 indicates that this command affects only cells with a cell loss priority (CLP) of 0 (high-priority cells).
If either the forward or backward peak cell rate (PCR) values for the CLP0 cell flow is specified, the SETUP request formulated by the router does not specify Best Effort. The connection requested should therefore be interpreted as a Non-Real Time Variable Bit Rate (VBR-NRT) Service Category connection.
Commonly, VBR-NRT connections can be rejected at intermediate switches because of one or more of the following conditions:
•
a requested peak rate is greater than that of the interface through which the connection passes.
•
the cumulative reservation of bandwidth for existing VBR or Constant Bit Rate (CBR) connections does not leave room for the bandwidth proposed for the new signaled connection.
•
the sustainable cell rate specified for a forward or backward direction is greater than the peak cell rate specified for that direction.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For the Cisco 7000 and Cisco 7500 series routers (depending on the physical interface type e.g. OC-3, DS-3), the PCR shaping parameters can be between 130 and 155,000 kbps. For the Cisco 4500 and Cisco 4700 routers, PCR can be between 56 and 155,000 kbps.
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example sets the peak rate for high-priority cells from the destination router to 8000 kbps:
atm backward-peak-cell-rate-clp0 8000
atm backward-peak-cell-rate-clp1
To request the peak rate of low-priority and high-priority cells coming from the destination router to the source router on the SVC, use the atm backward-peak-cell-rate-clp1 map-class configuration command. The no form of this command restores the default.
atm backward-peak-cell-rate-clp1 rate
no atm backward-peak-cell-rate-clp1
Syntax Description
rate
|
Maximum rate in kilobits per second (kbps) at which this SVC can receive low-priority and high-priority cells from the destination router. Default is -1. Maximum upper range is 7,113,539 kbps (limited by 0xffffff cells-per-second).
|
Default
-1. The router does not request this traffic parameter of the ATM switch. The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a traffic parameter for the SVC connection.
The suffix clp1 applies to the cumulative flow of CLP0 and CLP1 (high-priority and low-priority) cells.
If only the forward and backward peak cell rates (PCR) for the cumulative flow of CLP0 and CLP1 cells are specified, the SETUP request formulated by the router specifies Best Effort. The connection requested should therefore be interpreted as an Unspecified Bit Rate (UBR) Service Category connection.
Commonly, UBR connections are not rejected at intermediate switches simply because the requested rate is greater than that of the interface through which the connection passes. Also, a UBR connection established on a switch interface does not typically reserve bandwidth. For example, many UBR connections can be established on an interface each having specified PCR of the interface rate.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For the Cisco 7000 and Cisco 7500 series routers (depending on the physical interface type e.g. OC-3, DS-3), the PCR shaping parameters can be between 130 and 155,000 kbps. For the Cisco 4500 and Cisco 4700 routers, PCR can be between 56 and 155,000 kbps.
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example requests the peak rate for low-priority and high-priority cells from the destination router to 7000 kbps:
atm backward-peak-cell-rate-clp1 7000
atm backward-sustainable-cell-rate-clp0
To change the sustainable rate of high-priority cells coming from the destination router to the source router on the SVC, use the atm backward-sustainable-cell-rate-clp0 map-class configuration command. The no form of this command restores the default.
atm backward-sustainable-cell-rate-clp0 rate
no atm backward-sustainable-cell-rate-clp0
Syntax Description
rate
|
Sustainable rate in kilobits per second (kbps) at which this SVC can receive high-priority cells from the destination router. Default is -1. Maximum upper range is 155,000 kbps.
|
Default
-1. The router does not request this quality of service (QOS) parameter of the ATM switch, so the switch provides a "best effort service."The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a quality of service (QOS) parameter for the SVC connection.
The suffix clp0 indicates that this command affects only cells with a cell loss priority (CLP) of 0 (high-priority cells).
On the AIP, the sustainable rate can be in the range of (peak rate)*(1/64) kbps to the peak rate value. For example, if the peak rate is 8192 kbps, the sustainable rate can be in the range of (8192)*(1/64) = 128 kbps to 8192 kbps. The sustainable rate you will input will always round to the nearest value equal to (peak rate)*(1/n) where n=1, 2, 3, . . . , 64. Any value between (peak rate)*(1/1) and (peak rate)*(1/2) will give you an error.
If any of the forward or backward sustainable cell rate (PCR) values are specified, the SETUP request formulated by the router does not specify Best Effort. The connection requested should therefore be interpreted as a Non-Real Time Variable Bit Rate (VBR-NRT) Service Category connection.
Commonly, VBR-NRT connections can be rejected at intermediate switches because of one or more of the following conditions:
•
a requested peak rate or sustainable rate is greater than that of the interface through which the connection passes.
•
the cumulative reservation of bandwidth for existing VBR or Constant Bit Rate (CBR) connections does not leave room for the bandwidth proposed for the new signaled connection.
•
the sustainable cell rate specified for a forward or backward direction is greater than the peak cell rate specified for that direction.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For AIP interfaces, the sustainable cell rate that is installed is subject to the following limitations:
•
sustainable cell rate <= (peak cell rate)/2
•
sustainable cell rate >= (peak cell rate)/64
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example sets the sustainable rate for high-priority cells from the destination router to 800 kbps:
atm backward-sustainable-cell-rate-clp0 800
atm backward-sustainable-cell-rate-clp1
To request the sustainable rate of low-priority and high-priority cells coming from the destination router to the source router on the SVC, use the atm backward-sustainable-cell-rate-clp1 map-class configuration command. The no form of this command restores the default value.
atm backward-sustainable-cell-rate-clp1 rate
no atm backward-sustainable-cell-rate-clp1
Syntax Description
rate
|
Sustainable rate in kilobits per second (kbps) at which this SVC can receive low-priority and high-priority cells from the destination router. Default is -1. Maximum upper range is 7,113,539 kbps (limited by 0xffffff cells-per-second).
|
Default
-1. The router does not request this traffic parameter of the ATM switch. The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a traffic parameter for the SVC connection.
The suffix clp1 applies to the cumulative flow of CLP0 and CLP1 (high-priority and low-priority) cells.
On the AIP, the sustainable rate can be in the range of (peak rate)*(1/64) kbps to the peak rate value. For example, if the peak rate is 8192 kbps, the sustainable rate can be in the range of (8192)*(1/64) = 128 kbps to 8192 kbps. The sustainable rate you will input will always round to the nearest value equal to (peak rate)*(1/n) where n=1, 2, 3, . . . , 64. Any value between (peak rate)*(1/1) and (peak rate)*(1/2) will give you an error.
If any of the forward or backward sustainable cell rate (PCR) values are specified, the SETUP request formulated by the router does not specify Best Effort. The connection requested should therefore be interpreted as a Non-Real Time Variable Bit Rate (VBR-NRT) Service Category connection.
Commonly, VBR-NRT connections can be rejected at intermediate switches because of one or more of the following conditions:
•
a requested peak rate or sustainable rate is greater than that of the interface through which the connection passes.
•
the cumulative reservation of bandwidth for existing VBR or Constant Bit Rate (CBR) connections does not leave room for the bandwidth proposed for the new signaled connection.
•
the sustainable cell rate specified for a forward or backward direction is greater than the peak cell rate specified for that direction.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For AIP interfaces, the sustainable cell rate that is installed is subject to the following limitations:
•
sustainable cell rate <= (peak cell rate)/2
•
sustainable cell rate >= (peak cell rate)/64
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example requests the sustainable rate for low-priority and high-priority cells from the destination router to 700 kbps:
atm backward-sustainable-cell-rate-clp1 700
atm class
To specify a class for an ATM interface, use the atm class global configuration command. The no form of this command deletes this class from the interface.
atm class class-name
no atm class class-name
Syntax Description
class-name
|
User-assigned name of the QOS parameters table.
|
Default
No class is defined.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
One command is permitted per interface. Entering a second atm class command on an interface results in the original entry being overwritten.
Example
The following example illustrates the configuration of an ATM ARP client in an SVC environment using the class classicip for traffic shaping:
atm esi-address 345678901234.12
ip address 10.0.0.2 255.0.0.0
atm arp-server nsap ac.1533.66.020000.0000.0000.0000.0000.0000.0000.00
atm forward-peak-cell-rate-clp1 7000
atm backward-peak-cell-rate-clp1 7000
atm forward-sustainable-cell-rate-clp0 800
Related Command
map-class atm
atm clock internal
To cause the ATM interface to generate the transmit clock internally, use the atm clock internal interface configuration command. The no form of this command restores the default value.
atm clock internal
no atm clock internal
Syntax Description
This command has no arguments or keywords.
Default
The ATM interface uses the transmit clock signal from the remote connection (the line). The switch provides the clocking.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is meaningless on a 4B/5B physical layer interface module (PLIM).
Example
The following example causes the ATM interface to generate the transmit clock internally:
atm ds3-scramble
To enable scrambling of the ATM cell payload for the DS-3 PLIM, use the atm ds3-scramble interface configuration command. To disable this functionality, use the no form of this command.
atm ds3-scramble
no atm ds3-scramble
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
This command is supported on the Cisco 7000 and Cisco 7500 series and the Cisco 4500 and Cisco 4700 routers.
atm esi-address
To enter the end station ID (ESI) and selector byte fields of the ATM NSAP address, use the atm esi-address interface configuration command. The NSAP address prefix is filled in via ILMI from the ATM switch. The no form deletes the end station address.
atm esi-address esi.selector
no atm esi-address esi.selector
Syntax Description
esi
|
End station ID field value in hexadecimal; 6 bytes long.
|
selector
|
Selector field value in hexadecimal; 1 byte long.
|
Default
No end station is defined.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
This command applies to the Cisco 7000 series, the Cisco 7500 series, the Cisco 4500, and the Cisco 4700 routers.
Before Cisco IOS Release 11.1, ATM addresses were configured on the router only by use of the atm nsap-address interface configuration command. The complete 20-byte NSAP (40 hexadecimal characters) had to be configured.
The atm esi-address command allows you to configure the ATM address by entering the ESI (12 hexadecimal characters) and the selector byte (2 hexadecimal characters). The ATM prefix (26 hexadecimal characters) will be provided by the ATM switch. To get the prefix from the ATM switch, the ILMI permanent virtual circuit (PVC) must be configured on the router and the ATM switch must be able to supply a prefix via ILMI.
Note
When ILMI is configured, use the atm esi-address command instead of the atm nsap-address command. The atm esi-address and atm nsap-address commands are mutually exclusive. Configuring the router with the atm esi-address command negates the atm nsap-address setting, and vice versa.
The ILMI PVC must be configured in order to get an NSAP address prefix from the switch.
Example
The following example shows the router's configuration after a PVC is set up for communication with the switch via ILMI and the value 303132333435.36 in the esi-address command is entered.
inverness #show running-config
Building configuration...
ip address 1.1.1.1 255.255.255.0
atm esi-address 303132333435.36
Related Commands
atm nsap-address
atm pvc ilmi
atm exception-queue
To set the exception queue length on the AIP, use the atm exception-queue interface configuration command. The no form of this command restores the default value.
atm exception-queue number
no atm exception-queue
Syntax Description
number
|
Number of entries in the range of 8 to 256. Default is 32 entries.
|
Default
32 entries
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series and Cisco 7500 series, but not on Cisco 4500 and Cisco 4700 routers.
The exception queue is used for reporting ATM events, such as cycle redundancy check (CRC) errors.
Example
In the following example, the exception queue is set to 50 entries:
atm forward-max-burst-size-clp0
To change the maximum number of high-priority cells going from the source router to the destination router at the burst level on the SVC, use the atm forward-max-burst-size-clp0 map-class configuration command. The no form of this command restores the default value.
atm forward-max-burst-size-clp0 cell-count
no atm forward-max-burst-size-clp0
Syntax Description
cell-count
|
Maximum number of high-priority cells going from the source router at the burst level. Default is -1.
|
Default
-1. The router does not request this quality of service (QOS) parameter of the ATM switch, so the switch provides a "best effort service." The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series and Cisco 7500 series routers, as well as on Cisco 4500 and Cisco 4700 routers.
This command defines a quality of service (QOS) parameter for the SVC connection.
The keyword clp0 indicates that this command affects only cells with a cell loss priority (CLP) of 0 (high-priority cells)
On the Cisco 7000 and Cisco 7500, the value of this parameter can be a multiple of 32 within the range of 32 to 2016 cells. Any value within this range that is not a multiple of 32 will be rounded to the nearest multiple of 32. On the Cisco 4500 and Cisco 4700 routers, the value of this parameter can be between 1 and 65535 cells.
Example
The following example sets the maximum number of high-priority cells going from the source router at the burst level to 100,000:
atm forward-max-burst-size-clp0 100000
atm forward-max-burst-size-clp1
To request the maximum number of low-priority and high-priority cells going from the source router to the destination router at the burst level on the SVC, use the atm forward-max-burst-size-clp1 map-class configuration command. The no form of this command restores the default value.
atm forward-max-burst-size-clp1 cell-count
no atm forward-max-burst-size-clp1
Syntax Description
cell-count
|
Maximum number of low-priority and high-priority cells going from the source router at the burst level. Default is -1.
|
Default
-1. The router does not request this traffic parameter of the ATM switch. The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a traffic parameter for the SVC connection.
The suffix clp1 applies to the cumulative flow of CLP0 and CLP1 (high-priority and low-priority) cells.
On the Cisco 7000 and Cisco 7500, the value of this parameter can be a multiple of 32 within the range of 32 to 2016 cells. Any value within this range that is not a multiple of 32 will be rounded to the nearest multiple of 32. On the Cisco 4500 and Cisco 4700 routers, the value of this parameter can be between 1 and 65535 cells.
Example
The following example requests the maximum number of low-priority and high-priority cells going from the source router at the burst level to 100,000:
atm forward-max-burst-size-clp1 100000
atm forward-peak-cell-rate-clp0
To change the peak rate of high-priority cells going from the source router to the destination router on the SVC, use the atm forward-peak-cell-rate-clp0 map-class configuration command. The no form of this command restores the default value.
atm forward-peak-cell-rate-clp0 rate
no atm forward-peak-cell-rate-clp0
Syntax Description
rate
|
Maximum rate in kilobits per second (kbps) at which this SVC can send high-priority cells from the source router. Default is -1. Maximum upper range is 155,000 kbps.
|
Default
-1. The router does not request this quality of service (QOS) parameter of the ATM switch, so the switch provides a "best effort service." The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series and Cisco 7500 series routers, as well as on Cisco 4500 and Cisco 4700 routers.
This command defines a quality of service (QOS) parameter for the SVC connection.
The suffix clp0 indicates that this command affects only cells with a cell loss priority (CLP) of 0 (high-priority cells).
If either the forward or backward peak cell rate (PCR) values for the CLP0 cell flow is specified, the SETUP request formulated by the router does not specify Best Effort. The connection requested should therefore be interpreted as a Non-Real Time Variable Bit Rate (VBR-NRT) Service Category connection.
Commonly, VBR-NRT connections can be rejected at intermediate switches because of one or more of the following conditions:
•
a requested peak rate is greater than that of the interface through which the connection passes.
•
the cumulative reservation of bandwidth for existing VBR or Constant Bit Rate (CBR) connections does not leave room for the bandwidth proposed for the new signaled connection.
•
the sustainable cell rate specified for a forward or backward direction is greater than the peak cell rate specified for that direction.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For the Cisco 7000 and Cisco 7500 series routers (depending on the physical interface type e.g. OC-3, DS-3), the PCR shaping parameters can be between 130 and 155,000 kbps. For the Cisco 4500 and Cisco 4700 routers, PCR can be between 56 and 155,000 kbps.
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example sets the peak high-priority cell rate from the source router to 1000 kbps:
atm forward-peak-cell-rate-clp0 1000
atm forward-peak-cell-rate-clp1
To request the peak rate of low-priority and high-priority cells coming from the source router to the destination router on the SVC, use the atm forward-peak-cell-rate-clp1 map-class configuration command. The no form of this command restores the default value.
atm forward-peak-cell-rate-clp1 rate
no atm forward-peak-cell-rate-clp1
Syntax Description
rate
|
Maximum rate in kilobits per second (kbps) at which this SVC can send low-priority and high-priority cells from the source router. Default is -1. Maximum upper range is 7,113,539 kbps (limited by 0xffffff cells-per-second).
|
Default
-1. The router does not request this traffic parameter of the ATM switch. The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a traffic parameter for the SVC connection.
The suffix clp1 applies to the cumulative flow of CLP0 and CLP1 (high-priority and low-priority) cells.
If only the forward and backward peak cell rates (PCR) for the cumulative flow of CLP0 and CLP1 cells are specified, the SETUP request formulated by the router specifies Best Effort. The connection requested should therefore be interpreted as an Unspecified Bit Rate (UBR) Service Category connection.
Commonly, UBR connections are not rejected at intermediate switches simply because the requested rate is greater than that of the interface through which the connection passes. Also, a UBR connection established on a switch interface does not typically reserve bandwidth. For example, many UBR connections can be established on an interface each having specified PCR of the interface rate.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For the Cisco 7000 and Cisco 7500 series routers (depending on the physical interface type e.g. OC-3, DS-3), the PCR shaping parameters can be between 130 and 155,000 kbps. For the Cisco 4500 and Cisco 4700 routers, PCR can be between 56 and 155,000 kbps.
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example requests the peak low-priority and high-priority cell rate from the source router to 100,000 kbps:
atm forward-peak-cell-rate-clp1 100000
atm forward-sustainable-cell-rate-clp0
To change the sustainable rate of high-priority cells coming from the source router to the destination router on the SVC, use the atm forward-sustainable-cell-rate-clp0 map-class configuration command. The no form of this command restores the default value.
atm forward-sustainable-cell-rate-clp0 rate
no atm forward-sustainable-cell-rate-clp0
Syntax Description
rate
|
Sustainable rate in kilobits per second (kbps) at which this SVC can send high-priority cells from the source router. Default is -1. Maximum upper range is 155,000 kbps.
|
Default
-1. The router does not request this quality of service (QOS) parameter of the ATM switch, so the switch provides a "best effort service." The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series and Cisco 7500 series routers, as well as on Cisco 4500 and Cisco 4700 routers.
This command defines a quality of service (QOS) parameter for the SVC connection.
The suffix clp0 indicates that this command affects only cells with a cell loss priority (CLP) of 0 (high-priority cells)
On the AIP, the sustainable rate can be in the range of (peak rate)*(1/64) kbps to the peak rate value. For example, if the peak rate is 8192 kbps, the sustainable rate can be in the range of (8192)*(1/64) = 128 kbps to 8192 kbps. The sustainable rate you will input will always round to the nearest value equal to (peak rate)*(1/n) where n=1, 2, 3, . . . , 64. Any value between (peak rate)*(1/1) and (peak rate)*(1/2) will give you an error.
If any of the forward or backward sustainable cell rate (PCR) values are specified, the SETUP request formulated by the router does not specify Best Effort. The connection requested should therefore be interpreted as a Non-Real Time Variable Bit Rate (VBR-NRT) Service Category connection.
Commonly, VBR-NRT connections can be rejected at intermediate switches because of one or more of the following conditions:
•
a requested peak rate or sustainable rate is greater than that of the interface through which the connection passes.
•
the cumulative reservation of bandwidth for existing VBR or Constant Bit Rate (CBR) connections does not leave room for the bandwidth proposed for the new signaled connection.
•
the sustainable cell rate specified for a forward or backward direction is greater than the peak cell rate specified for that direction.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For AIP interfaces, the sustainable cell rate that is installed is subject to the following limitations:
•
sustainable cell rate <= (peak cell rate)/2
•
sustainable cell rate >= (peak cell rate)/64
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example sets the sustainable rate for high-priority cells from the source router to 100,000 kbps:
atm forward-sustainable-cell-rate-clp0 100000
atm forward-sustainable-cell-rate-clp1
To request the sustainable rate of low-priority and high-priority cells coming from the source router to the destination router on the SVC, use the atm forward-sustainable-cell-rate-clp1 map-class configuration command. The no form of this command restores the default value.
atm forward-sustainable-cell-rate-clp1 rate
no atm forward-sustainable-cell-rate-clp1
Syntax Description
rate
|
Sustainable rate in kilobits per second (kbps) at which this SVC can send low-priority and high-priority cells from the source router. Default is -1. Maximum upper range is 7,113,539 kbps (limited by 0xffffff cells-per-second).
|
Default
-1. The router does not request this traffic parameter of the ATM switch. The switch drops cells if there is not enough buffer space.
Command Mode
Map-class configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
This command defines a traffic parameter for the SVC connection.
The suffix clp1 applies to the cumulative flow of CLP0 and CLP1 (high-priority and low-priority) cells.
On the AIP, the sustainable rate can be in the range of (peak rate)*(1/64) kbps to the peak rate value. For example, if the peak rate is 8192 kbps, the sustainable rate can be in the range of (8192)*(1/64) = 128 kbps to 8192 kbps. The sustainable rate you will input will always round to the nearest value equal to (peak rate)*(1/n) where n=1, 2, 3, . . . , 64. Any value between (peak rate)*(1/1) and (peak rate)*(1/2) will give you an error.
If any of the forward or backward sustainable cell rate (PCR) values are specified, the SETUP request formulated by the router does not specify Best Effort. The connection requested should therefore be interpreted as a Non-Real Time Variable Bit Rate (VBR-NRT) Service Category connection.
Commonly, VBR-NRT connections can be rejected at intermediate switches because of one or more of the following conditions:
•
a requested peak rate or sustainable rate is greater than that of the interface through which the connection passes.
•
the cumulative reservation of bandwidth for existing VBR or Constant Bit Rate (CBR) connections does not leave room for the bandwidth proposed for the new signaled connection.
•
the sustainable cell rate specified for a forward or backward direction is greater than the peak cell rate specified for that direction.
Router interfaces capable of per-connection traffic shaping attempt to install signaled parameters. Forward parameters are used by the initiating router, backward parameters apply to the router accepting the connection. For AIP interfaces, the sustainable cell rate that is installed is subject to the following limitations:
•
sustainable cell rate <= (peak cell rate)/2
•
sustainable cell rate >= (peak cell rate)/64
The handling of traffic shaping and connection acceptance is determined by whether or not the atm sig-traffic-shaping strict command is enabled or not. Refer to this command in this chapter for further information.
Example
The following example requests the sustainable rate for low-priority and high-priority cells from the source router to 100,000 kbps:
atm forward-sustainable-cell-rate-clp1 100000
atm framing (DS3)
To specify DS3 line framing on Cisco 4500 and Cisco 4700 routers, use the following form of the atm framing interface configuration command. To return to the default C-bit with Physical Layer Convergence Protocol (PLCP) framing, use the no form of this command.
atm framing [m23adm | cbitplcp | m23plcp]
no atm framing [m23adm | cbitplcp | m23plcp]
Syntax Description
m23adm
|
(Optional) Specifies M-23 ATM direct mapping.
|
cbitplcp
|
(Optional) Specifies C-bit with PLCP framing.
|
m23plcp
|
(Optional) Specifies M-23 with PLCP framing.
|
Default
No framing
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
This command is available only on Cisco 4500 and Cisco 4700 routers with DS3 access speeds. This command is not available on the Cisco 7000 series or Cisco 7500 series.
Framing on the interface must match that on the switch for this ATM link.
Example
The following example specifies M-23 ADM framing on a Cisco 4500 or Cisco 4700 router that has been set up with DS3 access to an ATM network:
atm framing (E3)
To specify E3 line framing, use the atm framing interface configuration command. To return to the default G.751 Physical Layer Convergence Protocol (PLCP) framing, use the no form of this command.
atm framing g832adm (Cisco 7000 series and Cisco 7500 series routers only)
no atm framing g832adm
atm framing [g832adm | g751adm] (Cisco 4500 and Cisco 4700 routers only)
no atm framing [g832adm | g751adm]
Syntax Description
g832adm
|
(Required for Cisco 7000 series and Cisco 7500 series routers; optional for Cisco 4500 and Cisco 4700 routers) Specifies G.832 ATM Direct Mapping.
|
g751adm
|
(Optional) Specifies G.751 ATM Direct Mapping.
|
Default
No framing
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
This command is available on the Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers with E3 access speeds. This command is not available on the Cisco 7000 or Cisco 7500 with DS3 access speeds; that combination supports only one type of line framing. The default framing is described in the ITU-T Recommendation G.751.
Note
The ITU-T carries out the functions of the former Consultative Committee for International Telegraph and Telephone (CCITT).
Framing on the interface must match that on the switch for this ATM link.
Example
The following example specifies G.832 ADM framing on a Cisco 7000 router that has been set up with E3 access to an ATM network:
atm idle-timeout
To change the idle timer for SVCs on an interface that will cause the SVCs to disconnect when inactive for a specified interval, use the atm idle-timeout interface configuration command. To return to the default setting, use the no form of this command.
atm idle-timeout seconds
no atm idle-timeout
Syntax Description
seconds
|
Number of seconds the SVC can be inactive before disconnecting. Setting seconds to 0 disables idle timeouts.
|
Default
120 seconds
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
To disable idle timeouts entirely, set the value of seconds to zero.
Prior to Cisco IOS Release 11.0, idle timeouts were not supported; that is, the prior configuration was equivalent to atm idle-timeout 0.
atm ilmi-keepalive
To enable Interim Local Management Interface (ILMI) keepalives, use the atm ilmi-keepalive interface configuration command. To disable ILMI keepalives, use the no form of this command.
atm ilmi-keepalive [seconds]
no atm ilmi-keepalive [seconds]
Syntax Description
seconds
|
Number of seconds between keepalives. The default is 3 seconds. Values less than 3 seconds are rounded to 3 seconds, and there is no upper bound to the range of values.
|
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example enables ILMI keepalives for the ATM interface 1/0:
Related Command
atm address-registration
atm maxvc
To set the number of virtual circuits (VCs) supported on the AIP card, use the atm maxvc interface configuration command. To restore the default value, use the no form of this command.
atm maxvc number
no atm maxvc
Syntax Description
number
|
Maximum number of supported virtual circuits. Valid values are 512, 1024, or 2048. Default is 2048.
|
Default
2048 virtual circuits
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
This command is supported on Cisco 7000 series and Cisco 7500 series routers; it is not supported on the Cisco 4500 and Cisco 4700 routers, which have a fixed maximum of 1024.
This command sets the maximum value supported for the vcd argument in the atm pvc command. It also determines the maximum number of virtual circuits on which the AIP allows segmentation and reassembly (SAR) to occur. Once this maximum value is set, vcd values of 1 to number - 1 are usable. A vcd value of 0 is not accessible for user traffic.
This command does not affect the virtual path identifier (VPI)-virtual channel identifier (VCI) pair of each virtual circuit.
Example
The following example indicates that the AIP supports no more than 1024 virtual circuits:
Related Command
atm pvc
atm mid-per-vc
To limit the number of message identifier (MID) numbers allowed on each virtual circuit, use the atm mid-per-vc interface configuration command.
atm mid-per-vc maximum
Syntax Description
maximum
|
Number of MIDs allowed per virtual circuit on this interface. The values allowed are 16, 32, 64, 128, 256, 512, and 1024. The default is 16 MIDs per virtual circuit.
|
Default
The default limit is 16 MIDs per virtual circuit.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
This command is supported on Cisco 7000 series and Cisco 7500 series. The maximum value is set to 1024 on the Cisco 4500 and Cisco 4700 routers and therefore, this command is not supported on these routers.
Message identifier (MID) numbers are used by receiving devices to reassemble cells from multiple sources into packets. This is applicable to AAL3/4, not AAL5.
This command limits the number of discrete messages allowed on the PVC at the same time. It does not limit the number of cells associated with each message.
The maximum set by the atm mid-per-vc command overrides the range between the midhigh and midlow values set by the atm pvc command. If you set a maximum of 16 but a midlow of 0 and a midhigh of 255, only 16 MIDs (not 256) are allowed on the virtual circuit.
Example
The following example allows 64 MIDs per ATM virtual circuit:
Related Command
atm pvc
atm multicast
To assign a Switched Multimegabit Data Service (SMDS) E.164 multicast address to the ATM subinterface that supports AAL3/4 and SMDS encapsulation, use the atm multicast interface configuration command.
atm multicast address
Syntax Description
address
|
Multicast E.164 address assigned to the subinterface.
|
Default
No multicast E.164 address is defined.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
This command is supported on Cisco 7000 series, Cisco 7500 series, Cisco 4500, and Cisco 4700 routers.
Each AAL3/4 subinterface is allowed only one multicast E.164 address. This multicast address is used for all protocol broadcast operations.
Example
The following example assigns a multicast E.164 address to the ATM subinterface that is being configured:
atm multicast e180.0999.000
Related Commands
A dagger (†) indicates that the command is documented outside this chapter.
atm aal aal3/4
atm pvc
atm smds-address
interface atm †
atm multipoint-interval
To specify how often new destinations can be added to multipoint calls to an ATM switch in the network, use the atm multipoint-interval interface configuration command. To return to the default interval, use the no form of this command.
atm multipoint-interval interval
no atm multipoint-interval interval
Syntax Description
interval
|
Interval length in seconds, in the range between 0 and 4294967. The default is 30 seconds.
|
Default
30 seconds
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
This command applies to SVCs only, not to PVCs.
This command has no effect unless ATM multipoint signaling is enabled on the interface.
Related Command
atm multipoint-signaling
atm multipoint-signaling
To enable point-to-multipoint signaling to the ATM switch, use the atm multipoint-signaling interface configuration command. To disable point-to-multipoint signaling to the ATM switch, use the no form of this command.
atm multipoint-signaling
no atm multipoint-signaling
Syntax Description
This command has no keywords and arguments.
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
If multipoint signaling is enabled, the router uses existing static map entries that have the broadcast keyword set to establish multipoint calls. One call is established for each logical subnet of each protocol.
All destinations are added to the call. One multicast packet is sent to the ATM switch for each multipoint call. The ATM switch replicates the packet to all destinations.
The atm multipoint-interval command determines how often new destinations can be added to a multipoint call.
Related command
atm multipoint-interval
atm-nsap
To define an ATM map statement for an SVC, use the atm-nsap map-list configuration command in conjunction with the map-list global configuration command. The no form of this command removes the address.
protocol protocol-address atm-nsap atm-nsap-address [class class-name] [broadcast]
no protocol protocol-address atm-nsap atm-nsap-address [class class-name] [broadcast]
Syntax Description
protocol
|
One of the following keywords: appletalk, apollo, bridge, clns, decnet, ip, ipx, vines, xns.
|
protocol-address
|
Destination address that is being mapped to this SVC.
|
atm-nsap-address
|
Destination ATM NSAP address. Must be exactly 40 hexadecimal digits long and in the correct dotted format.
|
class class-name
|
(Optional) Name of a table that contains encapsulation-specific parameters. Such a table can be shared between maps that have the same encapsulation.
|
broadcast
|
(Optional) Indicates this map entry is to be used when the corresponding protocol sends broadcast packets to the interface—for example, Interior Gateway Routing Protocol (IGRP) updates.
|
Default
No map statements are defined.
Command Mode
Map-list configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
This command is required with the map-list command when you are configuring an SVC.
Example
In the following example, a map list named atmsvc includes one map statement for a destination address being mapped:
ip 172.21.97.17 atm-nsap AB.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12 class qos
broadcast
Related Command
map-list
atm nsap-address
To set the NSAP address for an ATM interface using SVC mode, use the atm nsap-address interface configuration command. The no form of this command removes any configured address for the interface.
atm nsap-address nsap-address
no atm nsap-address
Syntax Description
nsap-address
|
The 40-digit hexadecimal NSAP address of this interface (the source address).
|
Default
No NSAP address is defined for this interface.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0.
When you are configuring an SVC, you must use the atm nsap-address command to define the source NSAP address. It identifies a particular port on the ATM network and must be unique across the network.
Note
When ILMI is configured, use the atm esi-address command instead of the atm nsap-address command. The atm esi-address and atm nsap-address commands are mutually exclusive. Configuring the router with the atm esi-address command negates the atm nsap-address setting, and vice versa.
Configuring a new address on the interface overwrites the previous address. The router considers the address as a string of bytes and will not prefix or suffix the address with any other strings or digits. The complete NSAP address must be specified, because this value is used in the Calling Party Address Information Element in the SETUP message to establish a virtual circuit.
ATM NSAP addresses have a fixed length of 40 hexadecimal digits. You must configure the complete address in the following dotted format:
xx.xxxx.xx.xxxxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xx
Note
All ATM NSAP addresses should be entered in the dotted hexadecimal format shown above, which conforms to the User-Network Interface (UNI) specification.The dotted method provides some validation that the address is a legal value. If you know your address format is correct the dots may be omitted.
Example
In the following example, the source NSAP address for the interface is AB.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12:
atm nsap-address AB.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12
atm pvc
To create a permanent virtual circuit (PVC) on the AIP or NPM interface and, optionally, to generate Operation, Administration, and Maintenance (OAM) F5 loopback cells or enable Inverse ATM ARP, use the atm pvc interface configuration command. The no form of this command removes the specified PVC.
atm pvc vcd vpi vci aal-encap [[midlow midhigh] [peak average burst]] [oam seconds]
[inarp minutes]
no atm pvc vcd vpi vci aal-encap [[midlow midhigh] [peak average burst]] [oam seconds]
[inarp minutes]
Syntax Description
vcd
|
Virtual circuit descriptor. A unique number per AIP or NPM that identifies to the processor which VPI-VCI pair to use for a particular packet. Valid values range from 1 to the value set with the atm maxvc command. The AIP or NPM requires this feature to manage packet transmission. The vcd value is not associated with the VPI-VCI pair used for the ATM network cells. The NPM has a hard coded max vcd value of 1023. The AIP has a max vcd value of 2047 which can be lowered using the atm maxvc command.
|
vpi
|
ATM network virtual path identifier (VPI) of this PVC. On the Cisco 7000 and Cisco 7500 series, this value ranges from 0 through 255; on the Cisco |