ATM and Layer 3 Switch Router Command Reference, 12.1(10)E
ATM Commands

Table of Contents

ATM Commands
atm abr-mode (Catalyst 8510 MSR and LightStream 1010)
atm access-group
atm accounting (interface)
atm accounting collection
atm accounting enable
atm accounting file
atm accounting selection
atm accounting trap threshold
atm address
atm address-registration
atm aesa gateway
atm arp-server
atm auto-configuration
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 cac best-effort-limit
atm cac framing overhead
atm cac link-sharing
atm cac max-cdvt
atm cac max-mbs
atm cac max-min-cell-rate
atm cac max-peak-cell-rate
atm cac max-sustained-cell-rate
atm cac overbooking
atm cac service-category
atm cdvt-default
atm connection-traffic-table-row
atm e164 address
atm e164 auto-conversion
atm e164 translation
atm e164 translation-table
atm esi-address
atm filter-expr
atm filter-set
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 hierarchical-tunnel
atm idle-timeout
atm iisp
atm ilmi default-access permit
atm ilmi-enable
atm ilmi-keepalive
atm input-xlate-table minblock
atm input-xlate-table autominblock
atm input-xlate-table autoshrink
atm input-xlate-table minblock vpi
atm input-xlate-table autominblock
atm input-xlate-table autoshrink
atm interface-group
atm lecs-address
atm lecs-address-default
atm link-distance
atm manual-well-known-vc
atm maxvc-number
atm maxvci-bits
atm maxvp-number
atm maxvpi-bits
atm mbs-default
atm nni
atm nsap-address
atm nsap (map-list)
atm oam (global)
atm oam (interface)
atm output-queue (Catalyst 8510 MSR and LightStream 1010)
atm output-threshold (Catalyst 8510 MSR and LightStream 1010)
atm over-subscription-factor (Catalyst 8510 MSR and LightStream 1010)
atm pacing
atm pnni admin-weight
atm pnni aggregation-token
atm pnni explicit-path
atm pnni link-selection
atm pnni mobile
atm pnni node
atm pnni nodal-hierarchy-list highest-level
atm prefix
atm pvc
atm pvp
atm qos default
atm rmon collect
atm rmon enable
atm rmon portselgrp
atm route
atm route-optimization (EXEC)
atm route-optimization (interface)
atm route-optimization percentage-threshold
atm router pnni
atm routing-mode
atm service-category-limit (Catalyst 8510 MSR and LightStream 1010)
atm service-class
atm signalling cug access
atm signalling cug alias
atm signalling cug assign
atm signalling diagnostics
atm signalling enable
atm signalling ie aal5 mode
atm signalling ie forward
atm signalling vpci
atm snoop
atm snoop-vc
atm snoop-vp
atm soft-vc
atm soft-vp
atm sustained-cell-rate-margin-factor
atm svc-frame-discard-on-aal5ie
atm svc-clear by-priority
atm svc-upc-intent
atm svcc vci min
atm svcc vpi max
atm svpc vpi max
atm threshold-group discard-threshold
atm threshold-group marking-threshold
atm threshold-group max-cells
atm threshold-group max-queue-limit
atm threshold-group min-queue-limit
atm threshold-group name
atm threshold-group service
atm template-alias
atm traffic shaping enable
atm traffic shaping thresholds
atm uni
atm-vc

ATM Commands


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

  • Catalyst 8540 MSR
  • Catalyst 8510 MSR and LightStream 1010

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


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

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

atm abr-mode (Catalyst 8510 MSR and LightStream 1010)

To select efci marking, relative-rate marking, or both, use the atm abr-mode global configuration command on ABR connections. To assign the default value to ABR mode, use the no form of this command.

atm abr-mode {efci | relative-rate | all}
no atm abr-mode

Syntax Description

efci

When cells arrive on ABR connections to a congested (as indicated by the efci threshold) output queue on the interface, the efci bit in the cell header is set.

relative-rate

When a backward RM cell is received on an ABR connection on an interface (from outside the switch), its congestion bit is set if the forward-direction interface is congested (as indicated by the abr relative-rate threshold).

all

Indicates both efci and relative-rate modes of congestion notification.

Defaults

relative-rate

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

12.0(3c)W5(9)

Modified: (Catalyst 8510 MSR and LightStream 1010) added

Usage Guidelines

This configuration command changes the global type of notification used on ABR connections to send a congestion alert to the end stations. This change can be made if the switch connects to a network or end station that uses the new technique. The use of all causes both efci and relative-rate marking to be used.

Examples

In the following example, the ABR mode of the switch is set to efci.

Switch(config)# atm abr-mode efci

Related Commands

Command  Description 

show atm resource

Displays global resource manager configuration and status.

atm access-group

To subscribe an interface or subinterface to an existing ATM address pattern-matching filter expression, use the atm access-group interface configuration command. To delete an address access filter subscription on a specified interface of subinterface, use the no form of this command.

atm access-group name [in | out]
no atm access-group name [in | out]

Syntax Description

name

The filter expression or filter set.

in

Specifies that the filter should be applied to an incoming SETUP message.

out

Specifies that the filter should be applied to an outgoing SETUP message.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command affects ATM signalling SETUP requests received or transmitted by the switch on an interface.

You should use the atm filter-set command prior to using this command. For descriptions of filter sets and expressions, see the atm filter-expr, and atm filter-set global configuration commands.

Each interface has only one access group. If you create a new access group, it overrides any existing group.

Examples

The following is sample output from the atm access-group command.

Switch(config-if)# atm access-group atm_filter_expr1 in
Switch(config-if)# atm access-group atm_filter_expr2 out

Related Commands

Command  Description 

atm filter-expr

Configures an ATM address filter that matches patterns.

atm filter-set

Creates an ATM address filter set.

show atm filter-expr

Displays a specific ATM filter expression or a summary ATM filter expression.

show atm filter-set

Displays a specific ATM filter set or a summary ATM filter set.

atm accounting (interface)

To enable ATM accounting on a specific interface, use the atm accounting interface configuration command. To disable ATM accounting on a specific interface, use the no form of the command.

atm accounting
no atm accounting

Syntax Description

This command has no keywords or arguments.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

When accounting is disabled for an interface, accounting stops keeping track of the VCs on that interface and treats the interface as if it were shut down. For the VCs that satisfy the selection criteria, accounting writes records to the active file; however, the VCs are not affected.

Use the show atm accounting EXEC command to determine which interfaces are using ATM accounting.

Examples

The following example shows how to enable ATM accounting on interface ATM 1/0/0.

Switch(config)# interface atm 1/0/0
Switch(config-if)# atm accounting

Related Commands

Command  Description 

interface

Configures an interface type and enters interface configuration mode.

atm accounting collection

To control collection of ATM accounting data into a specific file, use the atm accounting collection EXEC command.

atm accounting collection {collect-now | swap} filename

Syntax Description

collect-now

Immediately captures ATM accounting information for all connections that meet the min-age criteria.

swap

Stops the data collection in the active file and activates the passive file so it collects data. The new passive file is now available for downloading.

filename

Specifies the name for the ATM accounting file.

Command Modes

Privileged EXEC

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

Use the collect-now option to return a message with the number of records that were written.

Use the swap option to return a message with the number of records that were written.

Use the show atm accounting EXEC command to show the active and ready file sizes and the number of records.

Examples

The following example shows how to perform an on-demand collection to the file acctng_file1.

Switch# atm accounting collection collect-now acctng_file1
Switch# Collect-now found 12 SVCs with life longer than min-age

The following example shows how to perform a swap operation on the file acctng_file1.

Switch# atm accounting collection swap acctng_file1
Switch# File Swap Done. New Ready File 4999702 bytes (#records 28796); Active File 65 bytes (#records 0)

Note   The only filename currently allowed is acctng_file1.

Related Commands

Command  Description 

atm accounting file

Used to enable an ATM accounting file and to enter the accounting file configuration mode.

atm accounting enable

To enable the ATM VC accounting feature globally, use the atm accounting enable global configuration command. To disable this feature, use the no form of this command.

atm accounting enable
no atm accounting enable

Syntax Description

This command has no keywords or arguments.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release  Modification 

11.2(5)

New command (originally atm accounting (global)

11.2(8.0.1)

Modified: enable added: atm accounting enable (global)

11.3(3a)

Modified: (global) taken out

Usage Guidelines

Accounting is enabled globally for the switch on interfaces where accounting is configured. An error message is given if memory is fragmented and ATM accounting cannot get two memory chunks of
5 MB each. The switch needs 32 MB of memory or it returns an error message.

The switch must have this command saved in the NVRAM configuration file. Use the following steps to enable ATM accounting:


Step 1   Enable ATM accounting in global configuration mode.

Step 2   Exit global configuration mode.

Step 3   Use the copy running-config startup-config command to save the command in NVRAM.

Step 4   Reboot the switch.





Examples

The following example shows how to enable ATM accounting.

Switch(config)# atm accounting enable

Related Commands

Command  Description 

atm accounting (interface)

Enables ATM accounting on a specific interface.

atm accounting file

To enable an ATM accounting file and enter the accounting file configuration mode, use the atm accounting file global configuration command. To disable an ATM accounting file, use the no form of this command.

atm accounting file filename
no atm accounting file filename

Note   The atm accounting file global configuration command changes the configuration mode to ATM accounting, and the new prompt appears: Switch(config-acct-file)#

To modify the fields in the ATM accounting file, use the following ATM accounting mode configuration subcommands. To set the fields to their default values, use the no form of these subcommands.

collection-modes [periodic] [on-release]
default {collection-modes | description | enable | failed-attempts | interval | min-age}
description string
enable
failed-attempts [none | [regular | soft]]
interval seconds
min-age seconds
remote-log [only] primary-host {hostname | ip-address | tcp-port#} [alternate-host {alt-host-name | alt-ip-address | alt-tcp-port#}]
no collection-modes [periodic] [on-release]
no description string
no enable
no failed-attempts [none | [regular | soft]]
no interval
no min-age
no remote-log

Syntax Description

filename

Specifies the filename of the accounting file.
The only filename currently allowed is acctng_file1.

Defaults

See "Syntax Description."

Command Modes

Global configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

The ATM accounting configuration mode subcommands are described in Table 2-1.

Table 2-1   ATM Accounting Configuration Mode Subcommands

Subcommand  Description 

collection-modes

Initializes the collection mode and allows you to specify at what time accounting data is recorded in the file: on the release of a connection (on-release), or periodically (periodic).

default

Sets a parameter to its defaults.

description

Configures a description of the ATM accounting file with a limit of 64 characters.

enable

Activates ATM accounting data collection to a specified file.

failed-attempts

Configures the writing of records for initial connection attempts, as follows:

  • regular—Records regular SVC/SVP numbers that originate or terminate at the switch interface.
  • soft—Records soft PVC/PVP numbers that originate or terminate at the switch interface.
  • none—Does not record failed attempts.

Default is regular and soft.

interval

Sets the period for periodic collection of accounting records. The default is 3600 seconds.

min-age

Configures the value of the minimum age of the VC for on-release or periodic collection of accounting records. The default is 3600 seconds.

remote-log

Establishes a TCP connection from the switch to a PC or workstation, as follows:

  • only—When you specify only, no local storage of accounting occurs.
  • host-name/ip-address—Host name or IP address of the accounting records receiving host computer.
  • tcp port#—The server communicates with the TCP port to connect to the accounting agent in the switch.
  • alt-host-name/alt-ip-address—Host name or IP address of a standby accounting records receiving host computer.
  • alt-tcp-port#—Alternate TCP port with which the server communicates to connect to the accounting agent in the switch.

To change the fields, you can either provide new values, or use the no form of the command.

Changes made to the list affect the file format. The change takes effect only for the next collection, for example, after using the atm accounting collection swap global configuration command. Changes to the connection types take effect immediately.

The ATM selection table is created using the default value of one. You can only modify the following fields in the file:

  • description
  • failed-attempts
  • min-age

  • Note   The only filename currently allowed is acctng_file1.

Examples

The following example shows how to enter the ATM accounting file configuration mode.

Switch# configure terminal
Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)#

The following example shows how to enter the ATM accounting file configuration mode and configure a description that is displayed in the header of the file when using the show atm accounting command.

Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)# description Main accounting file for engineering

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

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

The following example shows how to enter the ATM accounting file configuration mode and configure remote-log.

Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)# remote-log 172.20.52.3 6001 alternate-host cisco-lab 7001

Related Commands

Command  Description 

atm accounting collection

Controls collection of ATM accounting data into a specific file.

atm accounting selection

Enables ATM accounting selection and enters the ATM accounting selection configuration mode.

atm accounting selection

To enable ATM accounting selection and enter the ATM accounting selection configuration mode, use the atm accounting selection global configuration command. To disable ATM accounting selection, use the no form of this command.

atm accounting selection index
no atm accounting selection index

Note   The atm accounting selection global configuration command changes the configuration mode to ATM accounting selection mode, and the following new prompt appears: Switch(config-acct-sel)#

