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

Table of Contents

M Commands for the LightStream  1010 ATM Switch

M Commands for the LightStream  1010 ATM Switch

map-class

To enter map-class configuration mode to define parameters that are to be used in specifying a request for an ATM SVC (the SETUP message), use the map-class global configuration command. The no form of this command deletes this class.

map-class encapsulation class-name
no map-class encapsulation class-name

Syntax Description

encapsulation

Encapsulation type is ATM.

class-name

User-assigned name of the traffic parameters table.

Default

No traffic parameters are defined.

Command Mode

Global configuration

Usage Guidelines

If the map class identified by class-name does not already exist, the switch creates a new one. In either case, this command specifies the map class to which subsequent encapsulation-specific commands apply. Configuration of a map class is allowed only if the subsystem corresponding to the encapsulation is linked.

It is up to the media-specific routing that uses a static map to ensure that the referenced class exists if parameters are required.

Most parameters specified through a map-class are used to dictate the contents of the ATM Traffic Descriptor Information Element (ATD IE) present in a SETUP message used to initiate an SVC (note that this IE was called the User Cell Rate IE in UNI 3.0). These parameters are as follows:

forward-peak-cell-rate-clp0

forward-peak-cell-rate-clp1

backward-peak-cell-rate-clp0

backward-peak-cell-rate-clp1

forward-sustainable-cell-rate-clp0

forward-sustainable-cell-rate-clp1

backward-sustainable-cell-rate-clp0

backward-sustainable-cell-rate-clp1

forward-max-burst-size-clp0

forward-max-burst-size-clp1

backward-max-burst-size-clp0

backward-max-burst-size-clp1


Note The 1-parameters specify the traffic characteristics of the aggregate of Cell Loss Priority 0 (CLP-0) and CLP-1 cells; the 0-parameters are CLP-0 only.

When possible, Best Effort is signalled. In UNI 3, a Best Effort Indication is included in the ATD IE only if the contents of the IE consist of forward and backward Peak Cell Rate for CLP 0+1 (and the Best Effort Indication). Therefore, if any of the above parameters other than forward-peak-cell-rate-clp1 and backward-peak-cell-rate-clp1 are specified in the map-class, Best Effort cannot be signalled.

It is important that Best Effort is signalled, because this causes a switch to interpret the SETUP as a request for an Unspecified Bit Rate (UBR) connection. UBR requests do not cause bandwidth to be reserved per-connection.

If Best Effort cannot be signalled (one of the other parameters is specified in map-class), then this causes a switch to interpret the SETUP as a request for Non-Real Time Variable Bit Rate (VBR-NRT) service.

All combinations of parameters are allowed in the definition of map-class. The following recommendations can help to specify a correct set of parameters:

If default traffic parameters are used in the initiation of an SVC, a Best Effort ATD IE is used. The forward and backward peak-cell-rate0+1 values are 24-bits set to "1" (0xffffff). This is a unique value used to indicate that default shaping parameters can be applied.

Example

The following example establishes traffic parameters for map-class atmclass1.

Switch# map-class atmlist
ip 172.21.180.121 atm-nsap 12.3456.7890.abcd.0000.00 broadcast class atmclass1
map-class atm atmclass1
atm forward-peak-cell-rate-clp0 8000
atm backward-peak-cell-rate-clp0 8000
interface atm 2/0/0
map-group atmlist
Related Command

show atm map

map-group

To associate an ATM map list to an interface or subinterface for either a PVC or SVC, use the map-group interface configuration command. The no form of this command removes the reference to the map list.

map-group name
no map-group name

Syntax Description

name

Name of the map list identified by the map-list command.

Default

No ATM map lists are associated.

Command Mode

Interface configuration

Usage Guidelines

More than one map-group can be configured for an interface. This command only applies to interfaces on the ASP card (2/0/0 in the LightStream 1010 ATM switch environment or 13/0/0 in the Catalyst 5500 environment) and to terminating connections.

