cc/td/doc/product/atm/c8540/12_0/13_19
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

M Commands
mac-address
map-class
map-group
map-list
max-admin-weight-percentage
max-records
min-age
mtu
multiring

M Commands


The commands shown in this chapter apply to the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. Where an entire command or certain attributes of a command have values specific to a particular switch or switch router, an exception is indicated by the following callouts:

Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.

mac-address

To configure the MAC address associated with an LEC, use the mac-address LANE configuration server database command. To remove the MAC address, use the no form of this command.

mac-address ieee-address

Syntax Description

ieee-address

48-bit IEEE MAC address written as a dotted triplet of four-digit hexadecimal numbers.

Defaults

No MAC layer address is set.

Command Modes

LANE configuration server database

Command History

Release  Modification 

12.0.1

New command

Examples

The following example shows configuring the MAC address for the LEC where xx.xxxx is an appropriate second half of the MAC address to use.

Switch# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)# lane database
Switch(lane-config-database)# mac-address 5000.5axx.xxxx

map-class

To enter map-class configuration mode to define parameters that you will use in specifying a request for an SVC (the SETUP message), use the map-class global configuration command. To delete this class, use the no form of this command.

map-class {atm | dialer | frame-relay} class-name
no map-class {atm | dialer | frame-relay} class-name

Syntax Description

atm

Specifies the ATM map class for an SVC.

dialer

Specifies a class of shared configuration parameters associated with the dialer map for an SVC.

frame-relay

Specifies QoS values for an SVC.

class-name

User-assigned name of the traffic parameters table.

Defaults

No traffic parameters are defined.

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

If the map class identified by class-name does not already exist, the switch router 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 ATD IE present in a SETUP message used to initiate an SVC. These parameters are as follows:

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 a 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 the map class), then this causes a switch to interpret the SETUP as a request for 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.

Examples

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

Switch# configure terminal
Switch(config)# map-class atm atmclass1
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
main-atm 0
map-group atm atmlist1

Related Commands

Command  Description 

show atm map

Displays the list of all configured ATM static maps to remote hosts on an ATM network.

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. To remove the reference to the map list, use the
no form of this command.

map-group name
no map-group name

Syntax Description

name

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

Defaults

No ATM map lists are associated.

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

More than one map group can be configured for an interface. This command only applies to interfaces on the route processor card and to terminating connections.

Examples

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

Switch# configure terminal
Switch(config)# interface atm 0
Switch(config-if)# map-group atm

Related Commands

Command  Description 

main-cpu (Catalyst 8540 MSR)

 

map-list

Defines an ATM map statement for either a PVC or SVC.

map-list

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

map-list name
no map-list name

Syntax Description

name

Name of the map list.

Defaults

No map statements are defined.

Command Modes

Global configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

This command only applies to interfaces on the route processor card and to terminating connections.
To allow the switch router 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 router supports a mapping scheme that identifies the ATM address of remote hosts or switch routers. This address can be specified either as a VCI descriptor 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
Switch(config-map-list)# 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
Switch(config-map-list)# ip 172.21.97.165 atm-nsap BC.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.13
Switch(config-map-list)# ip 172.21.97.166 atm-nsap BC.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12

Related Commands

Command  Description 

main-cpu (Catalyst 8540 MSR)

 

map-group

Associates an ATM map list to an interface or subinterface for either a PVC or SVC.

show atm map

Displays the list of all configured ATM static maps to remote hosts on an ATM network.

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.

Defaults

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

Command Modes

ATM router PNNI configuration

Command History

Release  Modification 

11.1(4)

New command

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 5040 x 300/100 or 15120.

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

Examples

The following script shows how to configure the maximum administrative 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

Command  Description 

administrative-weight

Configures the mode of default administrative weight assignment for PNNI interfaces.

atm pnni admin-weight

Specifies the administrative weight of the ATM PNNI interface.

show atm pnni background routes

Displays the precalculated background route table to other PNNI nodes.

