Table of Contents

ATM Commands

atm abr-mode

To select efci marking, relative-rate marking, or both, use the atm abr-mode global 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

Default

relative-rate

Command Mode

Global configuration

Usage Guidelines

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

If the ABR/UBR output queue of the forward-direction interface of the connection is congested, using the relative-rate argument marks a backward RM cell on an ABR connection when it is queued to the ABR/UBR output queue of the backward-direction interface.

Example

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

Related Command

show atm resource

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

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.

Examples

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 8510 and LightStream 1010 ATM Switch 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 8510 and LightStream 1010 ATM Switch 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 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 | transmit} rate
atm cac max-sustained-cell-rate {receive | transmit} rate

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

Syntax Description

Defaults

No link-sharing, best-effort limits, or traffic parameter limits. On a physical interface, all service categories are permitted; on a shaped VP tunnel, only CBR is supported.

Command Mode

Interface configuration

Usage Guidelines

You can configure the link-sharing parameter only on physical ports 0 or 6 on a 25-Mbps PAM.

Use the atm cac commands to tune parameters used in the Connection Admission Control functions performed by Resource Management. The four types of parameters, which are configured per interface, are described in Table 2-2. Any changes to these parameters only affect subsequent connection setups.

Table 2-2  

Default

1024

Command Mode

Interface configuration

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 and the defaults specified on the interface should be used.

Example

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

Related Commands

atm connection-traffic-table-row
show atm vc
show atm vp

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

Syntax Description

Default

Rows 1 through 6 in the table are predefined.

Command Mode

Global configuration

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, the default value is chosen to use in UPC. The FC-PFQ supports a dual leaky bucket: when VBR connections are monitored, PCR/CDVTs are used for one bucket, and SCR/MBSs are used for the other.

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 are 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-signalable cell-rate (the maximum cell-rate that fits in 24 bits).

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 FC-PFQ polices only the CLP-0 flow of cells to the scrval. When the scr10 keyword is used, the CLP-0+1 flow is policed.

Example

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

Related Commands

atm pvc
atm pvp
show atm connection-traffic-table

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

atm e164 address e164-address
no atm e164 address

Syntax Description

Command Mode

Interface configuration

Usage Guidelines

Use this command to configure a native E.164 address 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 this interface that specify this 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 received called and calling party subaddresses as the new called and calling party addresses.

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

Example

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

Related Commands

atm route
show atm addresses
show atm interface
show atm vc

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 Mode

Interface configuration

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.

Example

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

Related Command

show atm interface

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 address

Syntax Description

This command has no keywords or arguments.

Command Mode

Interface configuration

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

Example

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

Related Commands

atm e164 translation-table
atm route
atm e164 auto-conversion
e164 address
show 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

Syntax Description

This command has no keywords or arguments.

Command Mode

Global configuration

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.

Example

The following example shows starting ATM E.164 translation configuration mode.

Related Commands

atm e164 translation
e164 address

atm esi-address

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

atm esi-address esi.selector
no atm esi-address esi.selector

Syntax Description

Default

No end station ID is defined for this interface.

Command Mode

Interface configuration

Usage Guidelines

This command only applies to the processor interface and subinterfaces.

The NSAP-format ATM end system address of an interface is used by static maps (see the section "SVC Based Map-List Configuration" in the Catalyst 8510 and LightStream 1010 ATM Switch Software Configuration Guide) and by Classical IP over ATM, as defined in RFC 1577 (see the section "Configure Classical IP over ATM in a SVC Environment" in the Catalyst 8510 and LightStream 1010 ATM Switch 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) are provided by the ATM switch (refer to the atm address and atm prefix commands for more information). The resulting ATM address is registered on the ATM switch using ILMI address registration.

Example

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

Related Commands

atm address
atm nsap-address
atm prefix

atm filter-expr

To configure an ATM address filter that matches patterns, use 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

Default

Permit

Command Mode

Global configuration

Usage Guidelines

The first form listed defines a simple filter expression that is pattern-matched only if the pattern given by term is matched.

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

The third form defines a filter expression that is pattern-matched if either of the patterns given by the two terms are matched.

The fourth form defines a filter expression that is pattern-matched only if both of the patterns given by the two terms are matched.

The fifth form 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.

Example

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

Related Command

atm 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

Default

Permit

Command Mode

Global configuration

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.

Example

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

Related Command

