cc/td/doc/product/atm/ls1010s/wa3/11_2_8
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

ATM Commands for the LightStream  1010 ATM Switch

ATM Commands for the LightStream  1010 ATM Switch

atm abr-mode

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

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

efci

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

relative-rate

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

all

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

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.

Switch(config)# atm abr-mode 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

name

The filter expression or filter set.

· in indicates you should apply the filter to an incoming SETUP message.

· out indicates you should apply the filter to an outgoing SETUP message.

Default

Out

Command Mode

Interface configuration

Usage Guidelines

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

You should use the atm filter-set command prior to using this command. Filter sets and expressions are described in this manual in the descriptions for 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.

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

atm filter-expr
atm filter-set
atm template-alias
show atm filter-expr
show atm filter-set

atm accounting enable (global)

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

No

Command Mode

Global configuration

Usage Guidelines

This command first appears in release 11.2(5).

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

Step 1 Enable ATM accounting in global configuration mode.

Step 2 Exit global configuration mode.

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

Step 4 Reboot the switch.


Note The switch needs 32 MB of memory or the switch returns an error message.
Example

The following example shows enabling ATM accounting.

Switch(config)# atm accounting enable
Switch(config)#
Related Commands

atm accounting (interface)
boot
copy running-config startup-config

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

This command first appears in release 11.2(5).

Use the show atm accounting privileged 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.

Switch(config)# interface atm 1/0/0
Switch(config-if)# shutdown
Switch(config-if)# atm accounting
Switch(config-if)# no shutdown
Related Command

interface

atm accounting collection

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

atm accounting collection {collect-now | swap} filename
Syntax Description

collect-now

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

filename

Specifies the filename for ATM collection.

swap

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

Command Mode

Privileged EXEC

Usage Guidelines

This command first appears in release 11.2(5).

Using the collect-now option returns 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.

Example

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

Switch# atm accounting collection collect-now acctng_file1
Switch#

The following example shows how to stop the data collection in the active file and switch it to the passive file:

