Table of Contents

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:

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

Defaults

relative-rate

Command Modes

Global configuration

Command History

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.

Related Commands

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

Defaults

Disabled

Command Modes

Interface configuration

Command History

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.

Related Commands

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

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.

Related Commands

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

Command Modes

Privileged EXEC

Command History

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.

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

Note   The only filename currently allowed is acctng_file1.

Related Commands

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

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

Related Commands

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

Defaults

See "Syntax Description."

Command Modes

Global configuration

Command History

Usage Guidelines

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

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:

Examples

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

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.

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.

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

Related Commands

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

Defaults

No default selection index. See the individual subcommand defaults.

Command Modes

Global configuration

Command History

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.

Related Commands

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

Defaults

The default value for the trap threshold is 90.

Command Modes

Global configuration

Command History

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.

Related Commands

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

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

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.

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

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

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

Related Commands

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

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

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.

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.

Related Commands

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

Defaults

Disabled

Command Modes

Interface configuration

Command History

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:

Related Commands

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

Defaults

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

Command Modes

Interface configuration

Command History

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:

This implementation follows RFC 1577, "Classical IP over ATM."

Related Commands

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

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 affecte