To configure the ATM accounting selection, use the following ATM accounting configuration mode subcommands. To set the selection parameters to their defaults, use the no form of these commands.

connection-types [type] default {connection-types | list}list
no connection-types [type]
no list

Syntax Description

index

Configures the ATM accounting selection index number.

Defaults

No default selection index. See the individual subcommand defaults.

Command Modes

Global configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

This release supports only one ATM selection table entry which cannot be deleted.

Examples

The following example specifies the ATM accounting selection index as 1 and restores the
default connection types.

Switch# configure terminal
Switch(config)# atm accounting selection 1
Switch(config-acct-sel)# default connection-types

Related Commands

Command  Description 

atm accounting collection

Controls collection of ATM accounting data into a specific file.

atm accounting file

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

connection-types

Sets types of connections for atm accounting selection.

atm accounting trap threshold

To configure the threshold value which controls the generation of an ATM accounting SNMP trap, use the atm accounting trap threshold global configuration command. To restore the default value of the trap threshold, use the no form of the command.

atm accounting trap threshold percent-value
no atm accounting trap threshold

Syntax Description

percent-value

Specifies the value as a percent of the maximum file size.

Defaults

The default value for the trap threshold is 90.

Command Modes

Global configuration

Command History

Release  Modification 

11.2(5)

New command (originally atm accounting trap)

11.2(8.0.1)

Modified: Added threshold

Usage Guidelines

To see the file size, threshold value, and trap statistics, use the show atm accounting EXEC command.

Examples

The following example changes the ATM accounting trap threshold to 80.

Switch(config)# atm accounting trap threshold 80

Related Commands

Command  Description 

connection-types

Sets types of connections for atm accounting selection.

atm address

To assign a 20-byte ATM address to the switch, use the atm address global configuration command. To delete a specific ATM address, use the no form of this command.

atm address address-template
no atm address address-template

Syntax Description

address-template

The address template can be a full 20-byte address or a partial 13-byte. When a partial address is assigned, this command automatically sets one of the switch's 6-byte MAC addresses in the ESI part, and puts a 0 in the selector part.

Defaults

When no atm address has been configured, an autoconfigured ATM address is assigned. Refer to the ATM Switch Router Software Configuration Guide for more information.

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

You can have multiple ATM addresses. The first address in the list is the active ATM address for this switch router. When you delete the current active ATM address, the next address in the list becomes the active ATM address.

In autoconfiguration mode, the switch router establishes an address according to the format specified in the ATM Switch Router Software Configuration Guide.

The first 13-byte prefixes of all of the addresses are used by ILMI to assign addresses to end stations connected to the UNI ports (unless there is a prefix assigned per port). PNNI also summarizes all of the address prefixes automatically in reachable address advertisements. Refer to the auto-summary command for more information.

The active ATM address determines which address is advertised by PNNI as the ATM address of the PNNI local-nodes. Each local-node uses the active ATM address with the selector byte modified to match the local-node index.

In addition, the active ATM address is used as the source prefix for generating the PNNI peer group IDs and node IDs. However, the peer group IDs and node IDs are only updated after the local-node is disabled and reenabled. Therefore, it is recommended that a change to the active ATM address should be followed by a disable and enable of PNNI local-node 1, which will also update the identifiers for all higher local-nodes.

For two switches to belong to the same PNNI peer group, they need to have the same peer group identifier. Peer group identifiers must be prefixes of private ATM addresses, which means the organization that administers the peer group has assignment authority over that prefix. For more information, refer to the ATM Switch Router Software Configuration Guide.

In autoconfiguration mode, all switche routers have the same peer group identifier based on the first seven bytes of the autoconfigured ATM address.

The first 13-byte prefix of the active address is also used to automatically generate ATM addresses for each ATM interface that can be used for soft PVCs and PVPs to identify the destination ATM interface.

Examples

The following example shows how to assign a 20-byte ATM address to the switch.

Switch# configure terminal
Switch(config)# atm address 47.009181000000000000000001

The following example shows how to change the active ATM address for the switch and to update the PNNI local-node identifiers based on the new active ATM address prefix.


Step 1   Configure the desired new address or prefix to be added to the list of ATM addresses for the switch.

Switch# configure terminal
Switch(config)# atm address 47.00918100002

Step 2   Determine the current active ATM address by using the show atm addresses command. Then remove the current active ATM address, so that the desired new address will be the first in the list. If desired, the removed ATM address(es) can then be readded to appear later in the list.

Switch(config)# no atm address 47.00918100000000400B003081.00400B003081.00

Step 3   (Optional) Update all PNNI local-node identifiers by disabling and reenabling local-node  1.

Switch(config)# atm router pnni
Switch(config-atm-router)# node 1 disable
Switch(config-pnni-node)# node 1 enable

Step 4   (Optional) Save the running configuration to be used as the startup configuration in the event of a reboot.

Switch# copy running-config startup-config





Related Commands

Command  Description 

atm prefix

Configures an ILMI address prefix for an ATM interface.

auto-summary

Allows default summary addresses to be generated based on the switch router's ATM address.

show atm addresses

Displays the active ATM addresses on a switch router.

atm address-registration

To enable the switch to engage in address registration on an interface using the ILMI protocol,
and to enable the optional per-interface access filters on ILMI address registration, use the
atm address-registration interface configuration command. To disable ILMI address registration functions on an interface, use the no form of this command.

atm address-registration [permit {all | matching-prefix [wellknown-groups | all-groups]}]
no atm address-registration

Syntax Description

all

Permit all AESAs registered by attached end systems.

matching-prefix

Permit AESAs where the first 13 bytes of the address match an ILMI prefix used on the interface. These ILMI prefixes can be configured using the global atm address command or the per-interface atm prefix command. The ILMI prefixes used on the interface can be shown using the show atm ilmi-status command.

wellknown-groups

Permit well-known group addresses assigned by the ATM Forum and AESAs that match an ILMI prefix used on the interface.

The well-known group addresses include the old LECS address (47.0079.0000.0000.0000.0000.0000.00A0.3E00.0001.00) and any address matching the ATM Forum address prefix for well-known addresses. (C5.0079.0000.0000.0000.0000.0000.00A0.3E)

all-groups

Permit all group addresses, including the well-known group addresses, and the AESAs that match an ILMI prefix used on the interface.

Defaults

ILMI address registration is enabled by default. If no optional keywords are configured, the global default access filter for ILMI address registration is used, as specified through the atm ilmi default-access permit global configuration command.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

The atm address-registration command does not apply to the ATM 0 interface.

The atm address-registration command enables a switch to participate in ILMI address registration. When the switch is on the network side of a UNI, the switch sets one or more network prefixes on the peer IME and accepts addresses registered by the peer IME. If the interface does not come up as a UNI, then ILMI address registration is not active, even if it was previously configured to be enabled.

The optional keywords allow configuration of per-interface access filters, in order to allow or deny certain ILMI registered addresses. If specified, the per-interface access filter overrides the global default access filter for ILMI address registration.


Note   If the Cisco SSRP for LAN Emulation is used in this network, ILMI registration of well-known group addresses should be permitted. The SSRP allows the active LECS to register the well-known LECS address with the switch router. Either the permit all, permit matching-prefix wellknown-groups, or permit matching-prefix all-groups option should be configured.

In order to allow certain addresses to be registered via ILMI, while also restricting them from being advertised through PNNI, the PNNI suppressed summary address feature should be used instead of the access filters for ILMI address registration (see the summary-address command for additional information).

The access filters option of this command allows configuration of per-interface access filters for ILMI registration to override the global defaults of the access filters.

Examples

The following example shows how to disable ILMI address registration on ATM interface 1/0/0.

Switch(config)# interface atm 1/0/0
Switch(config-if)# no atm address-registration

The following example enables ILMI address registration on ATM interface 1/0/0 and configures the per-interface access filter for ILMI address registration to allow well-known group addresses and addresses with matching prefixes.

Switch(config)# interface atm 1/0/0
Switch(config-if)# atm address-registration permit matching-prefix wellknown-groups
%ATM-5-ILMIACCFILTER: New access filter setting will be applied to registration of new addresses on ATM1/0/0.

Related Commands

Command  Description 

atm address

Assigns a 20-byte ATM address to the switch router.

atm ilmi default-access permit

Sets the global default access filter for ILMI-registered addresses on all interfaces.

atm ilmi-enable

Enables the ILMI on a port.

atm prefix

Configures an ILMI address prefix for an ATM interface.

show atm ilmi-status

Displays the ILMI-related status information.

summary-address

Configures summary address prefixes on a PNNI node.

atm aesa gateway

To configure an AESA gateway address on an ATM switch interface that connects to a service provider maintaining a separate ATM addressing plan, use the atm aesa gateway interface configuration command. To restore the default (disabled), use the no form of this command.

atm aesa gateway aesa-address
no atm aesa gateway

Syntax Description

aesa-address

Specifies a forwarding 20-octet AESA that is used when a call matching the ATM address prefix is forwarded across the specified interface.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

12.0(4a)W5(11a)

New command

Usage Guidelines

When outgoing calls are configured to use the forwarding AESA address as the called party address
(see the atm route command), this AESA is used as the forwarding calling party address.

When incoming calls are received on the interface that specifies the forwarding AESA as the called party address, the called and calling party addresses are removed from the signalling message and replaced by the new called and calling party subaddresses.

This new address is not registered with routing because it is used only as this switch's address for this interface. It is not used as the address of destination from this interface.

The combination of the atm aesa gateway command and the atm-aesa option of the atm route command provides a general mechanism for interconnection of private ATM networks across an ATM service provider. This combination allows one AESA for the interface to the ATM service provider network, with many AESA addresses present in the private network behind the interface.

Examples

The following example shows how to configure the AESA gateway address:

Switch(config)# interface atm 0/1/2
Switch(config-if)# atm aesa gateway 91.999999999999999999999999.111111111111.00

Related Commands

Command  Description 

atm route

Specifies a static route to a reachable address prefix.

show atm interface

Displays ATM-specific information about an ATM interface.

show atm vc

Displays the ATM layer connection information about the virtual connection.

show interfaces

Displays the interface configuration, status, and statistics.

atm arp-server

To identify an ARP server for the IP network, or set TTL values for entries in the ATM ARP table, use the atm arp-server interface configuration command. To disable an ARP server process, 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

Specifies the current switch as the ATM ARP server.

minutes

Number of minutes a destination entry listed in the ATM ARP server's ARP table is kept before the server takes any action to verify or time out the entry.

nsap-address

NSAP address of an ATM ARP server.

Defaults

The ARP server process is disabled. The default timeout value is 20 minutes.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command applies only to route processor and IP interfaces.

If an NSAP address is specified, the ARP client on this interface uses the specified host as an
ARP server.

Multiple ATM ARP servers can be specified by repeating the command. The no option is used to remove the definition of an ATM ARP server. 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."

Related Commands

Command  Description 

show atm arp-server

Displays the ATM ARP server table.

atm auto-configuration

To enable or disable ILMI autoconfiguration, use the atm auto-configuration interface configuration command. To disable this feature, use the no form of this command.

atm auto-configuration
no atm auto-configuration

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command enables or disables ILMI autoconfiguration procedures, as specified in Section 8.3.3 of the ATM Forum ILMI 4.0 Specification.

Among the variables covered by ILMI autoconfiguration are the interface protocol and version, interface side (user or network), UNI type (public or private), and the maximum number of VPI bits and VCI bits. Configuration of the atm auto-configuration command on an interface overwrites any previous configuration of the atm iisp, atm nni, atm maxvci-bits, and atm maxvpi-bits commands.

When autoconfiguration is enabled, ATM signalling and ILMI are restarted automatically on the interface. When ATM signalling is restarted, all switched virtual connections across the interface are cleared; permanent virtual connections are not affected.

When the peer switch has a device type of node but responds to GetRequest messages for atmfAtmLayerNniSigVersion with noSuchName, the default NNI protocol depends on the ATM routing mode (see the atm routing-mode command). When the ATM routing mode is set to static, the default NNI protocol is IISP. Otherwise, the default NNI protocol is PNNI 1.0. These defaults are relevant when the peer switch is a LightStream 1010 ATM with software version 11.1.

Examples

The following example shows how to enable ILMI autoconfiguration on interface ATM 0/1/2.

Switch(config)# interface atm 0/1/2
Switch(config-if)# atm auto-configuration
Switch(config-if)#
%ATM-5-ATMSOFTSTART:Restarting ATM signalling and ILMI on ATM0/1/2

Related Commands

Command  Description 

atm iisp

Configures ATM IISP on the specified physical or logical (VP tunnel) port.

atm ilmi-enable

Enables the ILMI on a port.

atm maxvci-bits

Configures the maximum number of active bits of VCI supported on an ATM interface.

atm maxvpi-bits

Configures the maximum number of active VPI bits supported on an ATM interface.

atm nni

Configures an ATM NNI on the specified physical or logical (VP tunnel) port.