atm access-group

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

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 going from the source switch at the burst level to 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

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 going from the source switch at the burst level to 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

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 peak of the high-priority cell rate from the source switch to 1000 kbps.

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

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 of the aggregate of low- and high-priority cell rate from the source switch to 100000 kbps.

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

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 of high-priority cells from the source switch to 100000 kbps.

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

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 high-priority cells from the source switch to 100000 kbps.

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.

Default

Disabled

Command Mode

Global configuration

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 feature card version FC-PFQ is installed.

When you enable hierarchical scheduling, it impacts the behavior of the Connection Admission Control (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, and ABR/UBR with non-zero MCR.

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

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.

Best effort VCs, or VCs with guarantees larger than 76.114 Kbps, do not affect the behavior of the switch.

Example

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

Related Commands

atm pvp
show running-config

atm idle-timeout

To change the idle timer for SVCs on an interface that will cause the SVCs to disconnect when inactive for a specified interval, use the atm idle-timeout interface configuration command. To return to the default setting, use the no form of this command.

atm idle-timeout seconds
no atm idle-timeout

Syntax Description

Default

300 seconds

Command Mode

Interface configuration. This command applies only to the processor interface (ATM 0).

Usage Guidelines

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

Example

The following example shows setting the timeout to 250.

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

Default

See "Syntax Description"

Command Mode

Interface configuration

Usage Guidelines

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, 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 Catalyst 8510 and LightStream 1010 ATM Switch ATM Switch Software Configuration Guide for more information about this command.

The atm auto-configuration, atm iisp, and atm nni, and atm uni 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 (see 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.

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

Related Commands

atm auto-configuration
atm nni
atm route
show atm interface
show atm route

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

Syntax Description

Default

permit all

Command Mode

Global configuration

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 (see the atm address-registration command for additional information).

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 via 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 for additional information).

Example

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

Related Commands

atm address
atm address-registration
atm prefix
summary-address

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.

Default

Enabled

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ATM 0 interface.

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.

Example

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

Related Commands

atm address-registration
atm auto-configuration
atm ilmi-keepalive
show atm ilmi-status

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

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ATM 0 interface.

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

Example

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.

Related Commands

atm ilmi-enable
show atm ilmi-status

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

Default

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 Mode

Interface configuration

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

atm lecs-address-default
show atm ilmi-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

Command Mode

Global configuration

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

atm lecs-address
show atm ilmi-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

Default

0

Command Mode

Interface configuration

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 Command

show atm interface resource

atm manual-well-known-vc

To create and delete well-known (reserved) PVCs with non-default connection identifiers or other non-default 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

Default

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

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the 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 are 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 startup-config command 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.

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.

Example

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.

Related Commands

atm pvc
copy running-config startup-config

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

Default

32,768 virtual channels

Command Mode

Interface configuration

Usage Guidelines

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

Example

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

Related Commands

atm maxvci-bits
atm pvc
show atm interface
shutdown (interface)

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

Default

14 bits

Command Mode

Interface configuration

Usage Guidelines

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 VCI bits, 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.

Example

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

Related Commands

atm auto-configuration
atm connection-traffic-table-row
atm maxvc-number
atm pvc
show 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-no
no atm maxvp-number

Syntax Description

Default

255 virtual paths

Command Mode

Interface configuration

Example

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

Related Commands

atm maxvpi-bits
atm pvp
show atm interface
shutdown (interface)

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

Default

8 bits

Command Mode

Interface configuration

Usage Guidelines

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

Example

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

Related Commands

atm auto-configuration
atm connection-traffic-table-row
atm maxvp-number
atm pvp
show atm interface

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 a 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} num
no atm mbs-default {vbr-rt | vbr-nrt}

Syntax Description

Default

1024

Command Mode

Interface configuration

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.

Example

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

Related Commands

atm connection-traffic-table-row
show atm vc
show atm vp

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 Mode

Interface configuration

Usage Guidelines

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 or atm uni commands for this interface. Future configuration of the atm auto-configuration, atm iisp, or atm uni command on this interface overwrites the atm nni command.

Example

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

Related Commands

atm auto-configuration
atm iisp
atm signalling enable
atm uni
show 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

Command Mode

Interface configuration

Usage Guidelines

This command only applies to the processor interface and subinterfaces.