Example

In the following example, the map list named ATM is associated with the ATM interface.

Switch(config)# interface atm 2/0/0
Switch(config-if)# map-group atm
Related Commands

map-class
map-list

map-list

To define an ATM map statement for either a PVC or SVC, use the map-list global configuration command. The no form of this command deletes this list and all associated map statements.

map-list name
no map-list name

Syntax Description

name

Name of the map list.

Default

No map statements are defined.

Command Mode

Global configuration

Usage Guidelines

This command only applies to interfaces on the ASP card (2/0/0 in the LightStream 1010 ATM switch environment or 13/0/0 in the Catalyst 5500 environment) and to terminating connections. To allow the switch to propagate routing updates and ARP requests, a static map that maps the protocol address and the ATM address of the next-hop ATM station must be configured. The switch supports a mapping scheme that identifies the ATM address of remote hosts or switches. This address can be specified either as a virtual channel identifier descriptor (vci) for a PVC or an NSAP address for an SVC.

The map-list command specifies the map list to which the subsequent map-list configuration commands apply. These map-list configuration commands identify destination addresses. One map list can contain multiple map entries. A map list can be referenced by more than one interface or subinterface.

Examples

In the following example, to configure ATM static maps for a PVC, a map list named ATM is followed by one map statement for protocol addresses being mapped.

Switch# map-list atm
ip 172.21.168.112 atm-vc 1 broadcast

In the following example for an SVC, a map list named ATM includes two map statements for protocol addresses being mapped.

Switch# map-list atm
ip 172.21.97.165 atm-nsap BC.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.13
ip 172.21.97.166 atm-nsap BC.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12
Related Commands

map-class
map-group
show atm map

max-admin-weight-percentage

To configure the maximum administrative weight percentage used to determine if an alternate route is acceptable, use the max-admin-weight-percentage ATM router PNNI configuration command. To remove the constraint on administrative weight for alternate routes, use the no form of this command.

max-admin-weight-percentage percentage
no max-admin-weight-percentage

Syntax Description

percentage

Specifies the maximum acceptable administrative weight for alternate routes as a percentage of the least administrative weight of any route to the destination.

Default

Infinity (no constraint on administrative weight for alternate routes).

Command Mode

ATM router PNNI configuration

Usage Guidelines

This command increases network efficiency by preventing alternate routes that use too many network resources from being specified. The command provides a generalized form of a hop count limit.

This command only takes effect when background route computation is enabled.

The maximum acceptable administrative weight is equal to the specified percentage of the least administrative weight of any route to the destination (from the background routing tables). For example, if the least administrative weight to the destination is 5040 and the percentage is 300, the maximum acceptable administrative weight for the call is 5040x300/100 or 15120.

For more information, refer to the LightStream 1010 ATM Switch Software Configuration Guide.

Example

The following script shows how to configure the max-admin-weight-percentage to 300 percent using the max-admin-weight-percentage ATM router PNNI configuration command.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# max-admin-weight-percentage 300
Related Commands

administrative-weight
atm pnni admin-weight
show atm pnni background routes
show atm pnni node

modem answer-timeout

To set the amount of time that the switch waits for CTS after raising DTR in response to RING, use the modem answer-timeout line configuration command. Use the no form of this command to revert the switch to the default value.

modem answer-timeout seconds
no modem answer-timeout

Syntax Description

seconds

Specifies the timeout interval in seconds.

Default

15  seconds

Command Mode

Line configuration

Usage Guidelines

This command applies to the auxiliary port only. It is useful for modems that take a long time to synchronize to the appropriate line speed.

Example

The following example sets the timeout interval to 20 seconds.

Switch(config)# line aux 0
Switch(config-line)# modem answer-timeout 20
Related Commands

modem callin
modem inout

modem callin