atm routing-mode

Restricts the mode of ATM routing on an ATM switch router.

show atm ilmi-status

Dispays the ILMI-related status information.

show atm interface

Displays ATM-specific information about an ATM interface.

atm backward-max-burst-size-clp0

To change the maximum number of high-priority cells coming from the destination to the source
at the burst level on the SVC, use the atm backward-max-burst-size-clp0 map-class configuration command. To restore the default, use the no form of this command.

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 switch router at the burst level.

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command. Originally cellmax-burst

11.2(8.0.1)

Changed named from cellmax-burst

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp0 indicates this command affects only cells with a CLP of 0 (high-priority cells).

Examples

The following example sets the maximum number of high-priority cells coming from the destination switch at the burst level to 800 cells.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm backward-max-burst-size-clp0 800

atm backward-max-burst-size-clp1

To change the maximum number of the aggregate of low- and high-priority cells coming from the destination to the source at the burst level on the SVC, use the atm backward-max-burst-size-clp1 map-class configuration command. To restore the default value, use the no form of this command.

atm backward-max-burst-size-clp1 cell-count
no atm backward-max-burst-size-clp1

Syntax Description

cell-count

Maximum number of the aggregate of low- and high-priority cells coming from the destination at the burst level.

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command. Originally cellmax-burst.

11.2(8.0.1)

Modified: Command changed to atm backward-max-burst-size-clp1

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp1 applies to the cumulative flow of CLP 0 and CLP 1 cells (high-priority and low-priority cells).

Examples

The following example sets the maximum number of the aggregate of low- and high-priority cells coming from the destination switch at the burst level to 100000.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm backward-max-burst-size-clp1 100000

atm backward-peak-cell-rate-clp0

To change the peak rate of high-priority cells coming from the destination to the source on the SVC, use the atm backward-peak-cell-rate-clp0 map-class configuration command. To restore the default, use the no form of this command.

atm backward-peak-cell-rate-clp0 rate
no atm backward-peak-cell-rate-clp0

Syntax Description

rate

Maximum rate in kbps that this SVC can receive high-priority cells from the destination switch router. Maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp0 indicates this command affects only high-priority cells with a CLP of 0.

Examples

The following example sets the peak rate for high-priority cells from the destination switch router to 8000 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm backward-peak-cell-rate-clp0 8000

atm backward-peak-cell-rate-clp1

To change the peak rate of the aggregate of low- and high-priority cells coming from the destination to the source on the SVC, use the atm backward-peak-cell-rate-clp1 map-class configuration command. To restore the default value, use the no form of this command.

atm backward-peak-cell-rate-clp1 rate
no atm backward-peak-cell-rate-clp1

Syntax Description

rate

