Table of Contents

abr
atm aal aal3/4
atm abr rate-factor
atm address-registration
atm arp-server
atm clock internal
atm ds3-scramble
atm e164 auto-conversion
atm e3-scramble
atm esi-address
atm exception-queue
atm framing (DS3)
atm framing (E3)
atm ilmi-keepalive
atm ilmi-pvc-discovery
atm lbo
atm max-channels
atm maxvc
atm mid-per-vc
atm multicast
atm multipoint-interval
atm multipoint-signalling
atm nsap-address
atm oam flush
atm oversubscribe
atm pvp
atm rate-queue
atm rawq-size
atm rxbuff
atmsig close atm
atm sig-traffic-shaping strict
atm smds-address
atm sonet stm-1

ATM Commands

This chapter describes the commands available to configure ATM interfaces on the following:

• Cisco 2600 series routers

• Cisco 3600 series routers

• Cisco 4500 routers

• Cisco 4700 routers

• Cisco 7200 series routers

• Cisco 7500 series routers

This chapter also describes the commands available to configure a serial interface for ATM access in other routers.

Note Beginning in Cisco IOS Release 11.3, all commands supported on the Cisco 7500 series routers are also supported on the Cisco 7000 series routers equipped with RSP7000.

For ATM configuration information and examples, refer to the ATM chapters in the Cisco IOS Wide-Area Networking Configuration Guide.

abr

To select available bit rate (ABR) QoS and configure the output peak cell rate and output minimum guaranteed cell rate for an ATM permanent virtual circuit (PVC) or virtual circuit (VC) class, use the abr command in the appropriate command mode. To remove the ABR parameters, use the no form of this command.

Syntax Description

output-pcr	The output peak cell rate in kilobits per second.
output-mcr	The output minimum guaranteed cell rate in kilobits per second.

Defaults

ABR QoS at the maximum line rate of the physical interface.

Command Modes

Interface-ATM-VC configuration (for an ATM PVC). VC-class configuration (for a VC class)

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

If the abr command is not explicitly configured on an ATM PVC, the VC inherits the following default configuration (listed in order of next highest precedence):

• Configuration of any QoS command (abr, ubr, ubr+, or vbr-nrt) in a VC class assigned to the PVC itself.

• Configuration of any QoS command (abr, ubr, ubr+, or vbr-nrt) in a VC class assigned to the PVC's ATM subinterface.

• Configuration of any QoS command (abr, ubr, ubr+, or vbr-nrt) in a VC class assigned to the PVC's ATM main interface.

• Global default value: ABR QoS at the maximum line rate of the PVC.

ABR is a quality of service class defined by the ATM Forum for ATM networks. ABR is used for connections that do not require timing relationships between source and destination. ABR provides no guarantees in terms of cell loss or delay, providing only best-effort service. Traffic sources adjust their transmission rate in response to information they receive describing the status of the network and its capability to successfully deliver data.

In ABR transmission, the peak cell rate (PCR) specifies the maximum value of the allowed cell rate (ACR), and minimum cell rate (MCR) specifies the minimum value for the ACR. ACR varies between the MCR and the PCR and is dynamically controlled using congestion control mechanisms.

Examples

The following example specifies the output-pcr argument to be 100,000 kbps and the output-mcr argument to be 3000 kbps for an ATM PVC:

pvc 1/32
 abr 100000 3000

atm aal aal3/4

To enable support for ATM adaptation layer 3/4 (AAL3/4) on an ATM interface, use the atm aal aal 3/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.

Examples

The following example enables AAL3/4 on ATM interface 2/0:

interface atm2/0
 ip address 172.21.177.178 255.255.255.0
 atm aal aal3/4

atm abr rate-factor

To configure the amount that the cell transmission rate increases or decreases in response to flow control information from the network or destination for available bit rate (ABR) virtual circuits (VCs), use the atm abr rate-factor interface configuration command. To return to the default, use the no form of this command.

Syntax Description

rate-increase-factor	(Optional) Factor by which to increase the data rate. The rate increase factor is specified in powers of 2 from 1 to 32768.
rate-decrease-factor	(Optional) Factor by which to decrease the data rate. The rate decrease factor is specified in powers of 2 from 1 to 32768.

Defaults

ABR rate increase and decrease factor is 16.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

To configure an ABR VC, use the pvc command with the abr keyword.

To verify the ABR rate factor, use the show atm interface atm EXEC command.

Examples

The following example sets the ABR rate factor to 32 for the next cell transferred on ATM interface 4/0:

interface atm 4/0
 atm abr rate-factor 32 32

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.

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

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.

Examples

The following example enables ATM interface I/O to register its address:

interface atm 1/0
 atm address-registration

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 atm arp-server interface configuration command. To remove the definition of an ATM ARP server, use the no form of this command.

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 default timeout value is 20 minutes. The ARP server process is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

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.

Examples

The following example configures ATM on an interface and configures the interface to function as the ATM ARP server for the IP subnetwork:

interface atm 0/0
 ip address 10.0.0.1.255.0.0.0
atm nsap-address ac.1533.66.020000.0000.0000.0000.0000.0000.0000.00
atm rate-queue 1 100
atm maxvc 1024
atm pvc 1 0 5 qsaal
atm arp-server self
 

atm clock internal

To cause the ATM interface to generate the transmit clock internally, use the atm clock internal interface configuration command. To restore the default value, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Defaults

The ATM interface uses the transmit clock signal from the remote connection (the line). The switch provides the clocking.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

This command is meaningless on a 4B/5B physical layer interface module (PLIM).

For SONET interfaces, use the atm clock internal command to configure an ATM port adapter to supply its internal clock to the line.

Examples

The following example causes the ATM interface to generate the transmit clock internally:

atm clock internal

atm ds3-scramble

To enable scrambling of the ATM cell payload for the DS3 physical layer interface module (PLIM) on an ATM interface, use the atm ds3-scramble interface configuration command. To disable scrambling of the ATM cell payload for the DS3 PLIM, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.
11.1	Command syntax changed from ds3 scramble to atm ds3-scramble.

Usage Guidelines

DS3 scrambling is used to assist clock recovery on the receiving end.

Examples

The following example disables DS3 scrambling on the interface:

interface atm 4/0
 no atm ds3-scramble
 

atm e164 auto-conversion

To enable ATM E164 autoconversion, use the atm e164 auto-conversion interface configuration command. To disable autoconversion, use the no form of this command.

Examples

The following example enables E.164 auto conversion on ATM interface 0/0/1:

interface atm 0/0/1
 atm e164 auto-conversion

atm e3-scramble

To enable scrambling of the ATM cell payload for the E3 physical layer interface module (PLIM) on an ATM interface, use the atm e3-scramble interface configuration command. To disable scrambling of the ATM cell payload for the E3 PLIM, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Defaults

E3 scrambling is enabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

E3 scrambling is used to assist clock recovery on the receiving end.

Examples

The following example disables E3 scrambling on the interface:

interface atm 2/0
 no atm e3-scramble

atm esi-address

To enter the end station ID (ESI) and selector byte fields of the ATM network service access point (NSAP) address, use the atm esi-address interface configuration command. The NSAP address prefix is filled in via Integrated Local Management Interface (ILMI) from the ATM switch. To delete the end station address, use the no form of this command.

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.

Defaults

No ESI is defined.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

Prior to 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. A period must be used to separate the esi from the selector arguments.

---

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.

Examples

The following example sets up the ILMI PVC and assigns the ESI and selector field values on the ATM interface 4/0:

interface atm 4/0
 atm pvc 2 0 16 ilmi
 atm esi-address 345678901234.12

atm exception-queue

To set the exception queue length, use the atm exception-queue interface configuration command. To restore the default value, use the no form of this command.

Syntax Description

number

Number of entries in the range of 8 to 256.

Defaults

32 entries

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

This command is supported on ATM interface processor (AIP) for Cisco 7500 series routers. This command is not supported on the ATM port adapter for Cisco 7200 and 7500 series routers, nor is it supported on Cisco 4500 and Cisco 4700 routers.

The exception queue is used for reporting ATM events, such as cycle redundancy check (CRC) errors.

Examples

The following example sets the exception queue to 50 entries:

atm exception-queue 50
 

atm framing (DS3)

To specify DS3 line framing on an ATM interface, use 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.

Syntax Description

cbitadm	(Optional) Specifies C-bit with ATM direct mapping (ADM).
cbitplcp	(Optional) Specifies C-bit with PLCP framing.
m23adm	(Optional) Specifies M23 ATM direct mapping.
m23plcp	(Optional) Specifies M23 with PLCP framing.

Defaults

cbitplcp

Command Modes

Interface configuration

Command History

Release	Modification
11.2	This command was introduced.
11.1	This command was modified to include the Cisco 7200 series routers with the ATM-CES port adapter.

Usage Guidelines

This command is available on Cisco 4500 and 4700 routers with DS3 access speeds, Cisco 7200 series routers, and Cisco 7500 series routers.