To support dial-in modems that use DTR to control the off-hook status of the modem, use the modem callin line configuration command. In response to RING, the modem raises the DTR signal, which answers the modem. At the end of the session, the switch lowers DTR, which disconnects the modem. The no form of this command disables this feature.

modem callin
no modem callin

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command applies to the auxiliary port only.

Example

The following example causes the modem connected to the switch to raise DTR in response to RING.

Switch(config)# line aux 0
Switch(config-line)# modem callin
Related Commands

logout
modem inout

modem callout

To configure a line for reverse connections, use the modem callout line configuration command. The no form of this command disables this feature.

modem callout
no modem callout

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command applies to the auxiliary port only and supports ports connected to computers that are designed to be connected to modems.

Example

The following example configures the line for reverse connections.

Switch(config)# line aux 0
Switch(config-line)# modem callout
Related Command

modem inout

modem cts-required

To configure a line to require a CTS signal, use the modem cts-required line configuration command. Use the no form of this command to disable this feature.

modem cts-required
no modem cts-required

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command applies to the auxiliary port only. It supports lines that either the user or the network can activate. It is useful for closing connections from a user's terminal when the terminal is turned off and for preventing disabled printers and other devices in a rotary group from being considered.

Example

The following example configures a line to require a CTS signal.

Switch(config)# line aux 0
Switch(config-line)# modem cts-required
Related Command

rsh

modem dtr-active

To configure a line to leave DTR low unless the line has an active incoming connection or an EXEC process, use the modem dtr-active line configuration command. The no form of this command disables this feature.

modem dtr-active
no modem dtr-active

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command applies to the auxiliary port only. It can be useful if the line is connected to an external device (for example, a timesharing system) that needs to know whether a line is in active use. The modem dtr-active command is similar to the no modem line configuration command.

Example

The following example illustrates how to configure the auxiliary port for low DTR.

Switch(config)# line aux 0
Switch(config-line)# modem dtr-active

modem inout

To configure a line for both incoming and outgoing calls, use the modem inout line configuration command. The no form of this command disables this feature.

modem inout
no modem inout

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command applies to the auxiliary port only.

Example

The following example illustrates how to configure the auxiliary port for both incoming and outgoing calls.

Switch(config)# line aux 0
Switch(config-line)# modem in-out
Related Command

password

monitor

To copy debug output to the current terminal line, use the monitor line configuration command.

monitor
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Mode

Line configuration

mtu

To adjust the maximum packet size or maximum transmission unit (MTU) size, use the mtu interface configuration command. Use the no form of this command to restore the MTU value to its original default value.

mtu bytes
no mtu

Syntax Description

bytes

Desired size in bytes.

Defaults

Table 12-1 lists default MTU values according to media type.


Table 12-1: Default Media MTU Values
Media Type Default MTU

Ethernet

1500

ATM

4470

Command Mode

Interface configuration

Usage Guidelines

This command only applies to the ASP interface card: Ethernet 2/0/0 or ATM 2/0/0 (or 13/0/0 in the Catalyst 5500). Each interface has a default maximum packet size or maximum transmission unit (MTU) size. This number generally defaults to the largest size possible for that type interface.


Note Changing the MTU value with the mtu interface configuration command can affect values for the protocol-specific versions of the command (ip  mtu for example). If the values specified with the ip  mtu interface configuration command is the same as the value specified with the mtu interface configuration command and you change the value for the mtu interface configuration command, the ip  mtu value automatically matches the new mtu value. However, changing the values for the ip  mtu configuration commands has no effect on the value for the mtu command.
Example

The following example specifies an MTU of 4470 bytes.

Switch(config)# interface atm 2/0/0
Switch(config-if)# mtu 4470
Related Command

ip mtu

multilink

To configure a PPP multilink, use the multilink global configuration command.

multilink [virtual-template number]
Syntax Description

virtual-template

Specifies the virtual-template interface.

number

Specifies the virtual-template number.

Default

This command has no default setting.

Command Mode

Global configuration


hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1998 © Cisco Systems Inc.