Maximum rate in kbps that this SVC can receive of the aggregate of low- and high-priority cells from the destination switch router. Maximum upper range is 7113539 (limited by 0xffffff cells-per-second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp1 applies to the cumulative flow of CLP 0 and CLP 1 cells (high-priority and low-priority cells).

Examples

The following example sets the peak rate of the aggregate of low- and high-priority cells from the destination switch router to 7000 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# 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 to the source on the SVC, use the atm backward-sustainable-cell-rate-clp0 map-class configuration command. To restore the default value, use the no form of this command.

atm backward-sustainable-cell-rate-clp0 rate
no atm backward-sustainable-cell-rate-clp0

Syntax Description

rate

Sustainable rate in kbps that this SVC can receive high-priority cells from the destination switch. Maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp0 indicates this command affects only high-priority cells with a CLP of 0.

Examples

The following example sets the sustainable rate for high-priority cells from the destination switch
to 800 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm backward-sustainable-cell-rate-clp0 800

atm backward-sustainable-cell-rate-clp1

To change the sustainable rate of the aggregate of low- and high-priority cells coming from the destination to the source on the SVC, use the atm backward-sustainable-cell-rate-clp1 map-class configuration command. To restore the default value, use the no form of this command.

atm backward-sustainable-cell-rate-clp1 rate
no atm backward-sustainable-cell-rate-clp1

Syntax Description

rate

Sustainable rate in kbps that this SVC can receive of the aggregate of low- and high-priority cells from the destination. Maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp1 applies to the cumulative flow of CLP 0 and CLP 1 cells (high-priority and low-priority cells).

Examples

The following example sets the sustainable rate of the aggregate of low- and high-priority cells
from the destination switch to 700 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm backward-sustainable-cell-rate-clp1 700

atm cac best-effort-limit

To change or set the interface limit on the number of best-effort connections, use the
atm cac best-effort-limit interface configuration command. To restore the default, use the
no form of this command.

atm cac best-effort-limit conn-value
no atm cac best-effort-limit

Syntax Description

conn-value

The number of best-effort connections allowed on the interface, in the range of 0 to 327680.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command places a limit on the total number of ABR and UBR connections on the interface.

This command also supports subinterface configuration.

Examples

In the following example, the number of best effort connections allowed on the interface is limited
to 200.

Switch(config-if)# atm cac best-effort-limit 200

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac framing overhead

To instruct CAC to consider framing overhead, use the atm cac framing overhead interface configuration command. To restore the default (disabled), use the no form of this command.

atm cac framing overhead [force]
no atm cac framing overhead

Syntax Description

force

Including framing overhead while calculating the maximum cell rate of an interface can reduce the maximum equivalent bandwidth that can actually be allocated for guaranteed services on this interface to a value below the currently allocated bandwidth guarantees. If this occurs, this keyword must be used for the change to take effect. This option forces the CAC to account for framing overhead on this interface.

Defaults

Framing overhead is not considered in calculating the MaxCR of an ATM interface.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command directs CAC to consider framing overhead in calculating the MaxCR of an ATM interface. For example, without this configuration, an OC-3 interface has a cell rate of 155,519 kbps. With the atm cac framing overhead command in effect, the actual cell rate (subtracting SONET framing overhead) is 149,759 kbps.


Note   Once this configuration command is in effect, subsequent SVC establishment and PVC creation can be altered as compared to the default state (less bandwidth is available, and lower traffic parameter values are allowed).


Note   Commands that change the framing in effect on an interface (such as those available on a DS-3 interface) can cause corresponding changes in the maximum cell rate of the interface.

Examples

The following example forces CAC to account for framing overhead on this interface.

Switch(config-if)# atm cac framing overhead force

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac link-sharing

To change the resource management interface controlled link-sharing parameters, use the
atm cac link-sharing interface configuration command. To reset the parameter values to the default, use the no form of this command.

atm cac link-sharing max-bandwidth {abr | cbr | ubr | vbr} {receive | transmit} percent
atm cac link-sharing max-guaranteed-service-bandwidth {receive | transmit} percent
atm cac link-sharing min-bandwidth {abr | cbr | ubr | vbr} {receive | transmit} percent
no atm cac link-sharing max-bandwidth {abr | cbr | ubr | vbr} {receive | transmit}
no atm cac link-sharing max-guaranteed-service-bandwidth {receive | transmit}
no atm cac link-sharing min-bandwidth {abr | cbr |ubr | vbr} {receive | transmit}

Syntax Description

abr

The available bit rate connection.

cbr

The constant bit rate connection.

ubr

The unspecified bit rate connection.

vbr

The variable bit rate connection.

receive

The configured parameter applies to the flow of traffic into the switch on the interface (or from the route processor 0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch on the interface (or to the route processor 0 interface).

percent

The percent of interface bandwidth, from 0 to 95 percent.

Defaults

No limits configured. All minimums are defined as 0 percent, maximums as 95 percent.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

On a 25-Mbps port adapter you can configure the atm cac link-sharing parameter only on
physical ports 0 or 6. The following rules apply:

  • The parameter configured on port 0 applies to ports 0 through 5.
  • The parameter configured on port 6 applies to ports 6 through 11.

This command does not support subinterface configuration.

The atm cac link sharing command specifies the minimum and maximum bandwidth that can be allocated to guaranteed service (CBR, VBR, ABR, or UBR+) connections. (UBR+ is UBR with MCR specified.)

Maximums can be individually specified for CBR, VBR, ABR, or UBR+, and also the AGG of this bandwidth. Minimums can be individually specified for CBR, VBR, ABR, and UBR+. These parameters, for a direction, are interrelated as follows (assuming these parameters are defined):

  • min(CBR) + min(VBR) + min(ABR) + min(UBR) <= 95 percent
  • min(CBR) <= max(CBR) <= 95 percent
  • min(VBR) <= max(VBR) <= 95 percent
  • min(CBR) <= max(AGG) <= 95 percent
  • min(VBR) <= max(AGG) <= 95 percent
  • max(CBR) <= max(AGG) <= 95 percent
  • max(VBR) <= max(AGG) <= 95 percent
  • min(ABR) <= max(ABR) <= 95 percent
  • min(UBR) <= max(UBR) <= 95 percent
  • min(ABR) <= max(AGG) <= 95 percent
  • min(UBR) <= max(AGG) <= 95 percent
  • max(ABR) <= max(AGG) <= 95 percent
  • max(UBR) <= max(AGG) <= 95 percent

Examples

In the following example, the maximum bandwidth that can be allocated to VBR connections in the transmit direction on the interface is limited to 61 percent of the total bandwidth.

Switch(config-if)# atm cac link-sharing max-bandwidth vbr transmit 61

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac max-cdvt

To configure the maximum CDVT (per service category and direction) allowed for a connection
on an interface by CAC, use the atm cac max-cdvt interface configuration command. To remove the configuration setting for atm cac max-cdvt, use the no form of this command.

atm cac max-cdvt {abr | cbr | ubr | vbr} {receive | transmit} cdvtval
no atm cac max-cdvt {abr | cbr | ubr | vbr} {receive | transmit}

Syntax Description

abr

The available bit rate connection.

cbr

The constant bit rate connection.

ubr

The unspecified bit rate connection.

vbr

The variable bit rate connection.

receive

The configured parameter applies to the flow of traffic into the switch router on the interface (or from the route processor 0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch router on the interface (or to the route processor 0 interface).

cdvtval

The CDVT value, in the range of 0 to 2147483647, expressed in cell times
(2.72 microseconds at 155.2 Mbps).

Defaults

None

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command configures a maximum for the CDVT that is allowed at connection setup. These can be specified independently by service category and traffic direction.

This command also supports subinterface configuration.

Examples

The following example configures the maximum CDVT allowed by CAC in traffic parameters for the incoming direction of an ABR connection on the interface to 21354.

Switch(config-if)# atm cac max-cdvt abr receive 21354

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac max-mbs

To change the interface maximum for incoming and outgoing MBS at connection startup, use the
atm cac max-mbs interface configuration command. To reset the maximum value to the default, use the no form of this command.

atm cac max-mbs {receive | transmit} mbsval
no atm cac max-mbs {receive | transmit}

Syntax Description

receive

The configured parameter applies to the flow of traffic into the switch on the interface (or from the route processor 0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch on the interface (or to the route processor 0 interface).

mbsval

The MBS value, in the range of 0 to 2147483647, expressed as the number of cells.

Defaults

None

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command configures a maximum for the MBS that is allowed at connection setup. These can be specified independently by traffic direction.

This command also supports subinterface configuration.

Examples

The following example configures the MBS allowed by CAC in traffic parameters for the outgoing direction of an VBR connection on the interface to 2345 cells.

Switch(config-if)# atm cac max-mbs transmit 2345

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac max-min-cell-rate

To configure the maximum MCR for ABR and UBR service category traffic flowing into and out of the switch router, use the atm cac max-min-cell-rate interface configuration command. To remove these values, use the no form of this command.

atm cac max-min-cell-rate {abr | ubr} {receive | transmit} rate
no atm cac max-min-cell-rate {abr | ubr} {receive | transmit}

Syntax Description

abr

The available bit rate connection.

ubr

The unspecified bit rate connection.

receive

The configured parameter applies to the flow of traffic into the switch router on the interface (or from the route processor 0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch router on the interface (or to the route processor 0 interface).

rate

A positive integer, measured in kbps, in the range of 0 to 910533065.

Defaults

None

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command configures a maximum for the MCR that is allowed at connection setup. These can be specified independently by service category and traffic direction.

This command also supports subinterface configuration.

Examples

The following example configures the maximum MCR allowed by CAC in traffic parameters for the outgoing direction of an ABR connection on the interface to 1340 kbps.

Switch(config-if)# atm cac max-min-cell-rate ubr transmit 1340 

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac max-peak-cell-rate

To configure the maximum PCR for specific service categories and traffic directions, use the
atm cac max-peak-cell-rate interface configuration command. To restore the default value, use
the no form of this command.

atm cac max-peak-cell-rate {abr | cbr | ubr | vbr} {receive | transmit} rate
no atm cac max-peak-cell-rate {abr | cbr | ubr | vbr} {receive | transmit}

Syntax Description

abr

The available bit rate connection.

cbr

The constant bit rate connection.

ubr

The unspecified bit rate connection.

vbr

The variable bit rate connection.

receive

The configured parameter applies to the flow of traffic into the switch router on the interface (or from the route processor 0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch router on the interface (or to the route processor 0 interface).

rate

A positive integer, measured in kbps, in the range of 0 to 910533065.

Defaults

None

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command configures the maximum PCR that is allowed at connection setup. These can be specified independently by service category and traffic direction.

For UBR connections, cell rate is not checked in CAC. By specifying a peak-cell-rate limit, CAC rejects connections that exceed the limit.

This command also supports subinterface configuration.

Examples

The following example configures the maximum PCR allowed by CAC in traffic parameters for the incoming direction of an ABR connection on the interface to 3001 kbps.

Switch(config-if)# atm cac max-peak-cell-rate abr receive 3001

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac max-sustained-cell-rate

To configure the maximum SCR for traffic flow in either direction, use the
atm cac max-sustained-cell-rate interface configuration command. To restore the default value, use the no form of this command.

atm cac max-sustained-cell-rate {receive | transmit} rate
no atm cac max-sustained-cell-rate {receive | transmit}

Syntax Description

receive

The configured parameter applies to the flow of traffic into the switch router on the interface (or from the route processor 0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch router on the interface (or to the route processor 0 interface).

rate

A positive integer, measured in kbps, in the range of 0 to 910533065.

Defaults

None

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command specifies a maximum for the SCR that is allowed at connection setup. These can be specified independently by traffic direction.

This command also supports subinterface configuration.

Examples

The following example configures the maximum SCR allowed by CAC in traffic parameters for the outgoing direction of a VBR connection on the interface to 2201 kbps.

Switch(config-if)# atm cac max-sustained-cell-rate transmit 2201

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac overbooking

To configure overbooking on an ATM or IMA interface, use the atm cac overbooking interface configuration command. To restore the default, use the no form of this command.

atm cac overbooking percent
no atm cac overbooking

Syntax Description

percent

The overbooking percentage of the MaxCR of the interface being configured, from 100 to 10000. 100 percent = disabled.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command determines whether overbooking is enabled on an ATM or IMA interface, and specifies the extent of overbooking if enabled. Overbooking causes CAC to expand its concept of the amount of bandwidth available on an interface (receive and transmit) by the percentage specified. This applies to the aggregate bandwidth available on the interface; individual traffic parameters are still limited by the maximum cell rate of the interface in a given direction. Also, the normal limit of 95 percent of MaxCR for guaranteed cell rates (or the appropriate controlled link sharing percentages) applies to the overbooked MaxCR of the interface. The overbooking is expressed as a percentage of the MaxCR of the interface being configured.

An interface must be shut down before any change in the overbooking configuration can be made. (See "Example.") If the overbooking change results in a maximum guaranteed services bandwidth that is below the currently allocated bandwidth guarantees on this interface, then the configuration will be rejected.

Overbooking cannot be configured on regular VP tunnel interfaces and is configurable only on shaped and hierarchical VP tunnel interfaces.

Enabling overbooking is recommended only for advanced users. Enabling overbooking forfeits the protection for guaranteed cell rates provided by the CAC algorithm and hardware.

Examples

In the following example, ATM overbooking is configured for 159 percent of the MaxCR of the interface.

Switch(config-if)# shutdown
Switch(config-if)# atm cac overbooking 159
Switch(config-if)# no shutdown

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cac service-category

To permit or deny a service category on an ATM physical interface, shaped VP tunnel subinterface, or hierarchical VP tunnel subinterface, use the atm cac service-category command. To restore the default configuration of the interface with respect to the service category, use the no form of this command.

atm cac service-category {abr | cbr | ubr | vbr-nrt | vbr-rt} {deny | permit}
no atm cac service-category {abr | cbr | ubr | vbr-nrt | vbr-rt}

Syntax Description

abr

The available bit rate connection.

cbr

The constant bit rate connection.

ubr

The unspecified bit rate connection.

vbr-nrt

The variable bit rate in non-real time.

vbr-rt

The variable bit rate in real time.

deny

The specified service category on the interface is denied.

permit

The specified service category on the interface is permitted.

Defaults

For physical interfaces and hierarchical VP tunnel subinterfaces, all service categories are enabled by default. For shaped VP tunnel subinterfaces, only CBR service category is enabled by default.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command. Originally part of atm cac.

12.0(4a)W5(11a)

Modified: Broken out into separate command.

Usage Guidelines

This command specifies which service categories to permit or deny on the interface. Changes from the defaults must be done on a separate line for each service category. On a shaped VP tunnel interface, only one service category is permitted at one time.

To deny a service category in a shaped VP tunnel subinterface, you must delete all user VCs of the service category on the interface.

VBR-RT is used for connections where there is a fixed timing relationship between samples. VBR-NRT is used for connections where there is no fixed timing relationship between samples, but where there is still a need for guaranteed QoS.

This command also supports subinterface configuration.

Examples

In the following example, the CBR service category is prohibited on ATM subinterface 0/0/1.51 before service category UBR is allowed.

Switch(config)# interface atm 0/0/1.51
Switch(config-subif)# atm cac service-category cbr deny
Switch(config-subif)# atm cac service-category ubr permit

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

show running-config

Displays the configuration information currently running on the terminal.

atm cdvt-default

To change the default CDVT to request for UPC of cells received on the interface for connections that do not individually request a CDVT value, use the atm cdvt-default interface configuration command. To reset the default CDVT for a particular service category to the default value, use the no form of this command.

atm cdvt-default {cbr | vbr-rt | vbr-nrt | abr | ubr} number
no atm cdvt-default {cbr | vbr-rt | vbr-nrt | abr | ubr}

Syntax Description

cbr

The constant bit rate connection.

vbr-rt

The variable bit rate in real time.

vbr-nrt

The variable bit rate in non-real time.

abr

The available bit rate connection.

ubr

The unspecified bit rate connection.

number

A positive integer, in the range 0 to 2147483647. The CDVT is expressed in cell-times (2.72 microseconds at 155.2 Mbps).

Defaults

1024

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

CDVT is a limit parameter used in the GCRA policing algorithm to monitor PCR. CDVT can be specified for PVCs through a connection traffic table row. If no CDVT is specified in the row, then a per-interface, per-service category default CDVT is applied for purposes of UPC on the connection.

For signalled connections, CDVT cannot be signalled. Use defaults specified on the interface.

Examples

The following example shows changing the default CDVT for received cells on VBR-RT connections.

Switch(config-if)# atm cdvt-default vbr-rt 4000

Related Commands

Command  Description 

atm connection-traffic-table-row

Used to create a table entry.

show atm vc

Displays the ATM layer connection information about the virtual connection.

show atm vp

Displays the ATM layer connection information about the virtual path.

atm connection-traffic-table-row

To create a table entry, use the atm connection-traffic-table-row global configuration command.
To delete an entry, use the no form of this command.

atm connection-traffic-table-row [index row-index] cbr pcr rate [cdvt cdvt]
atm connection-traffic-table-row [index row-index] {vbr-rt | vbr-nrt} pcr rate {scr0 | scr10}scrval [mbs mbsval] [cdvt cdvtval]
atm connection-traffic-table-row [index row-index] abr pcr rate [cdvt cdvtval] [mcr mcrval]
atm connection-traffic-table-row [index row-index] ubr pcr rate [cdvt cdvtval] [mcr mcrval]
no atm connection-traffic-table-row index row-index abr pcr rate [cdvt cdvtval] [mcr mcrval]
atm connection-traffic-table-row [index row-index] ubr pcr rate [cdvt cdvtval] [mcr mcrval]

Syntax Description

cdvt cdvtval

The value of the cell delay variation tolerance, in the range of 0 to 2147483647, expressed in cell-times (2.72 microseconds at 155.2 Mbps).

mbs mbsval

The value of the maximum burst size, in the range of 0 to 2147483647, expressed in the number of cells.

mcr mcrval

The minimum cell rate is a positive integer, measured in kbps, in the range of
0 to 910533065.

pcr rate

The peak cell rate is a positive integer, measured in kbps, in the range of
0 to 910533065.

row-index

An integer in the range of 1 to 1073741823.

scr0

Sustained cell rate for the CLP 0 flow.

scr10

Sustained cell rate for the CLP 0+1 flow.

scrval

The sustained cell rate is a positive integer, measured in kbps per second, in the range of 0 to 910533065.

Defaults

Rows 1 through 6 in the table are predefined.

Command Modes

Global configuration

Command History

Release  Modifications 

11.1(4)

New command

Usage Guidelines

This command sets up the traffic characteristics used in PVC definition. The characteristics are stored as rows of a table. The row index is referenced when a PVC is created using the atm pvc interface command.

When the atm connection-traffic-table-row command is issued without the index clause, the software uses a free row-index, which is displayed to the user if the command is successful.

When the CDVT or MBS parameter is not specified in the creation of a row, a configurable interface default value is chosen to use in UPC. For systems that are capable of dual leaky bucket UPC (Catalyst 8540 MSR with feature card, and Catalyst 8510 MSR and LightStream 1010 with FC-PFQ), PCR/CDVT is monitored for service categories other than VBR, and for VBR PCR/CDVT and SCR/MBS. For LightStream 1010 with FC-PCQ, a single leaky bucket provides monitoring for PCR/CDVT for service categories other than VBR, and for VBR SCR/MBS.

Six connection traffic table rows are defined by default and are numbered 1 through 6. Row 1 is the default row used by the atm pvc command if no rows are explicitly specified. Rows 2 through 6 might be used for well-known vcs on a vp tunnel subinterface, depending on the service category of the underlying vp. Default rows cannot be deleted.

Row 1 PCR represents the maximum cell-rate (the maximum cell-rate that fits in 24 bits) that you can signal.

When an ABR row is configured, if MCR is not specified, MCR is configured as 0 in the CTT row.

When a VBR CTT row is configured using the scr0 keyword, the switch processor feature card equipped with a dual leaky bucket polices only the CLP-0 flow of cells to the scrval. When the scr10 keyword is used, the CLP-0+1 flow is policed.

Examples

In the following example, a CBR CTT row is defined with an index of 200 and a peak cell rate of 7743 kbps.

Switch(config)# atm connection-traffic-table-row index 200 cbr pcr 7743

Related Commands

Command  Description 

atm pvc

Used to create a PVC.

atm pvp

Used to create a PVP.

show atm connection-traffic-table

Displays a table of connection traffic parameters used by network and connection management.

atm e164 address

To configure the native E.164 address of an ATM interface, use the atm e164 address interface configuration command. To disable the ATM E.164 address, use the no form of this command.

atm e164 address e164-address
no atm e164 address

Syntax Description

e164-address

Specifies a native E.164 address, consisting of 7 to 15 decimal digits. Refer to the ITU-T Recommendation E.164 for more information on the syntax and semantics of native E.164 addresses.

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

Use this command to configure a native E.164 address that is used to connect to public networks.

When outgoing calls are configured to use forwarding E.164 addresses as the called party address
(see the atm route command), this E.164 address is used as the forwarding calling party address.

When incoming calls are received on the interface that specifies the E.164 address as the called party address, the received called and calling party addresses are removed from the signalling message and replaced by the new received called and calling party subaddresses.

This new address is not registered with routing since it is only used as this switch's address for this interface. It is not used as the address of destinations from this interface.

Note that this address is not used in conjunction with the E.164 translation table feature. The E.164 translation table should only be used when you want a one-to-one correspondence between the NSAP-format ATM end-system address and the native E.164 address, for example, when the public network does not support transport of subaddresses. The combination of the atm e164 address command and the e164 address option of the atm route command provides a general mechanism for interconnection of private networks across a public network. This combination allows one native
E.164 address for the interface to the public network, with many NSAP-format ATM end-system addresses present in the private network behind the interface.

Examples

The following example shows setting the native E.164 address of ATM 0/0/1 to 1341457.

Switch(config)# interface atm 0/0/1
Switch(config-if)# atm e164 address 1341457

Related Commands

Command  Description 

atm e164 address

Configure the native E.164 address of an ATM interface.

atm route

Specifies a static route to a reachable address prefix.

show atm addresses

Displays the active ATM addresses on a switchn router.

show atm interface

Displays ATM-specific information about an ATM interface.

show atm vc

Displays the ATM layer connection information about the virtual connection.

atm e164 auto-conversion

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

atm e164 auto-conversion
no atm e164 auto-conversion

Syntax Description

This command has no keywords or arguments.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

When an interface is configured for E.164 autoconversion, ATM E.164-format addresses are converted to the corresponding native E.164 address for outgoing calls. For incoming calls, native E.164 addresses are converted to the corresponding ATM E.164 format.

Examples

The following example shows how to enable E.164 autoconversion on ATM interface 0/0/1.

Switch(config)# interface atm 0/0/1
Switch(config-if)# atm e164 auto-conversion

Related Commands

Command  Description 

show atm vc

Displays the ATM layer connection information about the virtual connection.

atm e164 translation

To configure an interface to use the ATM E.164 translation table, use the atm e164 translation interface configuration command. To disable the ATM E.164 translation, use the no form of this command.

atm e164 translation
no atm e164 translation

Syntax Description

This command has no keywords or arguments.

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

The ATM E.164 translation table is used when a one-to-one translation between NSAP-format ATM end-system addresses and native E.164 addresses is desired. This method for support of native E.164 addresses might be useful when the ATM interface connects to a public network that does not support transport of subaddresses.

Note that the more general mechanism for interconnection to E.164 public networks involves use of the atm e164 address command and the e164-address option of the atm route command. This other mechanism allows one native E.164 address for the interface to the public network, with many NSAP-format ATM end-system addresses present in the private network behind the interface.

When a signalling message attempts to establish a call from an interface configured for ATM E.164 translation, the called and calling party addresses are initially in NSAP format. Using the ATM E.164 translation table, an attempt is made to find the E.164 addresses corresponding to the NSAP addresses. These E.164 addresses are placed into the called and calling party addresses, and the original NSAP addresses are placed into the called and calling party subaddresses.

When a signalling message is received on an interface configured for ATM E.164 translation, the called and calling party addresses are in E.164 format. If the original NSAP-formatted called and calling addresses have been carried in subaddresses, then those addresses are used to forward the call. If subaddresses are not present, due to the network blocking the subaddresses, or the switch at the entry to the E.164 network does not provide subaddresses, an attempt is made to find a match for the E.164 addresses in the ATM E.164 translation table. If there is a match, the NSAP addresses corresponding to the E.164 addresses are placed into the called and calling party addresses. The call is then forwarded using the NSAP addresses.

Examples

The following example shows setting interface ATM 0/0/1 to use the E.164 translation table.

Switch(config)# interface atm0/0/1
Switch(config-if)# atm e164 translation

Related Commands

Command  Description 

atm e164 auto-conversion

Enables autoconversion of E.164 addresses.

atm e164 translation-table

Enables ATM E.164 translation configuration mode.

atm route

Specifies a static route to a reachable address prefix.

e164 address

Configures an entry in the ATM E.164 translation table.

show atm interface

Displays ATM-specific information about an ATM interface.

atm e164 translation-table

To start ATM E.164 translation configuration mode, use the atm e164 translation-table global configuration command. To disable the ATM E.164 translation table, use the no form of this command.

atm e164 translation-table
no atm e164 translation-table

Note   The atm e164 translation-table global configuration command changes the configuration mode to ATM E.164 translation table configuration, and the following new prompt appears: Switch(config-atm-e164)#

Syntax Description

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

Use this command to start ATM E.164 translation configuration mode.

The ATM E.164 translation table is used by all interfaces configured with the ATM E.164 translation functionality. Each entry in the table specifies a one-to-one correspondence between a native E.164 address and an NSAP-format ATM end-system address.

Refer to the atm e164 translation command for more information and usage guidelines about the ATM E.164 translation feature.

Examples

The following example shows how to start the ATM E.164 translation configuration mode.

Switch(config)# atm e164 translation-table
Switch(config-atm-e164)# e164 address 1112222 nsap-address 11.111122223333444455556666.112233445566.11

Related Commands

Command  Description 

atm e164 translation

Configures an interface to use the ATM E.164 translation table.

e164 address

Configures an entry in the ATM E.164 translation table.

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 by way of
the ILMI address registration from the ATM switch router. To remove 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 end station ID is defined for this interface.

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

This command only applies to the route processor interface and subinterfaces.

The NSAP-format ATM end-system address of an interface is used by static maps (refer to the section "Configuring an SVC-Based Map List" in the ATM Switch Router Software Configuration Guide) and by Classical IP over ATM, as defined in RFC 1577 (refer to the section "Configure Classical IP over ATM in an SVC Environment" in the ATM Switch Router Software Configuration Guide).

The NSAP-format ATM end-system address of an interface can be configured using either the
atm esi-address or the atm nsap-address command. Configuring a new address on the interface overwrites the previous address. The atm esi-address and atm nsap-address commands are mutually exclusive. Configuring the switch with the atm esi-address command negates the atm nsap-address setting, and vice versa.

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 address prefix (26 hexadecimal characters) is provided by the ATM switch router (refer to the atm address and
atm prefix commands for more information). The resulting ATM address is registered on the ATM switch router using ILMI address registration.

Examples

The following example sets the ESI to 303132333435 and the selector byte to 36 on ATM subinterface 0.1.

Switch(config)# interface atm 0.1
Switch(config-subif)# atm esi-address 303132333435.36

Related Commands

Command  Description 

atm address

Assigns a 20-byte ATM address to the switch router.

atm nsap-address

Configures the NSAP-format ATM end-system address of an ATM interface.

atm prefix

Configures an ILMI address prefix for an ATM interface.

atm filter-expr

To configure an ATM address filter that matches patterns, use one of the forms of the atm filter-expr global configuration command. To delete the specified filter, use the no form of this command.

atm filter-expr name term
atm filter-expr name not term
atm filter-expr name term and term
atm filter-expr name term or term
atm filter-expr name term xor term
no atm filter-expr name

Syntax Description

name

The name of the pattern-matching filter expression.

term

Can be any of the following:

  • A previously defined address pattern-matching expression
  • A filter set applied to a calling-party address—source filter-set name
  • A filter set applied to a called-party address—destination filter-set name

Defaults

Permit

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

The first form (atm filter-expr name term) defines a simple filter expression that is pattern-matched only if the pattern given by term is matched.

The second form (atm filter-expr name not term) defines a filter expression that is pattern-matched only if the pattern given by term is not matched.

The third form (atm filter-expr name term and term) defines a filter expression that is pattern-matched if either of the patterns given by the two terms are matched.

The fourth form (atm filter-expr name term or term) defines a filter expression that is pattern-matched only if both of the patterns given by the two terms are matched.

The fifth form (atm filter-expr name term xor term) defines a filter expression that is pattern-matched only if one of the patterns, but not both, given by the two terms is matched.

For commands with two terms—that is, commands using logical operators or, and, and xor—the evaluation sequence is from left to right of the expression. Further, for commands using logical operators or and and, the evaluation for the second term is conducted only when necessary, that is, the evaluation for the second term is omitted if the truth or falsehood can already be concluded from the evaluation for the first term.

Examples

The following is sample output from the atm filter-expr command.

Switch(config)# atm filter-expr atm_filter_expr1 not source atm_filter_set1
Switch(config)# atm filter-expr atm_filter_expr2 source atm_filter_set1 and destination atm_filter_set2

Related Commands

Command  Description 

atm filter-set

Creates an ATM address filter set.

atm filter-set

To create an ATM address filter set, use the atm filter-set global configuration command. To delete the specified filter, use the no form of this command.

atm filter-set name [index [number]] [permit | deny] [template |time-of-day {anytime |
start-time {end-time}}]
no atm filter-set name [index number]

Syntax Description

name

The name of the filter set.

index

Set order in which filters are set. The range is from 1 through 65535.
The default is 1.

permit

Permission to accept an incoming call or forward an outgoing call on an interface/subinterface if the address pattern-matching succeeds.

deny

Denial to accept an incoming call or forward an outgoing call on an interface or subinterface if the address pattern-matching succeeds.

template

An ATM address, address template, or ATM address template alias.

time-of-day

Specify the time range in which the filter set takes place. This parameter can be specified as anytime or as a specific time. The default is anytime.

start-time

Specify the time the filter set starts, in 24-hour format, hh:mm:ss.

end-time

Specify the time the filter set ends, in 24-hour format, hh:mm:ss.

Defaults

Permit

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

If neither permit nor deny is specified, permit is assumed. If an address does not match any
of the filter set entries, an implicit "deny" is returned as the permit/deny action of the filter set.

Filters are set in the same order they were configured. You can change the order (except in a complete NSAP address that has no wildcards) by specifying the optional parameter index.

After you create a filter for a specific interface, associate the filter to that interface by using the
atm access-group command.

Examples

The following is an example of the atm filter-set command.

Switch(config)# atm filter-set filter_set1 permit 47.0091.8100.0000.0003.bbe4.aa01.4000.0c80.0000.64
Switch(config)# atm filter-set filter_set3 deny 47.840F... 
Switch(config)# no atm filter-set filter_set3

Related Commands

Command  Description 

atm access-group

Used to subscribe an interface or subinterface to an existing ATM address pattern-matching filter expression.

atm forward-max-burst-size-clp0

To change the maximum number of high-priority cells going from the source to the destination
at the burst level on the SVC, use the atm forward-max-burst-size-clp0 map-class configuration command. To restore the default value, use the no form of this command.

atm forward-max-burst-size-clp0 cell-count
no atm forward-max-burst-size-clp0

Syntax Description

cell-count

The burst size in cells, from 1 to 16777215. This is the maximum number of high-priority cells going from the source switch at the burst level.

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp0 indicates this command affects only high-priority cells with a CLP of 0.

Examples

The following example sets the maximum number of high-priority cells going from the source switch at the burst level to 100000.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm forward-max-burst-size-clp0 100000

atm forward-max-burst-size-clp1

To change the maximum number of the aggregate of low- and high-priority cells going from the source to the destination at the burst level on the SVC, use the atm forward-max-burst-size-clp1 map-class configuration command. To restore the default value, use the no form of this command.

atm forward-max-burst-size-clp1 cell-count
no atm forward-max-burst-size-clp1

Syntax Description

cell-count

The burst size in cells, from 1 to 16777215. This is the maximum number of the aggregate of low- and high-priority cells going from the source switch at the burst level.

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp1 applies to the cumulative flow of CLP 0 and CLP 1 cells (high-priority and low-priority cells).

Examples

The following example sets the maximum number of the aggregate of low- and high-priority cells
going from the source switch at the burst level to 100000.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# 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 to the destination on the SVC,
use the atm forward-peak-cell-rate-clp0 map-class configuration command. To restore the default value, use the no form of this command.

atm forward-peak-cell-rate-clp0 rate
no atm forward-peak-cell-rate-clp0

Syntax Description

rate

Maximum rate in kbps that this SVC can send high-priority cells from the source switch router. The maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp0 indicates this command affects only high-priority cells with a CLP of 0.

Examples

The following example sets the peak of the high-priority cell rate from the source switch to
1000 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm forward-peak-cell-rate-clp0 1000

atm forward-peak-cell-rate-clp1

To change the peak rate of the aggregate of low- and high-priority cells coming from the source
to the destination on the SVC, use the atm forward-peak-cell-rate-clp1 map-class configuration command. To restore the default value, use the no form of this command.

atm forward-peak-cell-rate-clp1 rate
no atm forward-peak-cell-rate-clp1

Syntax Description

rate

Maximum rate in kbps that this SVC can send the aggregate of low- and high-priority cells from the source. The maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp1 applies to the cumulative flow of CLP 0 and CLP 1 cells (high-priority and low-priority cells).

Examples

The following example sets the peak of the aggregate of low- and high-priority cell rate from the source switch to 100000 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# 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 to the destination on the SVC, use the atm forward-sustainable-cell-rate-clp0 map-class configuration command. To restore the default value, use the no form of this command.

atm forward-sustainable-cell-rate-clp0 rate
no atm forward-sustainable-cell-rate-clp0

Syntax Description

rate

Sustainable rate in kbps that this SVC can send high-priority cells from the source. The maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp0 indicates this command affects only high-priority cells with a CLP of 0.

Examples

The following example sets the sustainable rate of high-priority cells from the source switch to
100000 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm forward-sustainable-cell-rate-clp0 100000

atm forward-sustainable-cell-rate-clp1

To change the sustainable rate of the aggregate of low- and high-priority cells coming from the
source to the destination on the SVC, use the atm forward-sustainable-cell-rate-clp1 map-class configuration command. To restore the default value, use the no form of this command.

atm forward-sustainable-cell-rate-clp1 rate
no atm forward-sustainable-cell-rate-clp1

Syntax Description

rate

Sustainable rate in kbps that this SVC can send of the aggregate low- and high-priority cells from the source.
The maximum upper range is 7113539 (limited by 0xffffff cells per second).

Defaults

The parameter is not specified in the SVC setup request.

Command Modes

Map-class configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

The keyword clp1 applies to the cumulative flow of CLP 0 and CLP 1 cells (high-priority and low-priority cells).

Examples

The following example sets the sustainable rate of high-priority cells from the source switch to
100000 kbps.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm forward-sustainable-cell-rate-clp1 100000

atm hierarchical-tunnel

To enable hierarchical scheduling, use the atm hierarchical-tunnel global configuration command. To disable hierarchical scheduling, use the no form of this command.

atm hierarchical-tunnel
no atm hierarchical-tunnel

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release  Modification 

12.0(4a)W5(11a)

New command

Usage Guidelines

Hierarchical VP tunnels have dedicated schedulers, which make possible the simultaneous support of all service category circuits inside the tunnel. The overall output of the tunnel rate is limited to the total output of the dedicated scheduler.

Hierarchical VP tunnels are supported only if FC-PFQ is installed. (Catalyst 8510 MSR and LightStream 1010)


Note   To define hierarchical tunnels, enable this feature using the atm idle-timeout command, reload the switch, and then define the hierarchical tunnels.

When you enable hierarchical scheduling, it impacts the behavior of the CAC software on the switch. For example, enabling hierarchical scheduling can cause CAC software to refuse admission to some connections, even though those same connections were admitted before hierarchical scheduling was enabled.

If hierarchical scheduling is enabled, and if there are any guaranteed service VCs defined (or signalled) with a guarantee less than 76.114 kbps, those guaranteed service VCs are allocated a full rate of 76.114 kbps. Guaranteed service connections include:

  • CBR
  • VBR
  • ABR/UBR with non-zero MCR.

If hierarchical scheduling is disabled, the guaranteed service VC rate is 38.057 kbps.


Note   The guaranteed service VC rate is 38.057 kbps with prerelease 12.0 Cisco IOS software.

Guaranteed service VCs are allocated more bandwidth after hierarchical scheduling is enabled, which affects the CAC of those VCs. You can compute the extra bandwidth that is being allocated and evaluate the effect this has on the interface CAC before enabling hierarchical scheduling.


Note   If hierarchical scheduling is enabled, increased resource consumption occurs across the
entire switch.


Note   Best-effort VCs, or VCs with guarantees larger than 76.114 kbps, do not affect the behavior of the switch

Examples

The following example shows how to enable hierarchical scheduling on an ATM switch router.

Switch# configure terminal
Switch# configure terminal
Switch(config)# atm hierarchical-tunnel
Switch(config)# end
Switch# reload

Related Commands

Command  Description 

atm pvp

Used to create a PVP.

show running-config

Displays the configuration information currently running on the switch.

atm idle-timeout

To change the idle timer for SVCs on an interface that causes the SVCs to disconnect when inactive for a specified interval, use the atm idle-timeout interface configuration command. To restore 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.

Defaults

300 seconds

Command Modes

Interface configuration.


Note   This command applies only to the route processor interface (ATM 0).

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

To disable idle timeouts, set the value of seconds to 0.

Examples

The following example shows setting the timeout to 250.

switch(config)# atm idle-timeout 250

Related Commands

None

atm iisp

To configure ATM IISP on the specified physical or logical (VP tunnel) port, use the atm iisp interface configuration command.

atm iisp [side side [version ver]] | [version ver [side side]]

Syntax Description

side

Interface side, specified as user or network. The default is network.

version

IISP version, specified as 3.0, 3.1, or 4.0. The default is 3.0.

Defaults

See "Syntax Description."

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines


Note   Before using this command, ILMI autoconfiguration must be disabled. (Refer to the
atm auto-configuration command).

When this command is configured and it causes a change in the interface protocol, version, or side, ATM signalling and ILMI are restarted automatically on the interface. When ATM signalling is restarted, all switch virtual connections across the interface are cleared; permanent virtual connections are not affected. Refer to the ATM Switch Router Software Configuration Guide for more information about this command.

The atm auto-configuration, atm iisp, and atm nni commands are mutually exclusive. Configuring the atm iisp command overwrites any previous configuration of the atm nni or atm uni commands for this interface. Future configuration of the atm auto-configuration, atm nni, or atm uni command on this interface overwrites the atm iisp command.

For calls to be routed from this interface, one or more static routes must be configured. Refer to the
atm route command.

Examples

The following example configures ATM interface 3/1/2 as an IISP interface, running version 3.0 as the user side.

Switch(config)# interface atm 3/1/2
Switch(config-if)# no atm auto-configuration
Switch(config-if)#
%ATM-6-ILMINOAUTOCFG: ILMI(ATM3/1/2): Auto-configuration is disabled, current interface parameters will be used at next interface restart.
Switch(config-if)# atm iisp side user version 3.0
Switch(config-if)#
%ATM-5-ATMSOFTSTART: Restarting ATM signalling and ILMI on ATM3/1/2.
Switch(config-if)# atm maxvci-bits 12
Switch(config-if)#
%ATM-5-ATMSOFTSTART:# Restarting ATM signalling and ILMI on ATM3/1/2.
Switch(config-if)# end

The following example configures subinterface ATM 3/1/3.100 as an IISP interface, and uses the defaults for this command.

Switch(config)# interface atm 3/1/3.100
Switch(config-subif)# no atm auto-configuration
Switch(config-subif)#
%ATM-6-ILMINOAUTOCFG: ILMI(ATM3/1/3.100): Auto-configuration is disabled, current interface parameters will be used at next interface restart.
Switch(config-subif)# atm iisp
Switch(config-subif)#
%ATM-5-ATMSOFTSTART: Restarting ATM signalling and ILMI on ATM3/1/3.100.

Related Commands

Command  Description 

atm auto-configuration

Used to enable or disable ILMI autoconfiguration.

atm nni

Configures an ATM NNI on the specified physical or logical (VP tunnel) port.

atm route

Specifies a static route to a reachable address prefix.

show atm interface

Displays ATM-specific information about an ATM interface.

show atm route

Displays all local or network-wide reachable address prefixes in the switch router's ATM routing table.

atm ilmi default-access permit

To set the global default access filter for ILMI-registered addresses on all interfaces, use the
atm ilmi default-access permit global configuration command. To disable the global default access filter, use the no form of this command.

atm ilmi default-access permit {all | matching-prefix [wellknown-groups | all-groups]}
no atm ilmi default-access permit

Syntax Description

all

Permit all AESAs registered by attached end systems.

matching-prefix

Permit AESAs where the first 13 bytes of the address match an ILMI prefix used on the interface. These ILMI prefixes can be configured using the global atm address command or the per-interface atm prefix command. The ILMI prefixes used on the interfaces can be shown using the show atm ilmi-status command.

wellknown-groups

Permit well-known group addresses assigned by the ATM Forum and AESAs that match an ILMI prefix used on the interface.

The well-known group addresses include the old LECS address (47.0079.0000.0000.0000.0000.0000.00A0.3E00.0001.00) and any address matching the ATM Forum address prefix for well known addresses. (C5.0079.0000.0000.0000.0000.0000.00A0.3E)

all-groups

Permit all group addresses, including the well-known group addresses, and AESAs that match an ILMI prefix used on the interface.

Defaults

permit all

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

11.3(3a)

Added: permit

Usage Guidelines

This command allows specification of a global default access filter for ILMI address registration. The access filter feature allows you to permit or deny certain ILMI registered addresses. The global default access filter takes effect when address registration is enabled on an interface, but no per-interface access filter is specified. For additional information, refer to the atm address-registration command.


Note   If the Cisco SSRP for LAN Emulation is used in this network, ILMI registration of well-known group addresses should be permitted. This allows the active LECS to register the well-known LECS address with the switch. Either the permit all, permit matching-prefix wellknown groups, or permit matching-prefix all-groups option should be configured.

The global default-access filter for ILMI registration can be overridden by a per-interface access filter. (See the atm address-registration command.)

You should allow certain addresses to be registered through ILMI; however, to restrict them from being advertised through PNNI, the PNNI suppressed summary address feature should be used instead of the access filters for ILMI address registration. (See the summary-address command.)

Examples

The following example shows how to permit all ILMI-registered addresses.

Switch(config)# atm ilmi default-access permit all
Switch(config)#
%ATM-5-ILMIDEFACCFILTER: New global default access filter setting will be applied to registration of new addresses on interfaces using global default access filter.

Related Commands

Command  Description 

atm address

Assigns a 20-byte ATM address to the switch router.

atm address-registration

Enables the switch router to engage in address registration on an interface using the ILMI protocol.

atm prefix

Configures an ILMI address prefix for an ATM interface.

summary-address

Configures summary address prefixes on a PNNI node.

atm ilmi-enable

To enable the ILMI on a port, use the atm ilmi-enable interface configuration command.
To disable the ILMI on a port, use the no form of this command.

atm ilmi-enable
no atm ilmi-enable

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command does not apply to the ATM 0 interface or the ATM router module interfaces.

ILMI is enabled by default; however, if the peer does not support ILMI, you should turn off ILMI using this command.

Several components of ILMI can be disabled independently without completely disabling ILMI. Refer to the atm address-registration, atm auto-configuration, and atm ilmi-keepalive commands for more information.

Examples

The following example shows how to disable ILMI on interface ATM 1/0/0.

Switch(config)# interface atm 1/0/0
Switch(config-if)# no atm ilmi-enable

Related Commands

Command  Description 

atm address-registration

Enables the switch to engage in address registration on an interface using the ILMI protocol.

atm auto-configuration

Used to enable or disable ILMI autoconfiguration.

atm ilmi-keepalive

Used to enable or disable ILMI connectivity procedures and to change the ILMI keepalive poll interval.

show atm ilmi-status

Displays the ILMI-related status information.

atm ilmi-keepalive

To enable or disable ILMI connectivity procedures and to change the ILMI keepalive poll interval, use the atm ilmi-keepalive interface configuration command. To disable ILMI connectivity procedures, use the no form of this command.

atm ilmi-keepalive [seconds [retry number]]
no atm ilmi-keepalive

Syntax Description

seconds

Period in seconds, from 1 to 65,535, when the IME is polled.
The default is 5 seconds.

number

Number of retries from 2 to 5. The default is 5 retries.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command does not apply to the ATM 0 interface or the ATM router module interfaces.

This command enables ILMI connectivity procedures, as described in Section 8.3.1 of the ATM Forum ILMI 4.0 Specification.

Examples

The following example enables ILMI keepalives on ATM interface 1/0/0, with a poll interval set to 4 seconds and the number of retries to 3.

Switch(config)# interface atm 1/0/0
Switch(config-if)# atm ilmi-keepalive 4 retry 3

Related Commands

Command  Description 

atm ilmi-enable

Enables the ILMI on a port.

show atm ilmi-status

Displays the ILMI-related status information.

atm input-xlate-table minblock

To specify the minimum ITT-block size that the software attempts to use to allocate an ITT block, use the atm input-xlate-table minblock vpi interface configuration command. To disable the minblock function, use the no form of this command.

atm input-xlate-table minblock vpi vpi-value block-size [force]
no atm input-xlate-table minblock vpi vpi-value

Syntax Description

vpi-value

The VPI to which the command applies. The valid range is 0 to 255 for the LS1010 and the 6400 NSP. The valid range is 0 to 4095 for the Catalyst 8540 MSR.

block-size

The size of the ITT block in bytes is rounded to the smallest power of 2 greater than or equal to the entered value. The valid range is 32 to 16384. The minimum block size for the Catalyst 8540 MSR is 64 bytes.

force

Forces the user-entered value to be used in configuring ITT blocks. If the force keyword is not specified, the user-entered value will not be saved in the startup configuration file.

Defaults

Disabled.

Command Modes

Interface configuration

Command History

Release  Modification 

12.1(6)EY

New command

Usage Guidelines

The purpose of this command is to reduce ITT fragmentation in order to improve utilization of system resources. Make sure that the specified block size corresponds to the desired VC usage, so system resources are efficiently used. ITT resources are used only when a connection is installed (when both interfaces that the VC transits are up).

This command is particularly useful when the demand for SVCs transiting an interface/VPI can be anticipated. If the user-specified block is larger than what is needed for the VCI, and the requested block size is larger than what is available, a smaller-than-requested block size will be allocated for the VCI.

Table 1-1 illustrates the different usage scenarios of the autominblock and minblock commands.

Table 2-2   minblock command usage

autominblock mode enabled  force minblock command keyword used  Effect 

True

True

Command accepted; value rounded up and used as block-size hint, value not overridden by automatic analysis; value will be nvgened.

True

False

Command accepted; value rounded up used as a floor for block-size hint. value may be overridden by automatic analysis; value not neccesarily nvgened.

False

True

Command accepted; value rounded up and used as block-size hint; value will be nvgened.

False

False

Command not accepted.

The following example shows how to set the ITT minblock to 64 bytes. In this example, the force keyword is used to override any automatic block sizing.

Switch# configure terminal
Switch(config)# interface atm 0
Switch(config-if)# atm input-xlate-table minblock vpi 4095 64 force
Switch(config-if)# 

Related Commands

Command  Description 

atm input-xlate-table autominblock

Use to enable automatic determination of minimum ITT block sizes for all VPIs populated with PVCs/Soft PVC source legs.

atm input-xlate-table autoshrink

Use to free up ITT memory blocks after high-number VCIs are removed.

show atm input-xlate-table

Use to view ITT utilization, including blocks used and available, and ports to which blocks are allocated.

atm input-xlate-table autominblock

To enable automatic determination of minimum ITT block sizes for all VPIs populated with PVCs/Soft PVC source legs, use the atm input-xlate-table autominblock global configuration command. To this feature, use the no form of this command.

atm input-xlate-table autominblock
no atm input-xlate-table autominblock

Syntax Description

None

 

Defaults

Disabled.

Command Modes

Global configuration

Command History

Release  Modification 

12.1(6)EY

New command

Usage Guidelines

If autominblock is active, the system will look at all interfaces and determine the minimum ITT block sizes for all VPIs populated with PVCs and SoftPVC source legs that can use the ITT. When autominblock is active, the system adjusts the ITT block sizes as VCs are added or deleted. When generating a startup configuration file, atm input-xlate-table autominblock commands are inserted for each interface and VPI on which a user-defined PVC (that receives cells on the interface) or source leg of a Soft PVC is defined.

On initial configuration of the atm input-xlate-table autominblock command, ITT memory may already be somewhat fragmented because of previous commands. This condition can be mitigated by configuring a cross-connect using the maximum VCI on a VPI when first using the VPI. For the automatic determination of minimum block size on a VPI to be effective a PVC should be configured using the planned maximum VCI on a VPI .

To ensure that software allocates optimally sized ITT blocks, even after the system is restarted, enable the autominblock mode before all PVCs are defined. Save the configuration.


Note   Note that in analyzing the PVCs to determine minimum ITT block size, PVCs that are not a part of cross connects are included as well as cross-connected PVCs.

Examples

The following example shows how enable autominblock mode. FutureITTrequests will be assigned automatic (depending on how the atm input-xlate-table minblock is set) ITT blocks that are sized based on system analysis of existing ITT blocks.

Switch# configure terminal
Switch(config)# atm input-xlate-table autominblock
Switch(config)# 

Related Commands

Command  Description 

atm input-xlate-table minblock vpi

Use to specify the minimum ITT block size that the software attempts to use to allocate an ITT block.

atm input-xlate-table autoshrink

Use to free up ITT memory blocks after high-number VCIs are removed.

show atm input-xlate-table

Use to view ITT utilization, including blocks used and available, and ports to which blocks are allocated.

atm input-xlate-table autoshrink

To free up ITT memory blocks after high-number VCIs are removed, use the atm input-xlate-table autoshrink global configuration command. To disable the autoshrink function, use the no form of this command.

atm input-xlate-table autoshrink
no atm input-xlate-table autoshrink

Syntax Description

None

 

Defaults

Disabled.

Command Modes

Global configuration

Command History

Release  Modification 

12.1(6)EY

New command

Usage Guidelines

Under normal operation, an ITT block is not resized after a member VC is removed unless it is the only member VC inthe ITT block. If the only remaining VC is removed from an ITT block, the block will be freed. When the atm input-xlate-table autoshrink command is used, and a VC is removed from an ITT block, a check is made to determine whether the block size can be reduced to a lower power of two (all ITT block sizes are a power of two). If so, the block size is reduced to this amount.

Examples

The following example shows how to enable autoshrink mode. Once this mode is enabled, when high numbered VCs are deleted, the system will shrink existing ITT blocks in-place.

Switch# configure terminal
SSwitch(config)# atm input-xlate-table autoshrink
Switch(config)# 

Related Commands

Command  Description 

atm input-xlate-table minblock vpi

Use to specify the minimum ITT-block size that the software attempts to use to allocate an ITT block.

atm input-xlate-table autominblock

Use to enable automatic determination of minimum ITT block sizes for all VPIs populated with PVCs/Soft PVC source legs.

show atm input-xlate-table

Use to view ITT utilization, including blocks used and available, and ports to which blocks are allocated.

atm input-xlate-table minblock vpi

To specify the minimum ITT-block size that the software attempts to use to allocate an ITT block, use the atm input-xlate-table minblock vpi command. To disable the minblock, use the no form of this command.

atm input-xlate-table minblock vpi vpi-value block-size [force]
no atm input-xlate-table minblock vpi

Syntax Description

vpi-value

VPI to which the command applies. Valid range is 0 to 255 for the LS1010/6400 NSP. Valid range is 0 to 4095 for the 8540MSR.

block-sixe

The value is rounded to the smallest power of 2 greater than or equal to the entered value. Valid range is 32 to 16384.

force

Forces the user-entered value to be used in configuring ITT blocks. If the force keyword is not specified, the user-entered value will not be saved in the startup configuration file.

Defaults

Disabled.

Command Modes

Interface configuration

Command History

Release  Modification 

12.1(6)

New command

Usage Guidelines

The purpose of this command is to reduce ITT fragmentation thus better utilizing system resources. Ensure that the specified block size corresponds to the desired VC usage so system resources are efficiently used. ITT resources are used only when a connection is installed (When both interfaces that the VC transits are up).

This command is particularly useful when the needs of SVCs transiting an interface/VPI can be anticipated. If the user-specified block is larger than what is needed for the VCI, and the requested block size is larger than what is available, then a smaller than requested block size will be allocated for VCI.

Table 2-3   minblock command usage

autominblock mode enabled  force minblock command keyword used  Effect 

True

True

Command accepted; value rounded up and used as block-size hint, value not overridden by automatic analysis; value will be nvgened.

True

False

Command accepted; value rounded up used as a floor for block-size hint. value may be overridden by automatic analysis; value not neccesarily nvgened.

False

True

Command accepted; value rounded up and used as block-size hint; value will be nvgened.

False

False

Command not accepted.

Examples

The following example shows how to set the ITT minblock to 32K. In this example the force keyword is used to override any automatic block sizing.

Switch# configure terminal
Switch(config)# interface atm 0
Switch(config-if)# atm input-xlate-table minblock vpi 4095 32 force
Switch(config-if)# 

Related Commands

Command  Description 

atm input-xlate-table autominblock

To enable automatic determination of minimum ITT block sizes for all VPIs populated with PVCs/Soft PVC source legs, use the atm input-xlate-table autominblock command. To disable autominblock, use the no form of this command.

atm input-xlate-table autoshrink

To free up ITT memory blocks after high-number VCIs are removed, use the atm input-xlate-table autoshrink command. To disable the autoshrink function, use the no form of this command.

show atm input-xlate-table

To view ITT utilization, including blocks used and available and ports to which blocks are allocated, use the show atm input-xlate-table command.

atm input-xlate-table autominblock

To enable automatic determination of minimum ITT block sizes for all VPIs populated with PVCs/Soft PVC source legs, use the atm input-xlate-table autominblock command. To disable autominblock, use the no form of this command.

atm input-xlate-table autominblock
no atm input-xlate-table autominblock

Syntax Description

None

 

Defaults

Autominblock mode is disabled.

Command Modes

Global configuration

Command History

Release  Modification 

12.1(6)

New command

Usage Guidelines

If autominblock is active, the system will look at all interfaces and determine the minimum ITT block sizes for all VPIs populated with PVCs and SoftPVC source legs that can use the ITT. When autominblock is active, the system makes adjusts to the ITT block sizes as VCs are added or deleted. When generating a startup configuration file, atm input-xlate-table autominblock commands are inserted for each interface and VPI on which a user-defined PVC (that receives cells on the interface) or source leg of a Soft-PVC is defined.

On initial configuration of the atm input-xlate-table autominblock command, ITT memory may already be somewhat fragmented because of previous commands. This condition can be mitigated by configuring a cross-connect using the maximum VCI on a VPI when first using the VPI. A PVC should be configured using the planned maximum VCI on a VPI for the automatic determination of minimum block size on a VPI to be effective.

To ensure that software allocates optimal-sized ITT blocks-even after the system is restarted-enable the autominblock mode before or after all PVCs are defined. Save the configuration.

Examples

The following example shows how enable autominblock mode. Future IIT requests will be assigned automatic (depending on how atm input-xlate-table minblock is set) ITT block sized based on system analysis of existing ITT blocks.

Switch# configure terminal
Switch(config)# interface atm 0
Switch(config-if)# atm input-xlate-table autominblock
Switch(config-if)# 

Related Commands

Command  Description 

atm input-xlate-table minblock vpi

To specify the minimum ITT-block size that the software attempts to use to allocate an ITT block, use the atm input-xlate-table minblock vpi command. To disable the minblock, use the no form of this command.

atm input-xlate-table autoshrink

To free up ITT memory blocks after high-number VCIs are removed, use the atm input-xlate-table autoshrink command. To disable the autoshrink function, use the no form of this command.

show atm input-xlate-table

To view ITT utilization, including blocks used and available and ports to which blocks are allocated, use the show atm input-xlate-table command.

atm input-xlate-table autoshrink

To free up ITT memory blocks after high-number VCIs are removed, use the atm input-xlate-table autoshrink command. To disable the autoshrink function, use the no form of this command.

atm input-xlate-table autoshrink
no atm input-xlate-table autoshrink

Syntax Description

None

 

Defaults

Disabled.

Command Modes

Global configuration

Command History

Release  Modification 

12.1(6)

New command

Usage Guidelines

Under normal operation, an ITT block is not resized after a member VC is removed unless it is the only member VC of the ITT block. If the only remaining VC is removed from an ITT block, the block will be freed. When atm input-xlate-table autoshrink is enabled, and a VC is removed from an ITT block, a check is made to determine if the block size could be reduced by a power of two. If the block can be resized, it is done.

Examples

The following example shows how to enable autoshrink mode. Once this mode is enabled, the system will shrink existing ITT blocks in-place when high numbered VCs are deleted.

Switch# configure terminal
Switch(config)# atm interface 0
Switch(config-if)# atm input-xlate-table autoshrink
Switch(config-if)# 

Related Commands

Command  Description 

atm input-xlate-table minblock vpi

To specify the minimum ITT-block size that the software attempts to use to allocate an ITT block, use the atm input-xlate-table minblock vpi command. To disable the minblock, use the no form of this command.

atm input-xlate-table autominblock

To enable automatic determination of minimum ITT block sizes for all VPIs populated with PVCs/Soft PVC source legs, use the atm input-xlate-table autominblock command. To disable autominblock, use the no form of this command.

show atm input-xlate-table

To view ITT utilization, including blocks used and available and ports to which blocks are allocated, use the show atm input-xlate-table command.

atm interface-group

To allow more than one interface to have the same ATM address, use the atm interface-group command. To remove the interface from an interface group, use the no form of this command.

atm interface-group group_number
no atm interface-group group_number

Syntax Description

group_number

Assigns a group number to this interface. Valid range is 1 to 1000.

Defaults

None.

Command Modes

Interface configuration

Command History

Release  Modification 

12.1(5a)EY

New command

Usage Guidelines

ATM address groups allow more than one interface to have the same ATM address. These multiple connections provide load balancing for traffic from an end station.

Examples

The following example shows how to configure ATM interface 1/1/0 and ATM interface 3/0/1 in ATM address group 5:

Switch(config)# interface atm 1/1/0

Switch(config-if)# atm interface-group 5

Switch(config-if)# exit

Switch(config)# interface atm 3/0/1

Switch(config-if)# atm interface-group 5

Related Commands

Command  Description 

show running-config

Shows the ILMI configuration on a per-port basis.

atm lecs-address

To configure the LECS address advertised by the switch to the end system, use the atm lecs-address interface configuration command.

atm lecs-address lecsaddress [sequence#]

Syntax Description

lecsaddress

Address of the LAN Emulation configuration server.

sequence#

Sequence number of the LECS.

Defaults

If the LECS address is not configured on an interface, the LECS address that was configured using the atm lecs-address-default global configuration command is used by default.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

The LECS address is provided by the switch to directly connect LANE clients over the ILMI. LECS addresses can be configured on both interface and global levels. The globally configured address is sent to a port only if there is no LECS address configured on that port. The sequence number provides the position of this address in the ordered LECS address table.

Related Commands

Command  Description 

atm lecs-address-default

Configures the LECS address advertised by the switch to the end system.

show atm ilmi-configuration

Displays the switch configuration.

atm lecs-address-default

To configure the LECS address advertised by the switch to the end system, use the
atm lecs-address-default global configuration command.

atm lecs-address-default lecsaddress [sequence #]

Syntax Description

lecsaddress

Address of the LECS.

sequence #

Sequence number of the LECS.

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

The LECS address is provided by the switch to directly connected LANE clients over the ILMI. LECS addresses can be configured on both interface and global levels. The globally configured address is sent to a port only if there is no LECS address configured on that port. The sequence number provides the position of this address in the ordered LECS address table.

Related Commands

Command  Description 

atm lecs-address

Used to configure the LECS address advertised by the switch to the end system.

show atm ilmi-configuration

Used to display the switch configuration.

atm link-distance

To alter the propagation delay component of the cell-transfer delay offered by an interface, use the
atm link-distance command. To reset the propagation delay to the default value, use the no form of this command.

atm link-distance p-value
no atm link-distance

Syntax Description

p-value

Specified in units of kilometers, which is then divided by the speed of light in kbps to derive a propagation delay in microseconds (0 to 65535).

Defaults

0

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

The cell-transfer delay is used for the resource connection admission control of a CBR or VBR-RT connection.

This resource management command is supported for interface and subinterface configurations, and when interface metrics are provided to PNNI routing.

Related Commands

Command  Description 

show atm interface resource

Displays resource management interface configuration status and statistics.

atm manual-well-known-vc

To create and delete well-known (reserved) PVCs with non-default connection identifiers, or other nondefault parameters, use the atm manual-well-known-vc interface configuration command.
To reenable the automatic default well-known VC mode, use the no form of this command.

atm manual-well-known-vc [delete | keep]
no atm manual-well-known-vc

Syntax Description

delete

When specified, the existing automatically created VCs are deleted. If well-known VCs exist, you are prompted to confirm that the VC can be automatically deleted. If you reply with no, the command stops abruptly.

keep

When specified, the existing automatically created well-known VCs remain in place and appear in the running configuration.

Defaults

The keep option becomes the default on existing automatically created VCs when manual mode
is entered.

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

This command does not apply to the route processor interface (ATM 0).

All interfaces default to the no form of this command during initial startup. When this command is in effect, well-known VCs are not automatically created at startup. When this mode is enabled on an interface, the allowed range for VCI values is 5 through 16383, instead of 32 through 16383.

The three additional reserved channel encapsulation types added for the CPU PVCs are QSAAL, PNNI, and ILMI. These specify that the interface is a signalling, PNNI, or ILMI reserved channel.

You must enter the copy running-config command using the startup-config option to disable the automatic creation of default well-known VCs at system startup.

Although the OAM channels for tunnels are well-known channels (VCI 3 and VCI 4), they are not affected by the atm manual-well-known-vc status.


Note   You should not change the well-known channels to use a VC where the remote end is sending AAL5 messages not intended for this well-known VC. This means you should not swap VC values between two types of well-known VCs.

When using the no form of this command, if there are existing non-default reserved channel VCs for this interface, you are prompted to confirm that the VC can be automatically deleted. (If you enter no, the command stops abruptly.) Well-known VCs with default configurations are then automatically created for the interface. The default well-known PVCs are no longer shown as part of the running configuration.

Examples

The following example puts an interface into the manual-well-known-vc mode, deletes the existing default signalling PVC, and then creates a signalling PVC using a VCI value of 7.

Switch(config-if)# atm manual-well-known-vc keep
Switch(config-if)# no atm pvc 0 5
Switch(config-if)# atm pvc 0 7 interface atm 0 0 any-vci encap qsaal

Related Commands

Command  Description 

atm pvc

Used to create a PVC.

copy running-config startup-config

Copies the switch's running configuration file to another destination, and further specifies the configuration used for initialization as the destination of the copy operation.

atm maxvc-number

To configure the maximum number of ATM VCs supported on the ATM interface, use the atm maxvc-number interface configuration command. To restore the default value, use the
no form of this command.

atm maxvc-number max-vc-num
no atm maxvc-number

Syntax Description

max-vc-num

Maximum number of supported virtual channels. Configures the maximum number of virtual channels supports (0 to 32768).

Defaults

32768 virtual channels

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

Before using this command, the interface must be administratively shut down.

Examples

The following example sets the maximum number of ATM virtual channels supported on interface
ATM 0/0/0 to 8000.

Switch(config)# interface atm 0/0/0
Switch(config-if)# shutdown
Switch(config-if)# atm maxvc-number 8000

Related Commands

Command  Description 

atm maxvci-bits

Configures the maximum number of active bits of VCI supported on an ATM interface.

atm pvc

Used to create a PVC

show atm interface

Displays ATM-specific information about an ATM interface.

shutdown (interface)

Cisco IOS command removed from this manual.

atm maxvci-bits

To configure the maximum number of active bits of VCI supported on an ATM interface, use the
atm maxvci-bits interface configuration command. To restore the default value, use the no form of
this command.

atm maxvci-bits max-vci-bits
no atm maxvci-bits

Syntax Description

max-vci-bits

Maximum number of active bits supported on an ATM interface. Configures the maximum number of VCI bits (0 to 14).

Defaults

14 bits

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

Before using the atm maxvci-bits command, disable the atm auto-configuration command. Refer to "Examples" below.

When the atm auto-configuration command is configured, it causes a change in the maximum number of active VCI bits, and ATM signalling and ILMI are restarted automatically on the interface. When ATM signalling is restarted, all switched virtual connections across the interface are cleared; permanent virtual connections are not affected.

Examples

The following example sets the maximum number of active VCI bits to 10 for interface ATM 0/0/0.

Switch(config)# interface atm 0/0/0
Switch(config-if)# no atm auto-configuration
Switch(config-if)#
%ATM-6-ILMINOAUTOCFG: ILMI(ATM0/0/0): Auto-configuration is disabled, current interface parameters will be used at next interface restart.
Switch(config-if)# atm maxvci-bits 10
Switch(config-if)#
%ATM-5-ATMSOFTSTART: Restarting ATM signalling and ILMI on ATM0/0/0.

Related Commands

Command  Description 

atm auto-configuration

Used to enable or disable ILMI autoconfiguration.

atm connection-traffic-table-row

Creates a table entry.

atm maxvc-number

Configures the maximum number of ATM VCs supported on the ATM interface.

atm pvc

Used to create a PVC.

show atm interface

Displays ATM-specific information about an ATM interface.

atm maxvp-number

To configure the maximum number of ATM VPs supported on an ATM interface, use the
atm maxvp-number interface configuration command. To restore the default value, use the
no form of this command.

atm maxvp-number max-vp-number
no atm maxvp-number

Syntax Description

max-vp-number

Configures the maximum number of virtual paths supported:

  • For the Catalyst 8540 MSR: 0 to 4095
  • For the Catalyst 8510 MSR and LightStream 1010: 0 to 255

Defaults

For the Catalyst 8540 MSR: 4095 virtual paths

For the Catalyst 8510 MSR and LightStream 1010: 255 virtual paths

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Examples

The following example sets the maximum number of ATM virtual paths supported on interface ATM 0/0/1 to 128.

Switch(config)# interface atm 0/0/1
Switch(config-if)# atm maxvp-number 128

Related Commands

Command  Description 

atm maxvpi-bits

Configures the maximum number of active VPI bits supported on an ATM interface.

atm pvp

Used to create a PVP.

show atm interface

Displays ATM-specific information about an ATM interface.

shutdown (interface)

Cisco IOS command removed from this manual.

atm maxvpi-bits

To configure the maximum number of active VPI bits supported on an ATM interface, use the
atm maxvpi-bits interface configuration command. To restore the default value, use the no form
of this command.

atm maxvpi-bits max-vpi-bits
no atm maxvpi-bits

Syntax Description

max-vpi-bits

Configures the maximum number of active VPI bits supported on an ATM interface:

  • For the Catalyst 8540 MSR: 0 to 12.
  • For the Catalyst 8510 MSR and LightStream 1010: 0 to 8.

Defaults

8 bits

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines


Note   Before using this command, ILMI autoconfiguration must be disabled.
See the atm auto-configuration command.

When this command is configured and it causes a change in the maximum number of active VPI bits, ATM signalling and ILMI automatically restart on the interface. When ATM signalling is restarted, all switched virtual connections across the interface are cleared; permanent virtual connections are not affected.


Note   Only 6 interfaces per switch module can have the VPI bits set to more than 8 bits. If an interface with more than 8 bits of VPI is removed (for example, a port adapter is hot-swapped), you can set the VPI bits to more than 8 bits on another interface on the same switch module. If, however, you reinstall the original interface (which had more than 8 bits of VPI), it reconfigures back to 8 bits. If this occurs, the VCs with the VPI set to 255 or higher are sent into a NO HW RESOURCES state. To configure this interface back to a VPI of greater than 8, another interface on the same MSC module must be configured to less than 8 bits. To restore the VC from the NO HW RESOURCES state, toggle the interface using the shut or no shut command. (Catalyst 8540 MSR)

Examples

The following example sets the maximum number of active VPI bits to 6 for interface ATM 0/0/0.

Switch(config)# interface atm 0/0/0
Switch(config-if)# no atm auto-configuration
Switch(config-if)#
%ATM-6-ILMINOAUTOCFG: ILMI(ATM0/0/0): Auto-configuration is disabled, current interface parameters will be used at next interface restart.
Switch(config-if)# atm maxvpi-bits 6
Switch(config-if)#
%ATM-5-ATMSOFTSTART: Restarting ATM signalling and ILMI on ATM0/0/0.

Related Commands

Command  Description 

atm auto-configuration

Used to enable or disable ILMI autoconfiguration.

atm connection-traffic-table-row

Creates a table entry.

atm maxvp-number

Configures the maximum number of ATM VPs supported on an ATM interface.

atm pvp

Used to create a PVP.

show atm interface

Displays ATM-specific information about an ATM interface.

show switch fabric (Catalyst 8540 MSR)

Shows the details of the switch fabric for an ATM switch router.

atm mbs-default

To change the default MBS to request for UPC of cells received on the interface for connections
that do not individually request an MBS value, use the atm mbs-default interface configuration command. To reset the default MBS for a particular service category to the default value, use the
no form of this command.

atm mbs-default {vbr-rt | vbr-nrt} number
no atm mbs-default {vbr-rt | vbr-nrt}

Syntax Description

number

A positive integer, in the range of 0 to 2147483647. The MBS is expressed in cells.

Defaults

1024

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

MBS is used to determine the burst tolerance limit parameter used in the GCRA policing algorithm to police SCR.

MBS can be specified for PVCs through a connection traffic table row. If no MBS is specified in the row, then a per-interface, per-service category default MBS is applied for purposes of UPC on the connection. This command allows for changes to the MBS default.

Examples

The following example shows changing the default MBS for received cells on VBR-RT connections.

Switch(config-if)# atm mbs-default vbr-rt 4000

Related Commands

Command  Description 

atm connection-traffic-table-row

Creates a table entry.

show atm vc

Displays the ATM layer connection information about the virtual connection.

show atm vp

Displays the ATM layer connection information about the virtual path.

atm nni

To configure an ATM NNI on the specified physical or logical (VP tunnel) port, use the atm nni interface configuration command.

atm nni

Syntax Description

This command has no keywords or arguments.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines


Note   Before using this command, ILMI autoconfiguration must be disabled.
See the atm auto-configuration command.

When this command is configured and it causes a change in the interface protocol, ATM signalling and ILMI are restarted automatically on the interface. When ATM signalling is restarted, all switched virtual connections across the interface are cleared; permanent virtual connections are not affected.

The PNNI routing and signalling protocol is run over all NNI interfaces, except those interfaces on which signalling was previously disabled (see the atm signalling enable command). To configure an IISP interface, use the atm iisp command.

The atm auto-configuration, atm iisp, and atm nni commands are mutually exclusive. Configuring the atm nni command overwrites any previous configuration of the atm iisp command for this interface. Future configuration of the atm auto-configuration, and atm iisp command on this interface overwrites the atm nni command.

Examples

The following example shows configuring an ATM NNI on logical port card 3, subcard 1, and
port 3, VPI 99.

Switch(config)# interface atm 3/1/3.99 
Switch(config-subif)# atm nni

Related Commands

Command  Description 

atm auto-configuration

Used to enable or disable ILMI autoconfiguration.

atm iisp

Configures ATM IISP on the specified physical or logical (VP tunnel) port.

atm signalling enable

Enables the signalling and SSCOP on a port.

show atm interface

Displays ATM-specific information about an ATM interface.

atm nsap-address

To configure the NSAP-format ATM end-system address of an ATM interface, use the
atm nsap-address interface configuration command. To remove any configured NSAP-format
address for the interface, use the no form of this command.

atm nsap-address nsap-address
no atm nsap-address

Syntax Description

nsap-address

A 20-octet NSAP address. Specifies the 40-digit hexadecimal NSAP address of this interface (the source address).

Command Modes

Interface configuration

Command History

Release  Modification 

11.2(5)

New command

Usage Guidelines

This command only applies to the route processor interface and subinterfaces.

The NSAP-format ATM end-system address of an interface is used by static maps (refer to the section "Configuring an SVC-Based Map List" in the ATM Switch Router Software Configuration Guide) and by Classical IP over ATM, as defined in RFC 1577 (see the section "Configure Classical IP over ATM in an SVC Environment" in the ATM Switch Router Software Configuration Guide).

The NSAP-format ATM end-system address of an interface can be configured using either the
atm esi-address or the atm nsap-address command. Configuring a new address on the interface overwrites the previous address. The atm esi-address and atm nsap-address commands are mutually exclusive. Configuring the switch with the atm esi-address command negates the atm nsap-address setting, and vice versa.

NSAP-format ATM end-system addresses have a fixed length of 40 hexadecimal digits. Configure the address using the following dotted format:

xx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xx

The dots can be omitted.


Note   ATM addresses configured using the atm nsap-address command are not automatically registered with ATM routing on the switch. In addition to configuring these addresses using the atm nsap-address command, the addresses must be configured as static routes on the route processor interface of the ATM switch router.

Examples

The following example shows how to configure the NSAP-format ATM end-system address for interface ATM 0.1.