Framing on the interface must match that on the switch for this ATM link.

Examples

The following example specifies M23 ADM framing on a router that has been set up with DS3 access to an ATM network:

interface atm 4/0
 atm framing m32adm
 

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.

Syntax Description

g751adm	(Optional) Specifies G.751 ATM Direct Mapping (ADM).
g832adm	(Optional) Specifies G.832 ATM Direct Mapping.
g751plcp	(Optional) Specifies G.751 PLCP encapsulation.

Defaults

g751plcp

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.
11.1	The g751plcp keyword was added, plus information on the Cisco 7200 series router with the ATM-CES port adapter.

Usage Guidelines

The default framing is described in the ITU-T Recommendation G.751.

Framing on the interface must match that on the switch for this ATM link.

Examples

The following example specifies G.832 ADM framing on a router that has been set up with E3 access to an ATM network:

interface atm 4/0
 atm framing g832adm
 

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.

Syntax Description

seconds

(Optional) Number of seconds between keepalives. Values less than 3 seconds are rounded up to 3 seconds, and there is no upper limit.

Defaults

3 seconds

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following example enables ILMI keepalives for the ATM interface 1/0:

interface atm 1/0
 atm address-registration
 atm ilmi-keepalive 

atm ilmi-pvc-discovery

To enable ATM permanent virtual circuit (PVC) discovery, use the atm ilmi-pvc-discovery interface configuration command. To disable PVC Discovery, use the no form of this command.

Syntax Description

subinterface

(Optional) When this keyword is used, the discovered PVCs are assigned to the ATM subinterface whose number matches the discovered PVC's VPI number. For example, a PVC with VPI 1 will be assigned to ATM subinterface 2/0.1.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Examples

The following example enables PVC Discovery on the ATM main interface 2/0. The subinterface keyword is used so that all discovered PVCs with a VPI value of 1 will be assigned to the subinterface 2/0.1:

interface atm 2/0
 pvc RouterA 0/16 ilmi
 exit
 atm ilmi-pvc-discovery subinterface
 exit
 
interface atm 2/0.1 multipoint
 ip address 172.21.51.5 255.255.255.0

atm lbo

To specify the cable length (line build-out) for the ATM interface, use the atm lbo interface configuration command. To return to the default, use the no form of this command.

Syntax Description

long	Specifies a cable length greater than 50 feet.
short	Specifies a cable length less than 50 feet.

Defaults

Short

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Examples

The following example specifies that the ATM interface use a cable less than 50 feet:

interface atm 4/0
 atm lbo short

atm max-channels

To configure the number of transmit channels for the interface, use the atm max-channels interface configuration command. To return to the default, use the no form of this command.

Examples

The following example sets the number of transmit descriptors for the interface to 120.

interface atm 2/0
 atm max-channels 120

atm maxvc

To set the ceiling value of the virtual circuit descriptor (VCD) on the ATM interface, use the atm maxvc interface configuration command. To restore the default value, use the no form of this command.

Examples

The following example sets a ceiling VCD value of 1024 and restricts the AIP to supporting no more than 1024 virtual circuits:

atm maxvc 1024

atm mid-per-vc

Examples

The following example allows 64 MIDs per ATM virtual circuit:

atm mid-per-vc 64

atm multicast

To assign a Switched Multimegabit Data Service (SMDS) E.164 multicast address to the ATM subinterface that supports ATM adaptation layer 3/4 (AAL3/4) and SMDS encapsulation, use the atm multicast interface configuration command.

Each AAL3/4 subinterface is allowed only one multicast E.164 address. This multicast address is used for all protocol broadcast operations.

Examples

The following example assigns a multicast E.164 address to the ATM subinterface that is being configured:

atm multicast e180.0999.000

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.

Syntax Description

interval

Interval length in seconds, in the range 0 to 4294967.

Defaults

30 seconds

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command applies to switched virtual circuits (SVCs) only, not to permanent virtual circuits (PVCs).

This command has no effect unless ATM multipoint signalling is enabled on the interface.

Examples

The following example enables point-to-multipoint signalling on the ATM interface 2/0. It also specifies that new destinations can be added to multipoint calls every 60 seconds:

interface atm 2/0
 atm multipoint-signalling
 atm multipoint-interval 60

atm multipoint-signalling

To enable point-to-multipoint signalling to the ATM switch, use the atm multipoint-signalling interface configuration command. To disable point-to-multipoint signalling to the ATM switch, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

If multipoint signalling 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.

Examples

The following example enables point-to-multipoint signalling on the ATM interface 2/0:

interface atm 2/0
 atm multipoint-signalling

atm nsap-address

To set the network service access point (NSAP) address for an ATM interface using switched virtual circuit (SVC) mode, use the atm nsap-address interface configuration command. To remove any configured address for the interface, use the no form of this command.

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).

Defaults

No NSAP address is defined for this interface.

Command Modes

Interface configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

When 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 the Integrated Local Management Interface (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.

---

Examples

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 oam flush

To drop all current and future Operation, Administration, and Maintenance (OAM) cells received on an ATM interface, use the atm oam flush interface configuration command. To receive OAM cells on an ATM interface, use the no form of this command.

Syntax Description

This command has no arguments or keywords.

Defaults

Dropping of OAM cells is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
11.3	This command was introduced.

Examples

The following example drops all current and future OAM cells received on the ATM main interface with slot 0 and port 0:

interface atm 0/0
 atm oam flush
 

atm oversubscribe

To manage bandwidth for service categories other than constant bit rate (CBR), use the atm overscribe global configuration command on a per-ATM-interface basis. To disable bandwidth management, use the no form of the command.

Syntax Description

There are no optional keywords for this command.

Defaults

The default is to allow as much bandwidth as possible with no upper limits. The no form of the atm overscribe command enables bandwidth management on any ATM interface you specify.

Command Modes

Global configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

When you type the enabling command (the no version), a check determines if the ATM link is already oversubscribed. If so, the command is rejected. Otherwise, the total bandwidth available on the link is recorded and all future connection setup requests are monitored to ensure that the link is not oversubscribed.

The bandwidth allocated for each service category is displayed in the output of the show atm interface atm command.

The ATM bandwidth manager keeps track of bandwidth used by VCs on a per-interface basis. Because many services require guaranteed bandwidth (for variable bit rate-real time (VBR-RT), available bit rate (ABR), CBR, for instance), bandwidth management is required. The purpose of the bandwidth manager is to reserve resources for connections that require guaranteed services. Bandwidth management for CBR is turned on automatically for all interfaces supporting CBR. Bandwidth management for other service categories must be turned on by the user. All service categories outside CBR is monitored only if specifically requested.

Note Because unspecified bit rate (UBR) does not provide any guarantees, bandwidth specified for a UBR connection is not used in any calculations.

In all cases, bandwidth check for a PVC is done when the PVC is configured. Bandwidth check for a SVC is done when a signalling call is placed or received.

When you specify the atm pvp command, the system checks if the specified bandwidth is available on the interface. If the bandwidth available is greater than or equal to the peak rate specified for the Permanent Virtual Path (PVP), the command is accepted, otherwise the command is rejected.

Within the VC mode the steps taken to check for bandwidth available are to ascertain if the bandwidth is already used by the VC to fulfill the request. If the VC being configured is a PVC and belongs to a PVP, the bandwidth available on the PVP is used for the check; otherwise the bandwidth available on the interface is used for the check.

When configuring services within a VC class, the steps taken are to check if the new bandwidth requirement can be fulfilled for all VCs using the class (on a per-interface basis), by comparing with the bandwidth available on the corresponding interface.

Bandwidth checking for an SVC occurs before a SETUP message is sent for an outbound call. If the bandwidth check fails, the SETUP message is not sent. If the bandwidth check passes, the traffic class from which the service category is inherited, is updated with the requirements for the new SVC.

When an SVC setup is requested for remotely initiated calls, a bandwidth check occurs as soon as the SETUP message is received. This bandwidth check has two components:

• Match the bandwidth requested by the remote end with the bandwidth configured locally

• Check if bandwidth configured locally can be satisfied currently

If the bandwidth check fails, a RELEASE message is sent out and the call is rejected. If the bandwidth check passes, resources are reserved for the VC and the call is accepted.

Examples

The following example displays the available bandwidth after you enter VC mode. Notice that the bandwidth is specified in kbps.

Router# show atm interface atm 2/0
  Interface ATM2/0:
  AAL enabled: AAL5, Maximum VCs:1024, Current VCCs:5
 
  Maximum Transmit Channels:64
  Max. Datagram Size:4496
  PLIM Type:SONET - 155Mbps, TX clocking:LINE
  Cell-payload scrambling:OFF
  sts-stream scrambling:ON
  877 input, 120843834 output, 0 IN fast, 20 OUT fast
  ABR parameters, rif:16 rdf:16, 0 out drop
  Bandwidth distribution :CBR :16000  Avail bw = 139000 
  Config. is ACTIVE
 

Notice that the bandwidth is specified as (139000) kbps.

atm pvp

To create a permanent virtual path (PVP) used to multiplex (or bundle) one or more virtual circuits (VCs) (especially circuit emulation service (CES) and data VCs), use the atm pvp interface configuration command. To remove a PVP, use the no form of this command.

Syntax Description

vpi

ATM network virtual path identifier (VPI) of the VC to multiplex on the permanent virtual path. The range is 0 to 255. The VPI is an 8-bit field in the header of the ATM cell. The VPI value is unique only on a single link, not throughout the ATM network because it has local significance only. The VPI value must match that of the switch. The number specified for the vpi must not already exist. If the number specified for the vpi is already being used by an existing VC, this command is rejected.

peak-rate

(Optional) Maximum rate in kbps at which the PVP can transmit data. The range is 84 kbps to line rate. The default is the line rate.

Defaults

PVP is not configured.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

The ATM-CES port adapter supports multiplexing of one or more VCs over a virtual path that is shaped at a constant bandwidth. For example, you can buy a virtual path service from an ATM service provider and multiplex both the CES and data traffic over the virtual path.

All subsequently created VCs with a vpi argument matching the vpi specified with the atm pvp command are multiplexed onto this PVP. This PVP connection is an ATM connection where switching is performed on the VPI field of the cell only. A PVP is created and left up indefinitely. All VCs that are multiplexed over a PVP share and are controlled by the traffic parameters associated with the PVP.

Changing the peak-rate argument causes the ATM-CES port adapter to go down and then back up.

When you create a PVP, two VC are created (VCI 3 and 4) by default. These VCs are created for VP end-to-end loopback and segment loopback OAM support.

To verify the configuration of a PVP, use the show atm vp EXEC command.

Examples

The following example creates a permanent virtual path with a peak rate of 2000 kbps. The subsequent VC created are multiplexed onto this virtual path.

interface atm 6/0
 atm pvp 1 2000
 atm pvc 13 1 13 aal5snap
 exit
interface cbr 6/1
 ces circuit 0
 ces pvc 9 interface atm6/0 vpi 1 vci 100
 exit

Related Commands

Command	Description
show atm vp	Displays the statistics for all VPs on an interface or for a specific VP.

atm rate-queue

To create a permanent rate queue or specify a rate queue tolerance, use the atm rate-queue interface configuration command. To remove a rate queue or rate queue tolerance, use the no form of this command.

Examples

The following example configures a permanent rate queue with a queue-number of 1 and a speed of
100 Mbps:

atm rate-queue 1 100
 

interface atm 2/0
atm rate-queue tolerance svc pvc 20

atm rawq-size

To define the ATM Interface Processor (AIP) raw-queue size, use the atm rawq-size interface configuration command. To restore the default value, use the no form of this command.

Examples

The following example allows a maximum of 48 cells in the raw queue:

atm rawq-size 48

atm rxbuff

To set the maximum number of receive buffers for simultaneous packet reassembly, use the atm rxbuff interface configuration command. To restore the default value, use the no form of this command.

Examples

The following example allows the AIP to perform a maximum of 300 packet reassemblies simultaneously:

atm rxbuff 300

atmsig close atm

To disconnect a switched virtual circuit (SVC), use the atmsig close atm EXEC command.

Examples

The following example closes SVC 2 on ATM interface 4/0:

atmsig close atm4/0 2

atm sig-traffic-shaping strict

To specify that a switched virtual circuit (SVC) should be established on an ATM interface only if shaping can be done per the signaled traffic parameters, use the atm sig-traffic-shaping strict interface configuration command. To disable strict traffic shaping, use the no form of this command.

Examples

The following example allows an SVC to be established on an ATM interface using only signaled traffic parameters:

atm sig-traffic-shaping strict

atm smds-address

To assign a unicast E.164 address to the ATM subinterface that supports ATM adaptation layer 3/4 (AAL3/4) and Switched Multimegabit Data Service (SMDS) encapsulation, use the atm smds-address interface configuration command.

Examples

The following example assigns a unicast E.164 address to the ATM subinterface that is being configured:

atm smds-address c141.555.1212

atm sonet stm-1

To set the mode of operation and thus control type of ATM cell used for cell-rate decoupling on the SONET physical layer interface module (PLIM), use the atm sonet stm-1 interface configuration command. To restore the default Synchronous Transport Signal level 3, concatenated (STS-3c) operation, use the no form of this command.

Examples

The following example specifies ATM SONET STM-1:

atm sonet stm-1

Posted: Thu Mar 30 18:40:20 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.