show atm pnni local-node

Displays information about a PNNI logical node running on the switch router.

Command History

Release  Modification 

11.1(4)

New command

Related Commands

None

max-records

To configure the maximum number of records to be collected for a particular signalling diagnostics filter table entry, use the max-records ATM signalling diagnostics configuration command. To return the maximum records to the default, use the no form of this command.

max-records max-num-records
no max-records

Syntax Description

max-num-records

Specifies the number of records to be collected.

Defaults

20

Command Modes

ATM signalling diagnostics configuration

Command History

Release  Modification 

11.2(8.0.1)

New command

Usage Guidelines

This value denotes the number of call failure records to be collected and stored. When the maximum value is reached, the older records are deleted, making way for the newly created records.

The collected records are overwritten when the max-records value is reached. If this field is set to -1, the records are not overwritten. Setting this field to -1 requires increased memory consumption for call failure records storage, and can lead to shortages of available system memory.

Examples

The following example shows setting the maximum number of records to 18.

Switch(config)# max-records 20

Command History

Release  Modification 

12.0(3c)W5(9)

New command


Note   

Switch# configure terminal

min-age

To configure the value of the minimum age of the VC for on-release or periodic collection of accounting records, use the min-age ATM accounting file subcommand. To return the min-age value to the default, use the no form of this command.

min-age seconds
no min-age

Syntax Description

seconds

Specifies the number of seconds.

Defaults

3600 seconds

Command Modes

ATM accounting file

Command History

Release  Modification 

12.0.1

New command

Usage Guidelines

None

Examples

None

Related Commands

Command  Description 

atm accounting file

Used to employ accounting file configuration mode and to enable an ATM accounting file.

collection-modes

Used to initialize the collection mode and specifies at what time accounting data is recorded in the accounting file.

failed-attempts

Configures the writing of records for initial connection attempts.

mtu

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

mtu bytes
no mtu

Syntax Description

bytes

Specifies the 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

ARM

 

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

Each interface has a default maximum packet size or 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 value specified with the ip mtu interface configuration command is the same as the value specified with the mtu command and you change the value for the mtu command, the ip mtu value automatically matches the new mtu value. However, changing the value for the ip mtu command has no effect on the value for the mtu command.

Examples

The following example specifies an MTU of 4470 bytes.

Switch# configure terminal
Switch(config)# interface atm 0
Switch(config-if)# mtu 4470

Related Commands

Command  Description 

ip mtu

Sets the MTU size of IP packets sent on an interface.

multiring

To enable collection and use of RIF information on a subinterface, use the multiring interface configuration command. To disable the use of RIF information, use the no form of this command.

multiring ip [all-routes | spanning]
no multiring ip [all-routes | spanning]

Syntax Description

ip

Protocol type for which to enable multiring.

all-routes

Uses all-routes explorers.

spanning

Uses spanning-tree explorers.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release  Modification 

11.1(4)

New command

Usage Guidelines

In source-route bridged or Token Ring switched networks, only packets with RIF are forwarded by intermediate source-route bridges. To ensure that IP datagrams are transmitted across a Token Ring switch or source-route bridge to and from an ATM switch router, use the multiring command.

When multiring is enabled, the Token Ring LEC strips the RIF information and caches it in its RIF table for incoming IP/ARP packets. It adds a RIF for subsequent IP/ARP response packets to be sent back across the network. Use the show rif command to display the RIF table entries. To configure static RIF entries, use the rif command.

Examples

The following example shows how to configure a subinterface with an IP address and Token Ring LANE LEC, and then enable multiring.

Switch# configure terminal
Switch(config)# interface atm 0.1
Switch(config-subif)# ip address 1.1.1.2 255.255.255.0
Switch(config-subif)# lane client tokenring cisco
Switch(config-subif)# multiring ip

Related Commands

Command  Description 

rif

Used to enter static source-route information into the RIF cache.

show rif

Displays the current contents of the RIF cache.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Aug 12 17:28:18 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.