Switch# atm accounting collection swap acctng_file1
File Swap Done. New Ready File 73 bytes (#records 0); Active File 67 bytes (#records 0);
Switch#
Related Commands

atm accounting file
atm accounting selection

atm accounting file

To configure an ATM accounting file and enter the accounting file configuration mode, use the atm  accounting file global configuration command.


Note The atm  accounting file global configuration command changes to configure ATM accounting mode and the new prompt Switch(config-acct-file)# appears.
atm accounting file filename
[
default {description|enable|failed-attempts | min-age}] [description string] [enable]
[failed-attempts {regular | soft | none}] [min-age seconds]
no atm accounting file filename
Syntax Description

filename

Specifies the filename of the accounting file.

default

Set a parameter to its defaults.

description

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

enable

Activate ATM accounting data collection to a specified file.

failed-attempts

Configures the writing of records for failed connection attempts.

· regular---SVCs/SVP

· soft---Soft PVCs/PVPs numbers that originate or terminate at switch interface

· none---do not record failed attempts

min-age

Configures the minimum age of the VC.

Default

The failed-attempts default is regular and soft.

The min-age default is 3600 seconds.

Command Mode

Global configuration

Usage Guidelines

This command first appears in release 11.2(5).

This release only supports one file entry which is created using the default values. You can only modify the following fields in the file.


Table 2-1:
Argument Description

regular

SVCs/SVP failed attempts are recorded.

soft

Soft PVCs/PVPs that originate or terminate at switch interface failed attempts are recorded.

regular soft

Both SVCs/SVP and soft PVCs/PVPs failed attempts are recorded (default).

none

No failed attempts are recorded.

Failed-Attempts Argument Description
Examples

The following example shows entering the ATM accounting file configuration mode.

Switch# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)#

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

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

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

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

atm accounting selection
atm accounting collection
show atm accounting

atm accounting selection

To configure an ATM accounting selection and enter the accounting selection configuration mode, use the atm accounting selection global configuration command. To delete the ATM selection table entry, use the no form of this command.


Note The atm  accounting selection global configuration command changes to configure ATM accounting selection mode and the new prompt Switch(config-acct-sel)# appears.
atm accounting selection index
[connection-types [spvc-originator] [spvc-target] [spvp-originator] [spvp-target]
[svc-in] [svc-out] [svp-in] [svp-out] default {connection-types | list} | list num]
no atm accounting selection index
Syntax Description

index

Configures the ATM accounting selection index number.1

connection-types

Defines the connection type. See Table 2-2 for the list of connection types.

default

Sets the connection-types or the list to the default.

list

Lists of objects to include. Specify in the form of a bitmap hexadecimal number.

1This release supports only one selection entry, which is created using default values.
Default

The default value for the list is to collect all fields (all 1s). The default value for the connection type is svc-in, svc-out, svp-in, and svp-out.

Command Mode

Global configuration

Usage Guidelines

This command first appears in release 11.2(5).

This release only supports one ATM selection table entry which is created using the default values which can not be deleted. You can only modify the ATM selection table variables using the no command.

Changes made to the list only take effect for the next collection, for example, after using the atm  accounting collection swap global configuration command. Changes to the connection-types take effect immediately.

Table 2-2 shows the connection types you can define.


Table 2-2: ATM Accounting Connection Types
Type Description

spvc-originator

Include originator SPVCs.

spvc-target

Include target SPVCs.

spvp-originator

Include originator SPVPs.

spvp-target

Include target SPVPs.

svc-in

Include incoming SVCs.

svc-out

Include outgoing SVCs.

svp-in

Include incoming SVPs.

svp-out

Include outgoing SVPs.

Example

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

Switch# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)# atm accounting selection 1
Switch(config-acct-sel)# default connection-types

The following example shows specifying the connection types for ATM accounting selection index  1 to spvc-originator and spvp-originator.

Switch(config)# atm accounting selection 1
Switch(config-acct-sel)# connection-types spvc-originator spvp-originator
Switch(config-acct-sel)#
Related Commands

atm accounting collection
atm accounting file

atm accounting trap threshold

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

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

percent-value

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

Default

The default value for the trap threshold is 90.

Command Mode

Global configuration

Usage Guidelines

This command first appears in release 11.2(5).

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

Example

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

Switch(config)# atm accounting trap threshold 80
Switch(config)#
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

address-template

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

Default

When no atm address has been configured, an autoconfigured ATM address is assigned. Refer to the LightStream 1010 ATM Switch User Guide for more information.

Command Mode

Global configuration

Usage Guidelines

You can have multiple ATM addresses. When you delete the most current address, the next address becomes available.

In autoconfiguration mode, the switch establishes an address according to the format specified in the software configuration guide.

The first 13-byte prefix of this address is 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 this prefix automatically in reachable address advertisements. Refer to the auto-summary command for more information.

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

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 Integrated Local Management Interface (ILMI) protocol, 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
no atm address-registration

Syntax Description

This command has no keywords or arguments.

Default

Enabled

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP 2/0/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. When the switch is on the user side of a UNI, the switch registers ATM addresses with 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.

Example

The following example disables ATM address-registration on ATM interface 1/0/0.

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

atm address
atm ilmi-enable
atm prefix
show atm ilmi-status

atm arp-server

To identify an ATM Address Resolution Protocol (ARP) server for the IP network or set time-to-live (TTL) values for entries in the ATM ARP table, use the atm arp-server interface configuration command.

atm arp-server [self [time-out minutes] | nsap nsap-address]
no atm arp-server [self [time-out minutes] | nsap nsap-address]
Syntax Description

self

(Optional) Specifies the current switch as the ATM ARP server.

time-out minutes

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

nsap nsap-address

(Optional) Network service access point (NSAP) address of an ATM ARP server.

Default

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

Command Mode

Interface configuration

Usage Guidelines

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 auto-configuration, 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 auto-configuration procedures, as specified in Section 8.3.3 of the ATM Forum ILMI 4.0 Specification.

Among the variables covered by ILMI auto-configuration 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 the atm maxvpi-bits commands.

This command takes effect after the interface is administratively shutdown (using the shutdown command) and the interface is restarted.

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 auto-configuration on interface ATM 0/1/2.

Switch(config)# interface atm 0/1/2
Switch(config-if)# shutdown
Switch(config-if)# atm auto-configuration
Switch(config-if)# no shutdown
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
shutdown

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 switched virtual circuit (SVC), use the atm backward-max-burst-size-clp0 map-class configuration command. The no form of this command restores the default.

atm backward-max-burst-size-clp0 cell-count
no atm backward-max-burst-size-clp0
Syntax Description

cell-count

Maximum number of high-priority cells coming from the destination switch at the burst level.

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 cell loss priority (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.

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

atm backward-max-burst-size-clp1

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

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

cell-count

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

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 100,000.

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

atm backward-peak-cell-rate-clp0

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

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

rate

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

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 cell loss priority (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.

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

atm backward-peak-cell-rate-clp1

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

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

rate

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

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.

Switch(config)# map-class atm high-rate
Switch(config-map-class)# atm backward-peak-cell-rate-clp1 7000

atm backward-sustainable-cell-rate-clp0

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

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

rate

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

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 cell loss priority (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.

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

atm backward-sustainable-cell-rate-clp1

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

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

rate

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

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.

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

atm cac

To change the resource management interface controlled link sharing parameters, use the atm cac link 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} {receive | transmit} percent
atm cac link-sharing min-bandwidth {cbr | vbr} {receive | transmit} percent
no atm cac link-sharing max-guaranteed-service-bandwidth {receive | transmit}
no atm cac link-sharing max-bandwidth {cbr | vbr} {receive | transmit}
no atm cac link-sharing min-bandwidth {cbr | vbr} {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 change the interface maximum for individual traffic parameters allowed on connection setup, use the following command. To reset the maximum value to the default value, use the no form of this command.

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

Syntax Description

receive

The configured parameter applies to the flow of traffic into the switch on the interface (or to the ASP 2/0/0 interface).

transmit

The configured parameter applies to the flow of traffic out of the switch on the interface (or from the ASP 2/0/0 interface).

percent

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

cbr

The constant bit rate connection.

vbr

The variable bit rate connection.

abr

The available bit rate connection.

ubr

The unspecified bit rate connection.

rate

A positive integer, measured in kilobits (kbps) per second, in the range of 0 through 910533065.

conn-value

The number of best-effort connections allowed on the interface (0 through 32768).

cell-count

The limit parameter used in the GCRA policing algorithm (cell-count expresses cell times in the range 0 through 2147483647).

Default

No link-sharing, best-effort limits, or parameter limits.

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.

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


Table 2-3:
Parameter Description

controlled link sharing

Specifies the minimum and maximum bandwidth that can be allocated to guaranteed service (CBR or VBR) connections. Maxima can be specified for CBR, VBR, and the aggregate of CBR and VBR. Minima can be specified for CBR and VBR. These parameters, for a direction, are interrelated as follows (assuming these parameters are defined):

  • min(CBR) + min(VBR) <= 95 percent

  • min(CBR) <= max(CBR) <= 95 percent

  • min(VBR) <= max(VBR) <= 95 percent

  • min(CBR) <= max(AGG) <= 95 percent

  • min(VBR) <= max(AGG) <= 95 percent

  • max(CBR) <= max(AGG) <= 95 percent

  • max(VBR) <= max(AGG) <= 95 percent

traffic parameter limits

Specifies maximum traffic parameters (peak-cell-rate, etc.) that are allowed on VC setup. These can be specified independently by service category and traffic direction.

best-effort connection limits

A limit on the total number of ABR and UBR connections on the interface.

Connection Admission Control Interface Parameters

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

The following commands are a subset of the interface configuration and are supported for the subinterface configuration.

atm cac best-effort-limit
atm cac max-peak-cell-rate
atm cac max-sustained-cell-rate
atm cac max-tolerance

The following command is not supported for the subinterface configuration.

atm cac link-sharing
Examples

In the following example, a peak-cell-rate traffic parameter limit of 3001 kbps is defined for ABR connections in the receive direction on the interface.

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

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

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

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

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

show atm interface resource

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 peak-cell-rate rate [tolerance
cell-count]
atm connection-traffic-table-row [index row-index] {vbr-rt | vbr-nrt} peak-cell-rate
rate sustained-cell-rate rate [tolerance cell-count]
atm connection-traffic-table-row [index row-index] abr peak-cell-rate rate
[tolerance cell-count]
atm connection-traffic-table-row [index row-index] ubr peak-cell-rate rate
[tolerance cell-count]
no atm connection-traffic-table-row row-index
Syntax Description

row-index

Is an integer in the range of 1 through 1073741823.

rate

Is a positive integer, measured in kilobits (kbps) per second, in the range of 0 through 910533065.

cell-count

Is used with tolerance and is the limit parameter used in the GCRA policing algorithm. It is an integer, with a range of 0 through 2147483647. The tolerance is expressed in cell-times (2.72 microseconds at 155.2 Mbps). For peak-cell-rate policing on cbr and ubr connections, the tolerance value is CDVT. For sustained-cell-rate policing on vbr-rt and vbr-nrt connections, the tolerance value is the maximum burst size.

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, software uses a free row-index, which is displayed to the user if the command is successful.

When the tolerance parameter is not specified in the creation of a row, a default value is chosen by software to use if UPC is enabled.

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

Example

In the following example, a cbr Connection Traffic Table row is defined with index 200 and a peak-cell-rate of 7,743 kbps.

Switch(config)# atm connection-traffic-table-row index 200 cbr peak-cell-rate 7743
Related Commands

atm pvc
atm pvp
show atm connection-traffic-table

atm default-tolerance

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

atm default-tolerance [cbr | vbr-rt | vbr-nrt | abr | ubr] num
no atm default-tolerance
Syntax Description

num

The limit parameter used in the GCRA policing algorithm. This parameter is an integer, with a range of 0 through 2147483647. The tolerance is expressed in cell-times (2.72 microseconds at 155.2 Mbps). For peak-cell-rate policing on cbr and ubr connections, the tolerance value is CDVT. For sustained-cell-rate policing on vbr-rt and vbr-nrt connections, the tolerance value is the Maximum Burst Size.

Default

1024

Command Mode

Interface configuration

Usage Guidelines

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

For signalled connections (SVC or Soft PVC), VBR tolerance (maximum burst size) can be signalled, but CBR/UBR tolerance cannot be signalled. The defaults specified on the interface are used.

Example

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

Switch(config-if)# atm default-tolerance vbr-rt 4000
Related Commands

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

atm e164 address

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

atm e164 address e164_address

e164_address

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

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

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

atm route
show atm addresses
show atm interface
show atm vc

atm e164 translation

To configure an interface to use the ATM E.164 translation table, use the atm e164 translation interface configuration command.

atm e164 translation
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 signaling 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 signaling 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.

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

atm e164 translation-table
atm route
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.

atm e164 translation-table
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.

    Switch(config)# atm e164 translation-table

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

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. The no form deletes the end station address.

atm esi-address esi.selector
no atm esi-address
esi.selector
Syntax Description

esi

End station ID field value in hexadecimal; 6 bytes long.

selector

Selector field value in hexadecimal; 1 byte long.

Default

No end station ID is defined for this interface.

Command Mode

Interface configuration

Usage Guidelines

This command only applies to the ASP 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 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 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 interface  2/0/0.1.

Switch# interface atm 2/0/0.1
Switch(config-subif)# atm esi-address 303132333435.36
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

name

The name of the pattern-matching filter expression.

term

Can be any of the following:

· a previously defined address pattern-matching expression

· a filter set applied to calling-party address---source <filter-set name>

· a filter set applied to called-party address---destination <filter-set name>

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.

    Switch(config)# atm filter-expr atm_filter_expr1 not source atm_filter_set1

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

Related 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

name

The name of the filter set.

index

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

permit

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

deny

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

template

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

time-of-day

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

start-time

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

end-time

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

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.

    Switch(config)# atm filter-set filter_set1 permit 47.0091.8100.0000.0003.bbe4.aa01.4000.0c80.0000.64

    Switch(config)# atm filter-set filter_set3 deny 47.840F...

    Switch(config)# no atm filter-set filter_set3

Related 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. The no form of this command restores the default value.

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

cell-count

Maximum number of high-priority cells going from the source switch at the burst level.

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 cell loss priority (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 100,000.

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

atm forward-max-burst-size-clp1

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

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

cell-count

Maximum number of the aggregate of low- and high-priority cells going from the source switch at the burst level.

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 100,000.

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

atm forward-peak-cell-rate-clp0

To change the peak rate of high-priority cells going from the source to the destination on the SVC, use the atm forward-peak-cell-rate-clp0 map-class configuration command. The no form of this command restores the default value.

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

rate

Maximum rate in kbps that this SVC can send of high-priority cells from the source switch. Maximum upper range is 7,113,539 (limited by 0xffffff cells-per-second).

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 cell loss priority (CLP) of 0 (high-priority cells).

Example

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

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

atm forward-peak-cell-rate-clp1

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

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

rate

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

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 100,000 kbps.

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

atm forward-sustainable-cell-rate-clp0

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

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

rate

Sustainable rate in kbps that this SVC can send of high-priority cells from the source. Maximum upper range is 7,113,539 (limited by 0xffffff cells-per-second).

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 cell loss priority (CLP) of 0 (high-priority cells).

Example

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

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

atm forward-sustainable-cell-rate-clp1

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

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

rate

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

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 100,000 kbps.

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

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

seconds

Number of seconds the SVC can be inactive before disconnecting. Setting seconds to 0 disables idle timeouts.

Default

300 seconds

Command Mode

Interface configuration. This command applies only to the ASP interface (ATM 2/0/0).

Usage Guidelines

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

atm iisp

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

atm iisp [side side] [version ver]
Syntax Description

side

Specified as user | network. The default is network.

ver

Specified as 3.0, 3.1 or 4.0.

Command Mode

Interface configuration

Usage Guidelines

Refer to the LightStream  1010 ATM Switch Software Configuration Guide for more information about this command.

Before using this command, the interface must be administratively shut down (see the shutdown command) and ILMI auto-configuration mode must be disabled (see the atm auto-configuration command).

The atm auto-configuration, atm iisp, atm nni, and atm uni commands are mutually exclusive. Configuring 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.

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

Switch(config)# interface atm 3/1/2
Switch(config-if)# shutdown
Switch(config-if)# no atm auto-configuration
Switch(config-if)# atm iisp side user version 3.0
Switch(config-if)# atm maxvci-bits 12
Switch(config-if)# no shutdown

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

Switch(config)# interface atm 4/1/3.100
Switch(config-subif)# shutdown
Switch(config-subif)# no atm auto-configuration
Switch(config-subif)# atm iisp
Switch(config-subif)# no shutdown
Related Commands

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

atm ilmi-enable

To enable the ILMI on a port, use the atm ilmi-enable interface configuration command. To disable the ILMI, 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 ASP 2/0/0 interface.

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

This command takes effect after the interface is administratively shutdown and then restarted using the shutdown command.

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

Example

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

Switch(config)# interface atm 0/1/2
Switch(config-if)# shutdown
Switch(config-if)# atm ilmi-enable
Switch(config-if)# no shutdown
Related Commands

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

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 [T]
no atm ilmi-keepalive
Syntax Description

T

The period in seconds at which the IME is polled. The minimum is 3 seconds.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP 2/0/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 for 6  seconds.

Switch(config)# interface atm 1/0/0
Switch(config-if)# atm ilmi-keepalive 6
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

lecsaddress

Address of the LAN Emulation configuration server.

sequence #

Sequence number of the LECS.

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

lecsaddress

Address of the LAN Emulation configuration server.

sequence #

Sequence number of the LECS.

Default

None

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

p-value

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

Default

Value is 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

delete

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

keep

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

Default

no

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP interface (ATM 2/0/0).

All interfaces default to the no form of this command during initial start-up. The keep option becomes the default, on existing automatically created VCs, when manual mode is entered.

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


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

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

Example

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

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

atm pvc
copy running-config startup-config

atm maxvc-number

To configure the maximum number of ATM virtual channels (VC) 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_no
no atm maxvc-number
Syntax Description

max_vc_no

Maximum number of supported virtual channels.

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 8,000.

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

atm maxvci-bits
atm pvc
show atm interface
shutdown

atm maxvci-bits

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

atm maxvci-bits max_vci_bits
no atm maxvci-bits
Syntax Description

max_vci_bits

Maximum number of active bits supported on an ATM interface.

Default

14 bits

Command Mode

Interface configuration

Usage Guidelines

Before using this command, the interface must be administratively shut down and autoconfiguration mode has to be disabled.

Example

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

Switch(config)# interface atm 0/0/0
Switch(config-if)# shutdown
Switch(config-if)# no atm auto-configuration
Switch(config-if)# maxvci-bits 10
Related Commands

atm auto-configuration
atm connection-traffic-table-row
atm maxvc-number
atm pvc
show atm interface
shutdown

atm maxvp-number

To configure the maximum number of ATM virtual paths (VP) 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

max_vp_no

Maximum number of supported virtual paths.

Default

255 virtual paths

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 paths supported on interface ATM  0/0/1 to 128.

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

atm maxvpi-bits
atm pvp
show atm interface
shutdown

atm maxvpi-bits

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

atm maxvpi-bits max_vpi_bits
no atm maxvpi-bits
Syntax Description

max_vpi_bits

Maximum number of active vpi bits supported on an ATM interface.

Default

8 bits

Command Mode

Interface configuration

Usage Guidelines

Before using this command, the interface must be administratively shut down and autoconfiguration mode has to be disabled.

Example

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

Switch(config)# interface atm 0/0/0
Switch(config-if)# shutdown
Switch(config-if)# no atm auto-configuration
Switch(config-if)# maxvpi-bits 6
Related Commands

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

atm multipoint-signaling

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

atm multipoint-signaling
no atm multipoint-signaling

Syntax Description

This command has no keywords and arguments.

Default

Interface configuration

Command Mode

Interface configuration

Usage Guidelines

This command only applies to the ASP and IP interface. If multipoint signaling is enabled, the switch uses existing static map entries that have the broadcast keyword set to establish multipoint calls. One call is established for each logical subnet of each protocol.

All destinations are added to the call. One multicast packet is sent to the ATM switch for each multipoint call. The ATM switch replicates the packet to all destinations.

atm nni

To configure an ATM Network Network Interface (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 the interface must be administratively shut down (see the shutdown command) and ILMI auto-configuration mode must be disabled (see the atm auto-configuration command).

The PNNI routing and signaling protocol is run over all NNI interfaces, except those interfaces on which signaling 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, atm nni, and atm uni commands are mutually exclusive. Configuring 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

Configure an ATM NNI on logical port card 4, subcard 1, and port 3, and the VPI is 99.

Switch(config)# interface atm 4/1/3.99 
Switch(config-subif)# shutdown
Switch(config-subif)# no atm auto-configuration
Switch(config-subif)# atm nni
Switch(config-subif)# no shutdown
Related Commands

atm auto-configuration
atm iisp
atm signalling-enable
atm uni
show atm interface
shutdown

atm nsap-address

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

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

Syntax Description

nsap-address

The 40-digit hexadecimal NSAP address of this interface (the source address).

Default

No NSAP address is defined for this interface.

Command Mode

Interface configuration

Usage Guidelines

This command only applies to the ASP 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 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 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.

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:

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

The dots may be omitted.


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

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

    Switch(config)# interface atm 2/0/0.1

    Switch(config-subif)# atm nsap-address 47.0091.8100.0000.1111.1111.1111.1111.1111.1111.00

    Switch(config-subif)# exit

    Switch(config)# atm route 47.0091.8100.0000.1111.1111.1111.1111.1111.1111.00 atm2/0/0 internal

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. The no form of this command removes the address.

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

protocol

Specified as the keyword ip.

protocol-address

Destination address that is being mapped to this SVC.

atm-nsap-address

Destination ATM NSAP address. Must be exactly 40 hexadecimal digits long and in the correct dotted format.

class class-name

(Optional) Name of a table that contains encapsulation-specific parameters. Such a table can be shared between maps that have the same encapsulation.

broadcast

(Optional) Indicates this map entry is to be used when the corresponding protocol sends broadcast packets to the interface.

aal5mux

(Optional) Uses aal5mux encapsulation. The default is snap.

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.

Switch(config)# map-list atm 1/0/0
Switch(config-map-list)# map-list atmsvc
ip 172.21.97.17 atm-nsap AB.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12 class qos
Related Command

map-list

atm oam

The following atm oam command globally configures the OAM, AIS, RDI, and loopback operation.

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

The following atm oam command configures the OAM, AIS, RDI, and loopback modules at the interface configuration level for a connection specified by vpi and vci.

atm oam [vpi [vci]] [ais] [end-loopback] [max-limit] [rdi] [seg-loopback]]
no atm oam
[vpi [vci]] [ais] [end-loopback] [max-limit] [rdi] [seg-loopback]]
Syntax Description

ais

AIS operation.

rdi

RDI operation.

seg-loopback

Segment loopback.

end-loopback

End-to-end OAM loopback.

card/sub-card/port [.vpt#]

Card, subcard, port, and tunnel number for the ATM interface.

vpi

(Optional) Virtual path identifier.

vci

(Optional) Virtual channel identifier.

max-limit

Maximum number of OAMs supported.

Command Mode

Global configuration
Interface configuration

Usage Guidelines

To enable or disable OAM operations on 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.

Examples

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

Switch(config)# atm oam seg-loopback ais rdi

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

Switch(config)# interface atm 3/0/0
Switch(config-if)# atm oam 50 100 end-loopback

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

Switch(config-if)# no atm oam 12 100 
Switch(config-if)# atm oam 19 rdi
Switch(config-if)# atm oam 100 200 ais rdi
Switch(config-if)# atm oam 34 89 seg-loopback end-to

atm oam max-limit

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

atm oam max-limit number
no atm oam max-limit
Syntax Description

number

Number of maximum OAM-configured connections allowed per switch. The range is 1 to  3200.

Command Mode

Global configuration

atm oam loopback-timer

To change the loopback interval, use the atm oam loopback-timer interface configuration command. Use the no for of this command to disable this feature.

atm oam vpi [vci] loopback-timer
no atm oam loopback-timer

Syntax Description

vpi vci

Specifies the virtual path identifier and virtual channel identifier.

Default

5 seconds

Command Mode

Interface configuration

Usage Guidelines

This command is only intended for use with atm oam seg-loopback and atm oam end-loopback.

Example

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

Switch(config-if) atm oam 50 100
Switch(config-if) atm loopback-timer 10

atm output-queue

To change the output queue maximum queue size, 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

size-num

Queue size in cells, 256 to 65250. For installation in hardware, the number provided is rounded up to the next value available in the hardware. The configured and installed values are both displayed using the show atm interface command.

max-size

Maximum output queue size per service category.

Default

Varies by physical interface type, queue, and for abr-ubr or vbr-nrt queues, by the value of Over Subscription Factor (OSF).

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 ASP 2/0/0 interface.

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.

Switch(config-if)# atm output-queue force vbr-nrt max-size 512
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

disc-thresh-num

Number 12, 25, 37, 50, 62, 75, 87, or 100 indicating the percentage of queue-full. Using 100 disables the threshold.

efci-thresh-num

Number 12, 25, 50, or 100, indicating the percentage of queue-full using 100 disables the threshold.

abr-thresh-num

Number 12, 25, 37, 50, 62, 75, 87, or 100 indicating the percentage of queue-full. Using 100 disables the threshold.

efci

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

relative-rate

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

discard

When a cell arrives at a congested output queue (as indicated by discard-threshold), it is eligible for clp discard (or EPD if EPD is enabled on the connection).

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 ASP 2/0/0 interface.

You can configure the ABR parameter relative-rate only on physical ports 0 or 6 on a 25-Mbps PAM.

Example

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

Switch(config-if)# atm output-threshold vbr-nrt discard 87
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

o-value

A positive integer from 1 to 32.

Default

Value is 8

Command Mode

Global configuration

Usage Guidelines

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 by using the atm output-queue command. Changes to atm over-subscription-factor only take place during start-up.

The sizing of vbr-nrt and abr-ubr queues is determined by the following equations.

size (vbr-nrt) = .25 * ((osf * 2048) - DefaultSize (cbr) - DefaultSize (vbr-rt))
size (abr-ubr) = .75 * ((osf * 2048) - DefaultSize (cbr) - DefaultSize (vbr-rt))

The default size of the cbr and vbr queues vary by interface type as defined in the following list:
Interface Type Default Max Size CBR Queue Default Max Size VBR-RT Queue

SONET

256

256

DS3/E3

256

512

Example

In the following example, the over-subscription-factor of the switch is set to 15. This does not take effect in resizing ubr and vbr-nrt queues unless the configuration is written to NVRAM and the switch is restarted.

Switch(config)# atm over-subscription-factor 15
Related Commands

atm output-queue
show atm resource

atm pacing

To enable or change the artificial limitation on interface output rate, use the atm pacing interface configuration command. To disable output pacing, use the no form of this command.

atm pacing r-value [force]
no atm pacing
Syntax Description

r-value

Bit rate in thousand bits per second (kbps).

Default

No pacing

Command Mode

Interface configuration

Usage Guidelines

The force argument indicates that the change should be made even if it results in an output cell-rate that does not provide sufficient bandwidth for guaranteed service on the transmit flow of the interface. An error message is displayed and the command does not take effect if the change impacts guaranteed bandwidth and the force argument is not present.

This command is not supported for subinterface configuration and does not apply to the ASP 2/0/0 interface. You cannot configure this parameter on OC-12 and 25-Mbps ports.


Note The granularity of pacing rate provided by hardware varies with the size of the bit rate requested. The value entered by the user is rounded up to the closest value available for installation in hardware. Both the configured and installed values are displayed through the show interface command.
Example

In the following example, the transmit cell-rate of the interface is limited to the closest value possible in hardware, greater than 30,000 kbps. If the amount of bandwidth allocated to cbr and vbr connections in the transmit direction on the interface is greater than 30,000 kbps, the command fails.

Switch(config-if)# atm pacing 30000
Related Command

show atm interface resource

atm pnni admin-weight

To specify the administrative weight of the ATM PNNI interface, use the atm pnni admin-weight interface configuration command. To return to the default values, use the no form of this command.

atm pnni admin-weight number service-category
no atm pnni admin-weight service-category
Syntax Description

number

The administrative weight value assigned to the interface (1 to 1000000). Refer to the administrative-weight command for default values.

service-category

The keywords are cbr, vbr-rt, vbr-nrt, abr, ubr, or all.

Default

Determined by the mode set by administrative-weight command.

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP 2/0/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 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

admin-weight-minimize

Transmits call on the interface with the lowest administrative weight.

blocking-minimize

Minimizes subsequent call blocking.

load-balance

Balances calls across parallel links.

transmit-speed-maximize

Transmits calls on highest speed parallel link.

Default

blocking-minimize

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP 2/0/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 Designated Transit List (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

node-index

An integer, from 1 through 255, identifying a PNNI node running on this switch. Currently only a single lowest-level node with node index 1 is supported.

Default

Node index 1

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP 2/0/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.

Related Commands

atm auto-configuration
atm nni
node

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

13-byte_prefix

A 13-byte ATM address prefix, specified as 26 hexadecimal digits.

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.

Switch(config)# interface atm 3/1/0
Switch(config-if)# atm prefix 47123456789012345678112233
Related Commands

atm address
show atm addresses
show atm ilmi-status

atm pvc

To create a permanent virtual channel (PVC), use the atm pvc interface configuration command. Use the long form of the atm pvc command to create a permanent virtual channel connection (PVCC). Use the short form of the atm pvc command to create a permanent virtual channel link (PVCL). 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] 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]
atm pvc vpi vci [cast-type type] [upc upc] [pd pd] [rx-cttr index] [tx-cttr index]
no atm pvc vpi vci
Syntax Description

type

Specified as p2p | p2mp-root | p2mp-leaf. The default is p2p.

any-vci

Selects any available VCI. This feature only applies to the ASP interface (ATM 2/0/0).

vpi

ATM virtual path identifier (VPI) of this PVC, in the range from 0 through 255. The VPI is an 8-bit field in the header of the ATM cell. The VPI value is unique only on an interface, not throughout the ATM network (it has local significance only).

vci

ATM virtual channel identifier (VCI) of this PVC. The range is normally 32 through 16383 but is expanded to 5 through 16383 in manual-well-known-vc mode. The VCI is a 16-bit field in the header of the ATM cell. The VCI value is unique only on a single interface, not throughout the ATM network (it has local significance only).

pd

Intelligent packet discard option. Specified as on | off. The default is off.

vpt #

Specifies the virtual path tunnel number.

encap

ATM adaptation layer (AAL) and encapsulation type and applies only to terminating connections. When aal5mux is specified, a protocol is required. Possible values are as follows:

· aal5lane (a LAN Emulation-type virtual connection).

· aal5mux  decnet (a MUX-type virtual connection).

· aal5snap (LLC/SNAP precedes the protocol datagram). This is the only encapsulation supported for Inverse ARP.

· ilmi (specifies the ILMI control VC when in manual-well-known-vc mode only).

· pnni (specifies the PNNI control VC when in manual-well-known-vc mode only).

· qsaal (specifies the signaling control VC when in manual-well-known-vc mode only).

upc

Usage parameter control, specified as pass | tag | drop; the default is pass. The upc option can be set to tag or drop only under the following conditions:

· The ATM interface is not the ASP port (ATM 2/0/0) or a logical port (VP tunnel).

· The connection is not the leaf of a point-to-multipoint connection.

rx-cttr

Connection traffic table row index in the received direction. The connection-traffic table row should be configured before using atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the rx-cttr. The default is 1.

tx-cttr

Connection traffic table row index in the transmitted direction. The connection-traffic table row should be configured before using atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the tx-cttr. The default is 1.

card/subcard/port

Card, subcard, and port number for the ATM interface.

inarp minutes

Specifies how often Inverse ARP datagrams are sent on this virtual connection and applies only to terminating connections. The default value is 15 minutes.

Defaults

See individual commands.

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 the 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 ASP port (ATM 2/0/0 on the LightStream 1010 and ATM 13/0/0 on the Catalyst 5500).

Switch(config)# interface atm 2/0/0
Switch(config-if)# atm pvc 0 any-vci interface atm 3/1/1 0 100

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

Switch(config)# interface atm 4/0/0
Switch(config-if)# atm pvc 0 40 interface atm 4/0/1 0 40

The following example shows a display using the encap variable.

Switch(config-if)# atm pvc 100 200 interface atm 2/0/0 0 344 encap ?
aal5lane AAL5+LANE Encapsulation
aal5mux   AAL5+MUX Encapsulation
aal5snap AAL5+LLC/SNAP Encapsulation

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

Switch(config)# interface atm 4/1/1.99
Switch(config-subif)# atm pvc 99 100 interface atm 3/0/0 0 89
Switch(config-subif)# end

Use the following show atm vc command to display all VCs on an interface.

Switch# show atm vc interface ATM4/1/1.99
%SYS-5-CONFIG_I: Configured from console by consolevc interface atm 4/1/1.99
Interface    VPI     VCI     Type   X-Interface X-VPI   X-VCI   Status
ATM4/1/1.99 99      3        PVC     ATM2/0/0     0       59      UP
ATM4/1/1.99 99      4        PVC     ATM2/0/0     0       60      UP
ATM4/1/1.99 99      5        PVC     ATM2/0/0     0       56      UP
ATM4/1/1.99 99      16       PVC     ATM2/0/0     0       57      UP
ATM4/1/1.99 99      18       PVC     ATM2/0/0     0       58      UP
ATM4/1/1.99 99      100      PVC     ATM3/0/0     0       89     DOWN 

Use the show atm vc command to display detailed information about a specific connection.

Switch# show atm vc interface atm 0/1/0 1 10
Interface: ATM0/1/0, Type: oc3suni 
VPI = 1  VCI = 100
Status: UP
Time-since-last-status-change: 00:00:08
Connection-type: PVC 
Cast-type: point-to-point
Packet-discard-option: disabled
Usage-Parameter-Control (UPC): pass
Number of OAM-configured connections: 0
OAM-configuration: disabled
OAM-states:  Not-applicable
Cross-connect-interface: ATM0/1/3, Type: oc3suni 
Cross-connect-VPI = 1 
Cross-connect-VCI = 100
Cross-connect-UPC: pass
Cross-connect OAM-configuration: disabled
Cross-connect OAM-state:  Not-applicable
Rx cells: 0, Tx cells: 0
Rx connection-traffic-table-index: 1
Rx service-category: UBR (Unspecified Bit Rate)
Rx pcr-clp01: 7113539
Rx scr-clp01: none
Rx tolerance: 0 (from default for interface)
Tx connection-traffic-table-index: 1
Tx service-category: UBR (Unspecified Bit Rate)
Tx pcr-clp01: 7113539
Tx scr-clp01: none
Tx tolerance: none

The following example deletes the ATM transit point-to-point PVC previously configured.

Switch(config-if)# interface atm 1/1/1
Switch(config-if)# no atm pvc 50 100 
Related Commands

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

atm pvp

To create a permanent virtual path (PVP), use the atm pvp interface configuration command. Use the long form of the atm pvp command to create a permanent virtual path connection (PVPC). Use the short form of the atm pvp command to create a permanent virtual path link (PVPL). Use the no form of this command to remove the specified PVP.

atm pvp vpi-A [cast-type type-A] [upc upc-A] [rx-cttr index] [tx-cttr index] interface atm
card-B/subcard-B/port-B vpi-B [cast-type type-B] [upc upc-B]
atm pvp vpi [cast-type type] [upc upc] [rx-cttr index] [tx-cttr index]
no atm pvp vpi
Syntax Description

type

Specified as p2p | p2mp-root | p2mp-leaf. The default is p2p.

vpi

ATM virtual path identifier (VPI) of this PVP, in the range from 1 through 255. The VPI is an 8-bit field in the header of the ATM cell. The VPI value is unique only on a single interface, not throughout the ATM network (it has local significance only).

upc

Usage parameter control, specified as pass | tag | drop, the default is pass. The upc option can be set to tag or drop only under the following conditions:

· The ATM interface is not the ASP port (ATM 2/0/0) or a logical port (VP tunnel).

· The connection is not the leaf of a point-to-multipoint connection.

rx-cttr

Connection traffic table row index in the received direction. The connection-traffic table row should be configured before using atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the rx-cttr. The default is 1.

tx-cttr

Connection traffic table row index in the transmitted direction. The connection-traffic table row should be configured before using atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the tx-cttr. The default is 1.

card/subcard/port

Card, subcard, and port number for the ATM interface.

Defaults

See individual commands.

Command Mode

Interface configuration

Usage Guidelines

This command does not apply to the ASP port or logical port (VP tunnel).

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

Examples

The following example configures an ATM PVP from ATM 4/1/1 to ATM 4/1/2.

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

    Switch(config-if)# atm pvp 99 upc drop rx-cttr 37 tx-cttr 37 interface atm 4/1/1 88 upc tag


Use the show atm vp command to display details about the ATM. The following is an example of ATM  4/1/2.

Switch# show atm vp interface atm 0/1/0 2
Interface: ATM0/1/0, Type: oc3suni 
VPI = 2  
Status: NOT CONNECTED
Time-since-last-status-change: 00:00:29
Connection-type: PVP 
Cast-type: point-to-point
Usage-Parameter-Control (UPC): pass
Number of OAM-configured connections: 0
OAM-configuration: disabled
OAM-states:  Not-applicable
Rx cells: 0, Tx cells: 0
Rx connection-traffic-table-index: 1
Rx service-category: UBR (Unspecified Bit Rate)
Rx pcr-clp01: 7113539
Rx scr-clp01: none
Rx tolerance: 0 (from default for interface)
Tx connection-traffic-table-index: 1
Tx service-category: UBR (Unspecified Bit Rate)
Tx pcr-clp01: 7113539
Tx scr-clp01: none
Tx tolerance: none

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 4/1/1.

Switch(config)# interface atm 4/1/1
Switch(config-if)# atm pvp 99
Switch(config-if)# interface atm 4/1/1.99

Use the show atm interface command to display the interface information about ATM 4/1/1.99.

Switch# show atm interface atm 0/1/0.2
Interface:      ATM0/1/0.2      Port-type:    vp tunnel
IF Status:      UP              Admin Status: up
Auto-config:    enabled         AutoCfgState: waiting for response from peer
IF-Side:        Network         IF-type:      UNI
Uni-type:       Private         Uni-version:  V3.0
Max-VPI-bits:   0               Max-VCI-bits: 10
Max-VP:         0               Max-VC:       16383
Signalling:     Enabled         
ATM Address for Soft VC: 47.0091.8100.0000.0041.0b0a.1581.4000.0c80.1000.02
Configured virtual links:
  PVCLs SoftVCLs   SVCLs  Total-Cfgd  Installed-Conns
      4        0       0           4                4
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

microseconds

Integer number, which represents time in microseconds, in the range 0  through  16777214.

loss-ratio exponent

Positive integer in the range of 1 through 15. This represents 10 - (loss-ratio).

any

Indicates the QOS-value is not considered in the setup of the connection.

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 signaled across a continuous sequence of PNNI hops, starting at the source switch.

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

Example

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

Switch(config)# atm qos default cbr max-cell-transfer-delay 1000
Related Command

show atm resource

atm rmon collect

To add a port to an ATM remote monitoring MIB (RMON) 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

number

Specifies the port select group number from 1 to 2147483647.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command first appears in release 11.2(5).

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

Switch(config)# atm rmon enable
Switch(config)# interface atm 1/0/0
Switch(config-if)# atm rmon collect 1000
Related Commands

atm rmon enable
interface
show atm rmon

atm rmon enable

To enable ATM remote monitoring MIB (RMON) 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

This command first appears in release 11.2(5).

Using this command causes dynamic data pools to be allocated and data collection to begin in the background. Also this command activates the SIG-RMON interface.

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 stats, host, and matrix collection parameters for ATM remote monitoring MIB (RMON), 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

number

Specifies the number of the port select group from 1 to 2147483647.

descr

Specifies the descriptive label for the ATM-RMON collection.

host-prio

Specifies the host collection resource priority from 1 to 3. Use 1 for low, 2 for normal, and 3 for high. The default is 2.

host-scope

Specifies the host collection address collection scope from 1 to 3. Use 1 for prefix, 2 for prefix and esi, and 3 for entire address. The default is 2.

matrix-prio

Specifies the matrix collection resource priority from 1 to 3. Use 1 for low, 2 for normal, and 3 for high. The default is 2.

matrix-scope

Specifies the matrix collection address collection scope from 1 to 3. Use 1 for prefix, 2 for prefix and esi, and 3 for entire address. The default is 2.

maxhost

Specifies the maximum desired host entries from 0 to 4294967295. Use 0 to disable or omit the number to indicate no configuration limit.

maxmatrix

Specifies the maximum desired matrix entries from 0 to 4294967295. Use 0 to disable or omit the number to indicate no configuration limit.

nostats

Suppresses the collection of the atmStatsTable for this group.

owner

Specifies the owner for all the control tables used by the ATM-RMON collection (portSelGrpOwner, atmHostControlOwner, or atmMatrixControlOwner). The default is empty string.

Default

See individual commands.

Command Mode

Global configuration

Usage Guidelines

This command first appears in release 11.2(5).

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.

Switch(config-if)# atm rmon collect 3
Switch(config-if)# exit
Switch(config)# atm rmon portselgrp 3 maxhost 1000 matrix-scope 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 atm card/subcard/port [.vpt#] [internal] [scope org-scope]
[e164-address address_string] [number type {international | national | subscriber | local} ]
no atm route addr-prefix atm card/subcard/port [.vpt#] [internal]
Syntax Description

addr-prefix

Specifies the address prefix. The address prefix has a maximum length of 19 bytes. By default, each character in the prefix is 4 bits long. To specify a part of a prefix in bits, use parens () to enclose binary numbers. The asterisk (*) wildcard character means "don't care." Wildcard character ellipses (...) after a prefix means to "match any destination address that starts with the prefix."

card/subcard/port

Identified the card, subcard, and port number for the ATM interface.

.vpt#

Specifies an interface that represents a virtual path tunnel.

internal

Specifies an internal static route to an internal reachable address prefix. By default, an exterior static route to an exterior reachable address prefix is created.

scope org-scope

Specifies the organizational scope (for example, UNI scope) value for the route. The valid range of organizational scope values is from local (1) to global (15). The default organizational scope is global (15) for individual addresses and local (1) for group addresses.

e164-address

Associates a forwarding E.164 address with the static route.

address_string

Specifies a forwarding native E.164 address, used when a call matching the ATM address prefix is forwarded across the specified interface. The E.164 address consists of 7 to 15 decimal characters.

number type

Specifies a number from the following four options: international, national, subscriber and local.

Default

See individual commands.

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.

Switch(config)# atm route 47.8... atm 1/2/1
	

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.

Switch(config)# atm route 47.8(10*)... atm 1/2/1

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

Switch(config)# atm route 1234 atm 0/0/0 e164-address 1234567
Related Commands

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

atm route-optimization (Interface Configuration Command)

To enable route optimization on an ATM interface, use the atm route-optimization interface configuration 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

interval

Specifies the frequency of route optimization in minutes. The range is 10 to 10000. The default is 60 minutes.

soft-connection

Specifies that route optimization is enabled for all soft PVCs and soft PVPs for which this is the source interface.

time-of-day

Specifies the time range during which route optimization can occur.

anytime

Represents a 24-hour time range. The default time-of-day is anytime.

start-time

Specifies the start of the time range during which route optimization is allowed, in 24-hour format, hh:mm.

end-time

Specifies the end of the time range during which route optimization is allowed, in 24-hour format, hh:mm.

Default

See individual keywords.

Command Mode

Interface configuration

Usage Guidelines

The time-of-day is used as a filter to determine whether 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. Once 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 (see the atm  route-optimization percentage-threshold command).

Example

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

Switch(config)# interface atm 0/1/2
Switch(config-if)# atm route-optimization soft-connection interval 120
Related Commands

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

atm route-optimization (EXEC Command)

To immediately initiate route optimization 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]]
Syntax Description

card/subcard/port

Card number, subcard number, and port number of a specific ATM interface.

vpi

Virtual Path Identifier.

vci

Virtual Channel Identifier.

Command Mode

EXEC

Usage Guidelines

If vpi and vci are not specified, this command sets optimization for a specific interface. If vpi and vci are specified, this command sets optimization for a specific soft-vc.

Related Commands

atm route-optimization (Interface Configuration Command)
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

percent

Specify the route-optimization threshold in percent from 5 to 100.

Default

30

Command Mode

Global configuration

Usage Guidelines

When route optimization is enabled and the threshold is exceeded, the existing path is partially torn down and a new path is established. Currently route optimization is only supported for soft PVCs and soft PVPs.

Smaller values lead to greater network efficiency, at the expense of an increased amount of calls subject to rerouting.

Example

The following example shows setting the route-optimization threshold to 20 percent.

Switch(config)# atm route-optimization percentage-threshold 20
Related Commands

atm route-optimization (Interface Configuration Command)
atm route-optimization (EXEC Command)

atm router pnni

To start the PNNI configuration mode, use the atm router pnni global configuration command.

atm router pnni
no atm router pnni

Syntax Description

This command has no arguments or keywords.

Command Mode

Global configuration

Usage Guidelines

Use this command to start global PNNI configuration mode.

Example

The following example shows using the atm router pnni global configuration command to change to ATM router PNNI configuration mode.

Switch(config)# atm router pnni
Switch(config-atm-router)#
Related Command

show atm pnni node

atm routing-mode

To restrict the mode of ATM routing on an ATM switch, use the atm routing-mode global configuration command. To remove all restrictions on ATM routing, use the no form of this command.

atm routing-mode static
no atm routing-mode static
Syntax Description

static

Restricts ATM routing to allow only static configuration of ATM routes. In this routing mode, the switch does not run any dynamic ATM routing protocols, such as PNNI routing.

Default

Disabled (no restrictions on ATM routing)

Command Mode

Global

Usage Guidelines

This command takes effect on the next reboot.

Switch behavior in static routing mode is analogous to that of the LS1010 default IISP software images of Release 11.1. Without any restrictions on the routing mode, PNNI functionality is available on all interfaces.

This command differs from deletion of all PNNI nodes (using the node command) because it affects ILMI auto-configuration. When the switch is in static routing mode, for each interface, this switch's ILMI variable atmfAtmLayerNniSigVersion is set to iisp. This causes ILMI auto-configuration on interfaces between two switches to determine an interface type of IISP, unless the switch on the other side indicates NNI signaling protocol is not supported.

Example

The following example shows configuration of a switch to allow only static routing.

Switch(config)# atm routing-mode static
Related Commands

atm auto-configuration
node

atm service-category-limit

To set the limits on the number of cells simultaneously allowed in the switch memory by type of output queue, use the atm service-category-limit global configuration command. To set to the default value of 65,535, use the no form of this command.

atm service-category-limit {cbr | vbr-rt | vbr-nrt | abr-ubr} l-value
no atm service-category-limit {cbr | vbr-rt | vbr-nrt | abr-ubr}
Syntax Description

l-value

Integer in the range from 0 through 65,535, specified in units of cells.

Default

65535

Command Mode

Global configuration

Usage Guidelines

The no form of this command applies to all service categories.

Warning Setting a service-category-limit to 0 causes the connection requests for the associated service categories to be rejected.
Example

In the following example, the maximum number of abr and ubr cells allowed into the switch-fabric at one time is limited to 45,000.

Switch(config)# atm service-category-limit abr-ubr 45000
Related Command

show atm resource

atm signalling-enable

To enable the signaling/sscop on a port, use the atm signalling-enable interface configuration command. To disable the signaling/sscop, use the no form of this command.

atm signalling-enable
no atm signalling-enable

Syntax Description

This command has no arguments or keywords.

Default

Enabled

Command Mode

Interface configuration

Usage Guidelines

When this command is used on physical or logical ports, the interface must be administratively shut down. This command, when used to disable signaling on a PNNI interface, disables PNNI routing as well as PNNI signaling.

This command does not apply to the ASP interface.

Example

The following example disables signaling on ATM 0/1/2.

Switch(config)# interface atm 0/1/2
Switch(config-if)# shutdown
Switch(config-if)# no atm signalling-enable
Switch(config-if)# no shutdown
Related Command

show atm interface

atm snoop

To set the current port snooping configuration and actual register values for the highest ATM interface, use the atm snoop interface atm interface configuration command.

atm snoop interface atm monitored_port [direction dir]
Syntax Description

monitored_port

Card, subcard, and port number for the ATM interface to be monitored. The port can be any port except the ASP 2/0/0 port or the test port itself.

dir

Is specified as receive or transmit and determines the direction of the cell traffic to monitor. The default is receive.

Default

Receive

Command Mode

Interface configuration. Applies to the Snoop Test Port.

Usage Guidelines

The atm snoop interface atm subcommand applies only if the previously specified port is the highest system port residing on card 4 and subcard 1 (which has been shutdown). If so, this enables it as the Snoop Test Port. Cells transmitted from the Snoop Test Port are copies of cells from a single direction of a monitored port.

When in snoop mode, any prior permanent virtual connections to the Snoop Test Port remain in the down state.

The port number of the test port depends on the card type. Table 2-4 defines the Snoop Test Port number for various interfaces:


Table 2-4: ATM Snoop Port Numbers
Interface Port Number

oc3

4/1/3

oc12

4/1/0

ds3/e3

Not supported

Example

The following example configures the highest port in the snoop mode to monitor port card 1, subcard  0, and port 2 in the transmit direction starting from the configuration mode.

Switch(config)# interface atm 4/1/3
Switch(config-if)# shutdown
Switch(config-if)# atm snoop interface atm 1/0/2 direction transmit
Switch(config-if)# no shutdown
Related Command

show atm snoop

atm soft-vc

To create a soft PVC on the switch, use the atm soft-vc interface configuration command.

atm soft-vc vpi_s vci_s dest-address address vpi_d vci_d [upc upc] [pd pd]
[rx-cttr index] [tx-cttr index] [slow-retry-interval value]
Syntax Description

vpi_s

Source VPI number.

vci_s

Source VCI number.

address

ATM address for the destination port.

vpi_d

Destination VPI number.

vci_d

Destination VCI number.

upc

Usage parameter control, specified as pass | tag | drop, the default is pass. The upc option can be set to tag or drop only when the connection is not the leaf of a point-to-multipoint connection.

pd

Intelligent packet discard option, specified as on | off. The default is off.

rx-cttr

Connection traffic table row index in the received direction. The cttr should be configured before using atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the rx-cttr. The default is 1.

tx-cttr

Connection traffic table row index in the transmitted direction. The cttr should be configured before using atm pvc command. Refer to the atm connection-traffic-table-row command for information on configuring the tx-cttr. The default is 1.

slow-retry-interval

Specifies the slow call retry frequency in seconds. The default is 60 seconds.

Default

See individual commands.

Command Mode

Interface configuration

Usage Guidelines

Obtain the destination port address before configuring a soft PVC by using one of the following commands on the destination switch:

The following list identifies reasons the creation of a soft PVC is unsuccessful:

Example

The following example shows how a user at the destination switch displays the address of the destination port.

    Switch# show atm address

    Switch Address(es):

    47.0091810000000003BE59ED00.0003BE59ED00.00 active

    Soft VC Address(es):

    47.0091.8100.0000.0003.be59.ed00.4000.0c81.0000.00 ATM2/0/0

    47.0091.8100.0000.0003.be59.ed00.4000.0c81.8000.00 ATM3/0/0

    47.0091.8100.0000.0003.be59.ed00.4000.0c81.8010.00 ATM3/0/1

    47.0091.8100.0000.0003.be59.ed00.4000.0c81.8020.00 ATM3/0/2

    47.0091.8100.0000.0003.be59.ed00.4000.0c81.8030.00 ATM3/0/3

    47.0091.8100.0000.0003.be59.ed00.4000.0c82.1000.00 ATM4/1/0

    47.0091.8100.0000.0003.be59.ed00.4000.0c82.1000.05 ATM4/1/0.5

    47.0091.8100.0000.0003.be59.ed00.4000.0c82.1010.00 ATM4/1/1

    47.0091.8100.0000.0003.be59.ed00.4000.0c82.1020.00 ATM4/1/2

    47.0091.8100.0000.0003.be59.ed00.4000.0c82.1030.00 ATM4/1/3

    ILMI Switch Prefix(es):

    47.0091.8100.0000.0003.be59.ed00

    ILMI Configured Interface Prefix(es):

    LECS Address(es):

    At the source switch, create a soft pvc with

    src vpi = 100,

    src vci = 200,

    dest port address = 47.0091.8100.0000.0003.be59.ed00.4000.0c82.1000.0,

    dest vpi = 100

    dest vci = 200

    Switch(config-if)# atm soft-vc 100 200 dest-address 47.0091.8100.0000.0003.be59.ed00.4000.0c82.1000.05 100 200

Related Commands

show atm addresses
show atm interface
show atm status
show atm vc

atm soft-vp

To create a soft PVP on the switch, use the atm soft-vp interface configuration command.

atm soft-vp vpi_s dest-address address vpi_d [upc upc] [rx-cttr index] [tx-cttr index]
[slow-retry-interval value]
Syntax Description

vpi_s

Source VPI number.

address

ATM address for the destination port.

vpi_d

Destination VPI number.

upc

Usage parameter control, specified as pass | tag | drop, the default is pass. The upc option can be set to tag or drop only under the following conditions:

· The ATM interface is not the ASP port (ATM 2/0/0) or a logical port (VP tunnel).

· The connection is not the leaf of a point-to-multipoint connection.

rx-cttr

Connection traffic table row index in the received direction. The cttr should be configured before using atm soft-vp command. Refer to the atm connection-traffic-table-row command for information on configuring the rx-cttr. The default is 1.

slow-retry-interval

Slow call re-try frequency in seconds. The default is 60 seconds.

tx-cttr

Connection traffic table row index in the transmitted direction. The cttr should be configured before using atm soft-vp command. Refer to the atm connection-traffic-table-row command for information on configuring the tx-cttr. The default is 1.

Default

See individual commands.

Command Mode

Interface configuration

Usage Guidelines

Obtain the destination port address before configuring a soft PVP by using one of the following commands.

The following list identifies reasons why the creation of a soft PVP is unsuccessful:

Example

The following example shows how a user at the destination switch displays the address of the destination port.

Switch# show atm interface atm 4/0/1
Interface:  ATM4/0/1
Interface Status: DOWN
Auto-configuration: enabled
Auto-configuration status: waiting for response from peer 
Port-type: External 
Interface-type: UNI, Interface-side: User 
Uni-type: Public, Uni-version: V3.0 
Max-VPI-bits: 8, Max-VCI-bits: 14  
Max-VP: 255, Max-VC: 32768  
Number of PVP: 0  Number of SVP: 0  Number of SoftVP: 0  
Number of PVC: 3  Number of SVC: 0  Number of SoftVC: 0 
Number of logical port (VP-tunnel): 0 
Total number of connections: 3  
Input cells: 0, Output cells: 0  
5 minute input rate: 0 bits/sec, 0 cells/sec
5 minute output rate: 0 bits/sec, 0 cells/sec
ATM Address for Soft VC: 47.0091.8100.0000.0003.be59.ed00.4000.0c82.0010.00

At the source switch, create a soft PVP with the VP of 150, the destination port address of 47.0091.8100.0000.0003.be59.ed00.4000.0c82.0010.00, and the destination vpi of 160.

    Switch(config-if)# atm soft-vp 150 dest-address 47.0091.8100.0000.0003.be59.ed00.4000.0c82.0010.00 160

Related Commands

show atm addresses
show atm interface
show atm status
show atm vp

atm sustained-cell-rate-margin-factor

To change the Sustained Cell Rate Margin Factor (SCRMF), use the atm sustained-cell-rate-margin-factor global configuration command. SCRMF dictates the weight given to peak-cell-rate (PCR) in computing the bandwidth used by VBR connections. To assign the default value to SCRMF, use the no form of this command.

atm sustained-cell-rate-margin-factor s-value
no atm sustained-cell-rate-margin-factor
Syntax Description

s-value

Percent value that dictates the weighting of PCR with respect to sustained-cell-rate (SCR) in computing the bandwidth used in CAC of VBR connections.

Default

1 percent

Command Mode

Global configuration

Usage Guidelines

The following equation is used in CAC of VBR connections to define the bandwidth requested.

bandwidth = (SCRMF * (PCR-SCR))/100 + SCR 
Example

In the following example, the SCRMF of the switch is set to 35 percent.

Switch(config)# atm sustained-cell-rate-margin-factor 35
Related Command

show atm resource

atm svc-frame-discard-on-aal5ie

To install frame discard and to select the criteria used on SVCs, use the atm  svc-frame-discard-on-aal5ie command.

atm svc-frame-discard-on-aal5ie
no atm svc-frame-discard-on-aal5ie

Syntax Description

This command has no arguments or keywords.

Default

Install packet discard based on the presence of the AAL5 IE in the SETUP message.

Command Mode

Global configuration

Usage Guidelines

The common term "frame discard" is referred to as "packet discard" in the LS1010 VC environment.

This command changes information used by the switch when determining whether or not to install frame discard on SVCs. UNI 4.0 signaling allows explicit signaling of frame discard. Prior to UNI  4.0, the presence of the AAL5 IE was used to determine whether or not to install frame discard. If the AAL5 IE is present, frame discard is installed.

Use the atm svc-frame-discard-on-aal5ie command to install frame discard if the AAL5 IE is present. Use the no atm svc-frame-discard-on-aal5ie command if frame discard is to be installed on UNI 4 or PNNI interfaces, and only if explicitly requested by the SETUP and CONNECT messages.

The installation of frame discard is controlled by the signalled messages. Even if the configuration specifies using AAL5 IE, if the UNI 4.0 signaling element controlling frame discard is present when the SETUP or CONNECT transits a UNI 4 or PNNI interface, and the AAL5 IE is not present, frame discard is controlled by the TM Options ID.

The signaling element is the Traffic Management Options ID in the ATM Traffic Descriptor Information Element in the SETUP or CONNECT message.

Example

In the following example, the switch behavior is set to not use the AAL5 IE to dictate frame discard.

Switch(config)# no atm svc-frame-discard-on-aal5ie

atm svc-upc-intent

To change the intended Usage Parameter Control (UPC) mode to use on the cell-flow received into the switch-fabric for SVCs on an interface, use the atm svc-upc-intent interface configuration command. Any change in this parameter is applied to SVCs subsequently established on the interface. To assign the default value to the parameter, use the no form of this command.

atm svc-upc-intent [pass | tag | drop]
no atm svc-upc-intent

Syntax Description

pass

Cells received on the interface are passed to the switching fabric with no change, regardless of their conformance to the traffic contract.

tag

Cells received on the interface violating the traffic contract have their CLP bit set prior to entering the switching fabric.

drop

Cells received on the interface violating the traffic contract are dropped.

Command Mode

Interface configuration

Default

pass

Usage Guidelines

This configuration parameter determines the UPC to use for SVCs and for the destination leg of soft VC and VP. If policing is desired, it should be applied once for traffic entering a network.

This command does not apply to the ASP 2/0/0 interface or logical interfaces.

Example

In the following example, the intended UPC for SVCs on an interface is set to tagging.

Switch(config-if)# atm svc-upc-intent tag
Related Command

show atm interface

atm template-alias

To configure an ATM address template alias, use the atm template-alias global configuration command. To delete the specified alias, use the no form of this command.

atm template-alias name template
no atm template-alias
Syntax Description

name

Name for the template alias.

template

ATM address template, which can be a single ATM address that matches itself or that contains wildcards and/or prefixes or suffixes, allowing a single template to match many addresses. The symbols used for wildcards, prefixes, and suffixes are as follows:

· Asterisk (*) to match any single 4-bit nibble in the address.

· Ellipsis (...) to match any number of leading or trailing 8-bit hexadecimal digits in the address.

· Asterisk (*) to match any single binary digit in a 4-bit nibble in the address, where the 4  binary bits are enclosed within parentheses.

Default

No alias list is defined.

Command Mode

Global configuration

Usage Guidelines

Address templates are pattern forms that match one or more ATM addresses. They can be simple, single ATM addresses matching themselves or containing wildcards, prefixes, and suffixes, allowing a single template to match many addresses.

The simplest address template matches a single address, as shown in this example:

Switch(config)# 47.0005.1234.5678.9abc.def0.00

Wildcard digits, which can match any value, are indicated with asterisks (*). The following template matches the above address and any other 12-byte address that starts with 47.0005.1234.5678:

Switch(config)# 47.0005.1234.5678.****.****.**

The following template matches any address of any length and begins with the prefix 47.0005.1234.5678:

Switch(config)# 47.0005.1234.5678...

In other cases, matching a suffix of the address is also important, such as when matching system IDs. The following template matches any address ending with the suffix 0000.0c01.2345.00:

Switch(config)# ...0000.0c01.2345.00

You might want to match addresses on a single-bit granularity, rather than half-byte (4-bit or nibble) granularity.

This pattern matching is supported by allowing the hex digits that represent four bits to be replaced by groups of four binary bits, represented by the numbers 0 and 1. These four binary digits are enclosed within parentheses. The following template matches any address that starts with 47.0005 followed by the binary bits 10. The final two binary bits in the nibble can be either 0 or 1 and are represented with asterisks.

Switch(config)# 47.0005.(10**)...

Use this command to define aliases for commonly referenced address templates. The use of these aliases reduces the chances for typographical error in the creation of ATM filter sets.

Example

The following example shows setting ATM template aliases.

Switch(config)# atm template-alias atm_addr1 47.1328...
Switch(config)# atm template-alias atm_addr2 47.0012.(10**)...
Switch(config)# atm template-alias atm_addr3 ...1234.(01*1)
Related Commands

show running-config
write terminal

atm uni

To configure an ATM User-Network Interface (UNI) on the specified physical or logical port, use the atm uni interface configuration command.

atm uni [side side] [version ver] [type type]
Syntax Description

side

Specified as user | network. The default is network.

ver

Specified as 3.0, 3.1, or 4.0

type

Specified as private | public. The default is private.

Default

See individual commands.

Command Mode

Interface configuration

Usage Guidelines

Before using this command, the interface must be administratively shut down (see the shutdown command) and ILMI auto-configuration mode must be disabled (see the atm auto-configuration command).

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

Examples

Configure a network-side private ATM UNI with maxvc = 1000, on card 3, subcard 1, and port 1.

Switch# interface atm 3/1/1
Switch(config-if)# shutdown
Switch(config-if)# no atm auto-configuration
Switch(config-if)# atm uni
Switch(config-if)# atm maxvc-number 1000
Switch(config-if)# no shutdown

Configure a user-side public ATM UNI on card 1, subcard 1, and port 3.

Switch# interface atm 1/1/3
Switch(config-if)# shutdown
Switch(config-if)# no atm auto-configuration
Switch(config-if)# atm uni type public side user
Switch(config-if)# no shutdown

Related Commands

atm auto-configuration
atm iisp
atm nni
show atm interface
shutdown

atm-vc (map-list)

To define an ATM map statement for a PVC, use the atm-vc map-list configuration command in conjunction with the map-list global configuration command. The no form of this command removes the address.

protocol protocol-address atm-vc vci [class class-name] [broadcast] [aal5mux]
no protocol protocol-address atm-vc
vci [class class-name] [broadcast] [aal5mux]
Syntax Description

protocol

Is the keyword ip.

protocol-address

Destination address being mapped to this PVC.

vci

31 < vci < 2**14 - 1 (with default max-VCI bits that is 14).

class class-name

(Optional) Name of a table that contains encapsulation-specific parameters. Such a table can be shared between maps that have the same encapsulation.

broadcast

(Optional) Indicates this map entry is to be used when the corresponding protocol sends broadcast packets to the interface.

aal5mux

(Optional) Use aal5mux encapsulation. Default is snap.

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 ATM includes two map statements for protocol addresses being mapped.

Switch(config)# map-list atm 1/0/0
Switch(config-map-list)# map-list atm
ip 172.21.168.112 atm-vc 99
Related Command

map-list


hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1998 © Cisco Systems Inc.