The NSAP-format ATM end system address of an interface is used by static maps (see the section "SVC Based Map-List Configuration" in the Catalyst 8510 and LightStream 1010 ATM Switch ATM Switch Software Configuration Guide) and by Classical IP over ATM, as defined in RFC 1577 (see the section "Configure Classical IP over ATM in a SVC Environment" in the Catalyst 8510 and LightStream 1010 ATM Switch ATM Switch 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. It is recommended that the address be configured using the following dotted format.

The dots can be omitted.

Example

The following example shows configuration of the NSAP-format ATM end-system address for interface ATM 0.1.

Related Command

atm esi-address

atm nsap (map-list)

To define an ATM map statement for an SVC, use the atm-nsap map-list configuration subcommand in conjunction with the map-list global configuration subcommand. To remove the address, use the no form of this command.

protocol protocol-address atm-nsap atm-nsap-address [class class-name] [broadcast]
[aal5mux]
no protocol protocol-address atm-nsap atm-nsap-address [class class-name] [broadcast]
[aal5mux]

Syntax Description

Default

No map statements are defined.

Command Mode

Map-list configuration

Usage Guidelines

This command is required with the map-list command when you are configuring an SVC.

Example

In the following example, a map list named atmsvc includes one map statement for a destination address being mapped.

Related Command

map-list

atm oam (global)

To configure the OAM, AIS, RDI, and loopback operations and to set the maximum number of OAM connections, use the atm oam global configuration command. To disable these operations, use the no form of this command.

atm oam [ais] [end-loopback] [intercept end-to-end] [max-limit number] [rdi]
[seg-loopback]
no atm oam [ais] [end-loopback] [intercept end-to-end] [max-limit number] [rdi]
[seg-loopback]

Syntax Description

Command Mode

Global configuration

Usage Guidelines

To set the maximum number of OAM connections that can be configured per switch, use the atm oam max-limit global configuration command.

Example

The following example globally enables AIS, RDI, and segment loopback operators for all interfaces.

Related Command

atm oam (interface)

atm oam (interface)

To configure the OAM, AIS, RDI, and loopback modules at the interface level, use the atm oam interface configuration command. To disable these modules, use the no form of this command.

atm oam [vpi [vci]] [ais] [end-loopback] [loopback-timer] [interface card/subcard/port [.vpt#]] [max-limit][rdi] [seg-loopback]
no atm oam [vpi [vci]] [ais] [end-loopback] [loopback-timer] [interface card/subcard/port [.vpt#]] [max-limit][rdi] [seg-loopback]

Syntax Description

Default

The default is 5 seconds for the loopback-timer interval.

Command Mode

Interface configuration

Usage Guidelines

To enable or disable OAM operations on a VP connection, only specify the vpi value. To enable or disable VC connections, you must specify both vpi and vci values.

In interface and subinterface command modes, vpt configuration is supported.

Use the atm oam loopback-timer command only with the seg-loopback and end-loopback keywords.

Examples

The following example enables end-loopback on vpi 50 vci 100 on ATM 3/0/0.

The following example enables or disables the OAM, AIS, RDI, and loopback operation to a specified connection.

The following example shows changing the loopback timer interval to 10 seconds.

Related Command

atm oam (global)

atm output-queue

To change the maximum queue size of the output queue, use the atm output-queue interface configuration command. To reset the maximum queue size to the default value, use the no form of this command.

atm output-queue [force] {cbr | vbr-rt | vbr-nrt | abr-ubr} max-size size-num
no atm output-queue [force] {cbr | vbr-rt | vbr-nrt | abr-ubr} max-size

Syntax Description

Default

Varies by physical interface type, queue, and for abr-ubr or vbr-nrt queues, by the OSF value.

Command Mode

Interface configuration

Usage Guidelines

The force argument indicates that the change should be made even if it results in losing data on the interface queue (the queue must be momentarily disabled to change the threshold). This command without the force argument only changes the threshold if the interface is down. An error message is displayed and the command does not take effect if the interface is up and the force argument is not present.

This command is not supported for the subinterface configuration and does not apply to the processor interface (ATM 0).

You can configure the parameters only on physical ports 0 or 6 on a 25-Mbps PAM.

Example

In the following example, the maximum size of the vbr-nrt output queue is set to a minimum of 512 cells. This can be set even if the interface is up.

Related Commands

atm over-subscription-factor
show atm interface
show atm interface resource

atm output-threshold

To change the output queue thresholds, use the atm output-threshold interface configuration command. To reset the threshold to the default value, use the no form of this command.

atm output-threshold {cbr | vbr-rt | vbr-nrt | abr | ubr} discard disc-thresh-num
atm output-threshold {cbr | vbr-rt | vbr-nrt | abr | ubr} efci efci-thresh-num
atm output-threshold abr relative-rate abr-thresh-num

no atm output-threshold discard disc-thresh-num
no atm output-threshold efci efci-thresh-num
no atm output-threshold abr relative-rate abr-thresh-num

Syntax Description

Default

For all service categories, discard is 87 percent and efci is 25 percent. The abr relative-rate is 25 percent.

Command Mode

Interface configuration

Usage Guidelines

This command is not supported for subinterface configuration. This command does not apply to the processor interface (ATM 0).

You can configure the abr relative-rate parameter only on physical ports 0 or 6 on a 25-Mbps PAM. The following rules apply:

Example

In the following example, the discard threshold of the VBR-NRT queue is set to 87 percent of the maximum queue size.

Related Command

show atm interface resource

atm over-subscription-factor

To set the OSF, use the atm over-subscription-factor global configuration command. To assign the default value to OSF, use the no form of this command.

atm over-subscription-factor o-value
no atm over-subscription-factor

Syntax Description

Default

8

Command Mode

Global configuration

Usage Guidelines

This command has no effect on systems equipped with the FC-PFQ. The OSF number is a positive integer in the range from 1 through 32. This command is used to determine the initial port queue size. OSF is used to size the VBR-NRT and ABR-UBR queues.

The resizing of queues can be overridden using the atm output-queue command. Changes to atm over-subscription-factor only take place during startup.

The sizing of VBR-NRT and ABR-UBR queues is determined by the following equations.

The default size of the CBR and VBR queues vary by interface type as defined in Table 2-3.

Table 2-3   Default Maximum Queue Size by Interface Type

Default

Determined by the mode set by the administrative-weight command.

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ATM 0 interface and applies only the NNI interface.

Use this command to manually set the administrative weight of an interface. Changing the administrative weight of an interface to a larger value might cause calls to be routed away from the interface.

Related Commands

administrative-weight
show atm pnni interface

atm pnni aggregation-token

To specify the aggregation token for a PNNI interface, use the atm pnni aggregation-token PNNI interface configuration command.

atm pnni aggregation-token value

Syntax Description

Default

0

Command Mode

PNNI interface configuration

Usage Guidelines

Aggregation tokens are used to determine the grouping of links that are summarized to higher levels of the PNNI hierarchy. All lower-level links with the same aggregation token between a pair of peer groups will be treated as a single aggregated link at the parent node level.

In the default case, all parallel links between two peer groups are aggregated together with aggregation token 0.

Example

The following example shows how to set the aggregation token on ATM interface 1/0/0.

Related Commands

aggregation-mode
show atm pnni aggregation link
show atm pnni aggregation node

atm pnni link-selection

To configure a method for selecting a link out to multiple links to the same neighbor, use the atm pnni link-selection interface configuration command. To return to the default value, use the no form of this command.

atm pnni link-selection [admin-weight-minimize | blocking-minimize | load-balance |
transmit-speed-maximize]
no atm pnni link-selection

Syntax Description

Default

blocking-minimize

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ATM 0 interface.

This command only affects CBR and VBR calls. Load balancing is always used for ABR and UBR calls.

Link selection applies whenever the port specified in the DTL is zero and there are multiple interfaces to the next node.

When multiple parallel links are configured inconsistently, the order of precedence of configured values is admin-weight-minimize, blocking-minimize, transmit-speed-maximize, and load-balance. For example, if any link is configured as admin-weight-minimize, that becomes the link selection criteria for the entire group.

Related Command

show atm pnni neighbor

atm pnni node

To specify which PNNI node in the switch runs on an interface when the interface runs PNNI, use the atm pnni node interface configuration command. To return to the default value, use the no form of this command.

atm pnni node node-index
no atm pnni node

Syntax Description

Default

Node index 1

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ATM 0 interface.

Currently node index 1 is the only valid value. Refer to the node command for more information.

By default, PNNI node 1 automatically runs on all PNNI interfaces.

This command does not turn PNNI on or off for this interface. See the atm auto-configuration command and the atm nni commands for more information on the interface type.

Example

The following example shows how to configure a PNNI node index on ATM interface 1/0/0.

Related Commands

atm auto-configuration
atm nni
node
show atm pnni interface

atm prefix

To configure an ILMI address prefix for an ATM interface, use the atm prefix interface configuration command. To delete a configured ILMI address prefix, use the no form of this command.

atm prefix 13-byte-prefix
no atm prefix

Syntax Description

Command Mode

Interface configuration

Usage Guidelines

This command is used to assign one or more address prefixes to a specific interface that is different from any prefixes based on the switch addresses (see the atm address command). ILMI assigns the prefix to end systems attached to this interface. These prefixes are used as network prefixes during ILMI address registration.

Whenever one or more ILMI address prefix is assigned on an interface, no network prefixes derived from the switch address are used for address registration on that interface.

Example

The following example shows how to configure an ILMI address prefix on interface ATM 3/1/0.

Related Commands

atm address
show atm addresses
show atm ilmi-status

atm pvc

To create a PVC, use the atm pvc interface configuration command. To create a PVCC, use the long form of the atm pvc command. To create a PVCL, use the short form of the atm pvc command. To remove the specified PVC, use the no form of this command.

atm pvc vpi-A [vci-a | any-vci] [cast-type type-A] [upc upc-A] [pd pd] [rx-cttr index]
[tx-cttr index] [wrr-weight weight] interface atm card-B/subcard-B/port-B [.vpt #]
vpi-B [vci-B | any-vci] [cast-type type-B] [upc upc-B] [encap aal-encap] [inarp minutes]
[wrr-weight weight]
atm pvc vpi vci [cast-type type] [upc upc] [pd pd] [rx-cttr index] [tx-cttr index]
[wrr-weight weight]
no atm pvc vpi vci

Syntax Description

Defaults

See the syntax descriptions.

Command Mode

Interface configuration

Usage Guidelines

The commands are used to create or delete the following types of ATM connections on a switch.

When setting UBR connections the tx-cttr and rx-cttr fields are not needed, but these fields are required when setting up a CBR, VBR, or ABR connection. Refer to the atm connection-traffic-table-row command for information on configuring in the connection traffic table specified by index.

Examples

The following example configures a terminating PVC between interface ATM 3/1/1 and the processor port (ATM 0 on the ATM switch and ATM 13/0/0 on the Catalyst 5500).

The following example shows how to set up a UBR PVC connection between interface ATM 3/0/0 and 3/0/1 with a vpi of 0 and a vci of 40.

The following example shows a display using the encap variable.

The following example shows the commands how to use establish a PVC between a logical interface (VP tunnel) on ATM 3/1/1.99 and ATM 3/0/0.

The following example shows how to use the show atm vc command to display all VCs on an interface. The Encap column is displayed only on systems equipped with the FC-PFQ.

The following example shows using the show atm vc command to display detailed information about a specific connection on a system equipped with the FC-PCQ.

The following example shows using the show atm vc command to display detailed information about a specific connection on a system equipped with the FC-PFQ.

The following example shows how to delete the previously configured ATM transit point-to-point PVC.

Related Commands

atm connection-traffic-table-row
atm pvp
show atm interface
show atm vc

atm pvp

To create a PVP, use the atm pvp interface configuration command. To create a PVPC, use the long form of the atm pvp command. To create a PVPL, use the short form of the atm pvp command. To remove the specified PVP, use the no form of this command.

atm pvp vpi-A [cast-type type-A] [upc upc-A] [rx-cttr index] [tx-cttr index]
[wrr-weight weight] interface atm card-B/subcard-B/port-B vpi-B [cast-type type-B]
[upc upc-B] [wrr-weight weight]
atm pvp vpi [cast-type type] [hierarchical | shaped] [upc upc] [rx-cttr index] [tx-cttr index]
[wrr-weight weight]
no atm pvp vpi

Syntax Description

Defaults

See the syntax descriptions.

Command Mode

Interface configuration

Usage Guidelines

When the PVP is specified as shaped or hierarchical, it must subsequently be used as a VP tunnel (via the interface command). Only CBR VPs can be used for shaped or hierarchical tunnels. A shaped or hierarchical PVP cannot be cross-connected.

The commands are used to create or delete the following types of ATM connections on a switch:

ATM switches equipped with ASP-B and feature card version FC-PFQ, can have hierarchical VP-tunnels defined on the following ports:

ATM switches equipped with ASP-C and feature card version FC-PFQ, can have hierarchical VP-tunnels defined on the following ports:

Any physical port with one or more hierarchical VP tunnels defined cannot have any other VCs or VPs (signalled or permanent) defined on that port (except well known VCs).

Conversely, to define a hierarchical VP tunnel on a port, all existing VCs or VPs on that port must be removed.

Tag switching must not be configured on a port that has hierarchical VP tunnels defined.

Before you physically remove a port adapter from the chassis with hierarchical VP tunnels defined, we strongly recommended that all defined hierarchical VP tunnels be deleted, unless an identical port adapter is plugged back in. If you do not do this, the hardware schedulers allocated for these hierarchical tunnels remain allocated and cannot be used by any other port.

Examples

The following example shows how to configure an ATM PVP from ATM 3/1/1 to ATM 3/1/2.

The following example shows how to use the show atm vp command to display details about the ATM interface 3/1/1 for VPI 99 using the FC-PFQ.

To create a VP tunnel on a physical interface, enter the interface configuration mode for the switch, then specify the PVP and create the tunnel. The following example shows the commands used to create a tunnel on ATM 0/0/1.

The following example shows how to use the show atm interface command to display the interface information about ATM 0/0/1.51 using the FC-PFQ.

To create a hierarchical VP tunnel on a physical interface, enter the interface configuration mode for the switch, then specify the PVP and create the tunnel. The following example shows the commands used to create a hierarchical VP tunnel on ATM 0/0/0.10.

Related Commands

atm connection-traffic-table-row
atm pvc
show atm interface
show atm vp

atm qos default

To change individual QoS objectives assigned to SVC setup messages entering the switch via UNI interfaces, use the atm qos default global configuration command. To return all objective values for a service category to the default, use the no form of this command.

atm qos default {cbr | vbr-rt} max-cell-transfer-delay {microseconds | any}
atm qos default {cbr | vbr-rt} peak-to-peak-cell-delay-variation {microseconds | any}
atm qos default {cbr | vbr-rt | vbr-nrt} max-cell-loss-ratio [clp0 | clp1plus0]
{loss-ratio exponent | any}
no atm qos default {cbr | vbr-rt | vbr-nrt}

Syntax Description

Default

any

Command Mode

Global configuration

Usage Guidelines

This command changes the individual QoS objectives used in establishing CBR or VBR SVCs. The QoS objectives are as follows:

These objectives can be set differently for each of the three service categories: CBR, VBR-RT, and VBR-NRT (VBR-NRT only uses CLR0 and CLR01). All UNI SVC requests received for a particular service category use the configured values. These objectives are signalled across a continuous sequence of PNNI hops, starting at the source switch.

When you specify max-cell-loss-ratio, and the clp0 or clp1plus0 value is not configured, the default is CLP=0.

Example

In the following example, the cbr MaxCTD objective is set to 1000 microseconds.

Related Command

show atm resource

atm rmon collect

To add a port to an ATM-RMON MIB port select group, use the atm rmon collect interface configuration command. To disable ATM-RMON collection, use the no form of this command.

atm rmon collect number
no atm rmon collect

Syntax Description

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command allows references to a nonexistent port select group. You cannot reference an active port select group. However, you can access the group if RMON collection is disabled using the no atm rmon collect command.

Collection must be disabled with the no atm rmon enable command before using the no form of this command.

Currently, this command is not allowed on logical ports (VP tunnel).

Example

The following example shows setting the port select group number to 1000.

Related Commands

atm rmon enable
interface
show atm rmon

atm rmon enable

To enable ATM-RMON MIB data collection, use the atm rmon enable global configuration command. To stop data collection for all fully configured port select groups, use the no form of this command.

atm rmon enable
no atm rmon enable

Syntax Description

This command has no keywords or arguments.

Default

Disabled

Command Mode

Global configuration

Usage Guidelines

Using this command causes dynamic data pools to be allocated and data collection to begin in the background. Also this command propagates signalling information to the RMON agent.

When using the no form of this command, all control tables are preserved; however, the drop, insert, and delete counters are cleared, and all data tables are removed.

Related Command

show atm rmon

atm rmon portselgrp

To configure statics, host, and matrix collection parameters for ATM-RMON MIB, use the atm rmon portselgrp global configuration command. To remove data to a configured port select group, use the no form of this command.

atm rmon portselgrp number [descr string | host-prio number | host-scope number |
matrix-prio number | matrix-scope number | maxhost number | maxmatrix | nostats |
owner string]
no atm rmon portselgrp number

Syntax Description

Default

See individual commands.

Command Mode

Global configuration

Usage Guidelines

To use this command, configure the ports into port select groups using the atm rmon collect interface configuration command.

The following list shows how to use this command.

1. Configure ports.

2. Configure portselgrp.

3. Enable RMON.

Example

The following example shows configuring the port select group and sets the maxhost to 1000 and the matrix-scope to 3.

Related Commands

atm rmon collect
show atm rmon

atm route

To specify a static route to a reachable address prefix, use the atm route global configuration command. To delete a static route, use the no form of this command.

atm route addr-prefix interface-type card/subcard/port [.vpt#] [internal] [scope org-scope]
[e164-address address-string [number type numtype]]
no atm route addr-prefix interface-type card/subcard/port [.vpt#] [internal] [scope org-scope]
[e164-address address-string [number type numtype]]

Syntax Description

Default

See the syntax descriptions.

Command Mode

Global configuration

Usage Guidelines

The internal keyword should be used when a static route is configured to an address prefix representing an attached end system (for example, in place of an ILMI address registration).

The type of static route should be exterior, and the internal keyword should not be present when a static route is configured to an address prefix representing end systems attached to a different switch or network.

The scope keyword value translates to a PNNI level according to the PNNI scope map. Refer to the scope map and scope mode commands for more information.

When the e164-address option is included, the specified address-string is passed on as the called party address. The received called party address is passed on as the called party subaddress, the E.164 address of this interface (configured using the atm e164 address command) is passed on as the calling party address, and the received calling party address (if any) is passed on as the calling party subaddress.

If no e164-address is specified, the received called party address and calling party address are passed on unchanged.

Examples

The following example shows how to configure a static route on interface ATM 1/2/1 to the address prefix 47.8 of 12 bits in length.

The following example shows how to configure a static route on interface ATM 1/2/1 to the address prefix 47.88 of 14 bits in length.

The following example shows how to configure a static route on ATM 0/0/0 with a forwarding E.164 address.

Related Commands

atm e164 address
redistribute
scope map
scope mode
show atm pnni scope
show atm route

atm route-optimization (interface)

To enable route optimization on an ATM interface, use the atm route-optimization command. To disable this feature, use the no form of this command.

atm route-optimization soft-connection [interval interval] [time-of-day {anytime | start-time end-time}]
no atm route-optimization soft-connection

Syntax Description

Default

See the syntax descriptions.

Command Mode

Interface configuration

Usage Guidelines

The time-of-day parameter is used as a filter to determine if route optimization is acceptable when the interval timer activates.

To ensure that route optimization takes place at least once a day, set the interval to a smaller value than the time range. After route-optimization starts, it runs until it is finished regardless of the time range. All connections on this interface that are subject to route optimization are checked to see if better paths exist. When better paths are found, the connections are rerouted.

Example

The following example enables soft VC route optimization on interface ATM 0/1/2, with the time period of 120 minutes.

Related Commands

atm route-optimization (EXEC)
atm route-optimization percentage-threshold
show atm interface

atm route-optimization (EXEC)

To initiate route optimization immediately for a specific interface or specific soft VC, use the atm route-optimization EXEC command.

atm route-optimization soft-connection interface {atm card/subcard/port [vpi [vci]] |
serial card/subcard/port:cgn [dlci]}

Syntax Description

Command Mode

EXEC

Usage Guidelines

If you do not specify VPI and VCI, this command sets optimization for a specific interface. If you specify VPI and VCI, this command sets optimization for a specific soft VC.

Examples

The following example shows how to initiate ATM route optimization on a soft VC at ATM interface 1/0/0 100 250.

The following example shows how to initiate ATM route optimization on a soft VC at serial interface 1/0/3:3 DLCI 248.

Related Commands

atm route-optimization (interface)
atm route-optimization percentage-threshold

atm route-optimization percentage-threshold

To specify the percentage reduction in the administrative weight of the existing path required to trigger route optimization, use the atm route-optimization percentage-threshold global configuration command. To set the threshold to the default value, use the no form of this command.

atm route-optimization percentage-threshold percent
no atm route-optimization percentage-threshold

Syntax Description