Table of Contents

ATM 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

Default

out

Command Mode

Interface configuration

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, atm filter-set, and atm template-alias global configuration commands.

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

Example

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

Related Commands

atm filter-expr
atm filter-set
atm template-alias
show atm filter-expr
show 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.

Default

Disabled

Command Mode

Interface configuration

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.

Example

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

Related Commands

interface
show atm accounting

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 Mode

Privileged EXEC

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.

Related Commands

atm accounting file
atm accounting selection

atm accounting enable

To globally enable the ATM VC accounting feature, 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.

Default

Disabled

Command Mode

Global configuration

Usage Guidelines

Accounting is enabled globally for the switch on interfaces for which 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 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.

Example

The following example shows enabling ATM accounting.

Related Command

atm accounting (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

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

Default

See the individual commands.

Command Mode

Global configuration

Usage Guidelines

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

Table 2-1   ATM Accounting Configuration Mode Subcommands

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
atm accounting collection
show atm accounting

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

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

Default

No default selection index. See the individual subcommand defaults.

Command Mode

Global configuration

Usage Guidelines

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

Example

The following example shows specifying the ATM accounting selection index as 1 and returning to the default connection types.

Related Commands

atm accounting collection
atm accounting file
connection-types
list

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

Default

The default value for the trap threshold is 90.

Command Mode

Global configuration

Usage Guidelines

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

Example

The following example shows changing the ATM accounting trap threshold to 80.

Related Command

show atm accounting

atm address

To assign a 20-byte ATM address to the switch, use the atm address global 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

Default

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

Command Mode

Global configuration

Usage Guidelines

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

In autoconfiguration mode, the switch establishes an address according to the format specified in the LightStream 1010 ATM Switch 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 re-enabled. 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 (refer to the Catalyst 8540 MSR ATM Switch Software Configuration Guide for more information).

In autoconfiguration mode, all switches have the same peer group identifier based on the first 7 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 the steps 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 address 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 prefix
auto-summary
show atm addresses

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

Default

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 global command atm ilmi default-access permit.

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ATM 0 interface.

This 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, so you can allow or deny certain ILMI registered addresses. If specified, the per-interface access filter overrides the global default access filter for ILMI address registration.

If you want to allow certain addresses to be registered via ILMI, but want 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 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 disables 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 address
atm ilmi default-access permit
atm ilmi-enable
atm prefix
show atm ilmi-status
summary-address

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

Default

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

Command Mode

Interface configuration

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 Command

show atm arp-server

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.

Default

Enabled

Command Mode

Interface configuration

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

Example

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

Related Commands

atm iisp
atm ilmi-enable
atm maxvci-bits
atm maxvpi-bits
atm nni
atm routing-mode
atm uni
show atm ilmi-status
show 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

Default

The parameter is not specified in the SVC setup request.

Command Mode

Map-class configuration

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

Example

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

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

Default

The parameter is not specified in the SVC setup request.

Command Mode

Map-class configuration

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

Example

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.

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 value, use the no form of this command.

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

Syntax Description

Default

The parameter is not specified in the SVC setup request.

Command Mode

Map-class configuration

Usage Guidelines

This command defines a traffic parameter for the SVC connection.

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

Example

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

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

Default

The parameter is not specified in the SVC setup request.

Command Mode

Map-class configuration

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

Example

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

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

Default

The parameter is not specified in the SVC setup request.

Command Mode

Map-class configuration

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

Example

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

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

Default

The parameter is not specified in the SVC setup request.

Command Mode

Map-class configuration

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

Example

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

atm cac

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-guaranteed-service-bandwidth {receive | transmit} percent
atm cac link-sharing max-bandwidth {cbr | vbr | abr | ubr} {receive | transmit} percent
atm cac link-sharing min-bandwidth {cbr | vbr | abr | ubr} {receive | transmit} percent

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

To change the best-effort interface connection limit, use the atm cac best-effort-limit command. To disable the best-effort limit, use the no form of this command.

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

To permit or deny a service category on an ATM physical interface or shaped 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 {cbr | vbr-rt | vbr-nrt | abr | ubr} {permit | deny}
no atm service-category {cbr | vbr-rt | vbr-nrt | abr | ubr}

To change the interface maximum for individual traffic parameters allowed on connection setup, use the following commands. To reset the maximum value to the default, use the no form of these commands.

atm cac max-cdvt {cbr | vbr | abr | ubr} {receive | transmit} cdvtval
atm cac max-mbs {receive | transmit} mbsval
atm cac max-min-cell-rate {abr | ubr} {receive | transmit} rate
atm cac max-peak-cell-rate {cbr | vbr | abr | ubr} {receive