|
|
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:
 |
Note Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter. |
|
Note Commands that no longer function as expected in ATM environments have also been removed from this chapter. |
Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.
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
12.0.1 New command
Release
Modification
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
To switch to the main-cpu submode of the redundancy mode, use the main-cpu redundancy command.
main-cpuSyntax Description
This command has no arguments or keywords.
Command Modes
Redundancy
Command History
12.0(3c)W5(9) New command
Release
Modification
Usage Guidelines
After you enter the main-cpu submode, you can use the auto-sync command to synchronize the configuration between the primary and secondary route processors based on the primary configuration. In addition, you can use all of the redundancy commands that are applicable to the main CPU.
Examples
The following example shows how to switch to the main-cpu submode of the redundancy mode.
Switch(config)#redundancySwitch(config-r)#main-cpuSwitch(config-r-mc)#
Related Commands
Used to synchronize the configuration between the primary and secondary route processors based on the primary configuration.
Command
Description
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
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
11.1(4) New command
Release
Modification
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:
|
Note The 1-parameters specify the traffic characteristics of the aggregate of 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 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
Displays the list of all configured ATM static maps to remote hosts on an ATM network.
Command
Description
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.
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
11.1(4) New command
Release
Modification
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
Used to switch to the main-cpu submode of the redundancy mode. Defines an ATM map statement for either a PVC or SVC.
Command
Description
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
Syntax Description
name Name of the map list.
Defaults
No map statements are defined.
Command Modes
Global configuration
Command History
11.1(4) New command
Release
Modification
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
Used to switch to the main-cpu submode of the redundancy mode. Associates an ATM map list to an interface or subinterface for either a PVC or SVC. Displays the list of all configured ATM static maps to remote hosts on an ATM network.
Command
Description
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
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
11.1(4) New command
Release
Modification
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
Configures the mode of default administrative weight assignment for PNNI interfaces. Specifies the administrative weight of the ATM PNNI interface. Displays the precalculated background route table to other PNNI nodes. Displays information about a PNNI logical node running on the switch router.
Command
Description
To specify the maximum network diameter, use the max-diameter command. To delete the maximum network diameter, use the no form of this command.
max-diameter diameter
Syntax Description
diameter The greatest distance between two nodes that are participants in protocol.
The units of measurement are hops.
Defaults
None
Command Modes
NCDP
Command History
11.1(4) New command
Release
Modification
Usage Guidelines
Specifies the maximum network diameter.
Related Commands
None
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
Syntax Description
max-num-records Specifies the number of records to be collected.
Defaults
20
Command Modes
ATM signalling diagnostics configuration
Command History
11.2(8.0.1) New command
Release
Modification
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
To configure and transmit the MDL messages, use the mdl interface configuration command.
To disable the transmission of MDL messages, use the no form of this command.
Syntax Description
transmit path Enables transmission of the MDL path message. transmit idle-signal Enables transmission of the MDL idle signal message. transmit test-signal Enables transmission of the MDL test signal message. string eic string Specifies the Equipment Identification Code. Can be up to 10 characters. string lic string Specifies the Location Identification Code. Can be up to 11 characters. string fic string Specifies the Frame Identification Code. Can be up to 10 characters string unit string Specifies the Unit Identification Code. Can be up to six characters. string pfi string Specifies the Facility Identification Code sent in the MDL path message. Can be up to 38 characters. string port string Specifies the port number string sent in the MDL idle signal message. Can be up to 38 characters. string generator string Specifies the generator number string sent in the MDL test signal message. Can be up to 38 characters.
Defaults
No MDL message is configured.
Command Modes
Interface configuration
Command History
12.0(3c)W5(9) New command
Release
Modification
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3.
Use the show controllers t3 command to display MDL information (received strings).
MDL information is displayed only when framing is set to C-bit.
|
Note MDL is supported only when the CDS3 framing is C-bit parity. |
Examples
The following examples show several of the mdl commands for the Frame Relay port adapter in slot 9.
Switch# configure terminalSwitch(config)#controller t3 4/0/0Switch(config-controller)#mdl string eic Router ASwitch(config-controller)#mdl string lic Test NetworkSwitch(config-controller)#mdl string fic Building BSwitch(config-controller)#mdl string unit ABC
Related Commands
Displays information about a physical port device, and specifies a channelized DS3 (CDS3) interface.
Command
Description
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
Syntax Description
seconds Specifies the number of seconds.
Defaults
3600 seconds
Command Modes
ATM accounting file
Command History
12.0.1 New command
Release
Modification
Usage Guidelines
None
Examples
None
Related Commands
Used to employ accounting file configuration mode and to enable an ATM accounting file. Used to initialize the collection mode and specifies at what time accounting data is recorded in the accounting file. Configures the writing of records for initial connection attempts.
Command
Description
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.
Syntax Description
bytes Specifies the desired size, in bytes.
Defaults
Table 12-1 lists default MTU values according to media type.
| Media Type | Default MTU |
|---|---|
Ethernet | 1500 |
ATM | 4470 |
ARM |
|
Command Modes
Interface configuration
Command History
11.1(4) New command
Release
Modification
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
Sets the MTU size of IP packets sent on an interface.
Command
Description
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]
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
11.1(4) New command
Release
Modification
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
Used to enter static source-route information into the RIF cache. Displays the current contents of the RIF cache.
Command
Description
Posted: Wed Sep 6 15:48:56 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.