ATM Switch Router Command Reference, 12.0(1a)W5(7b)
N Commands for the ATM Switch
Download this chapter
N Commands for the ATM SwitchN Commands for the ATM Switch
give_us_feedback

Table of Contents

N Commands
 name
 name-conn
 name local-seg-id
 name server-atm-address
 network-clock-select
 node
 nodal-representation

N Commands

Note      Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter. Refer to Appendix D, "Removed and Changed Commands," of this command reference for a list of removed commands.

name

To configure a name for a PNNI node, use the name node-level subcommand. To return to the default value, use the no form of this command.

name name
no name
Syntax Description

name

Specify the ASCII name for the PNNI node.

Default

The value assigned by the hostname command.

Command Mode

PNNI node command

Usage Guidelines

The PNNI node name is distributed to all other nodes via PNNI flooding. This allows all PNNI nodes to use this node name in the following PNNI show commands:

This command only applies to PNNI nodes.

For more information, refer to the Catalyst 8540 MSR Software Configuration Guide.

Example

The following example configures the node name to be eng_1.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# name eng_1
Related Commands

hostname
show atm pnni local-node

name-conn

Note      This command or some of its parameters might not function as expected.

name local-seg-id

To specify or replace the ring number of the emulated LAN in the configuration server's configuration database, use the name local-seg-id database configuration command. To remove the ring number from the database, use the no form of this command.

name elan-name local-seg-id seg-num
no name elan-name local-seg-id seg-num
Syntax Description

elan-name

Name of the emulated LAN. The maximum length of the name is 32 characters.

seg-num

Segment number to be assigned to the emulated LAN. The number ranges from 1 to 4095.

Default

No emulated LAN name or segment number is provided.

Command Mode

Database configuration

Usage Guidelines

This command is used for Token Ring LANE.

Refer to the lane database command for instructions on how to enter database configuration mode.

The same LANE ring number cannot be assigned to more than one emulated LAN.

The no form of this command deletes the relationships.

Example

The following example specifies a ring number of 1024 for the emulated LAN red.

Switch(lane-config-database)# name red local-seg-id 1024
Related Commands

default-name
lane database

name server-atm-address

To specify or replace the ATM address of the LANE server for the emulated LAN in the configuration servers configuration database, use the name server-atm-address global database configuration command. To remove it from the database, use the no form of this command.

name elan-name server-atm-address atm-address [restricted | un-restricted] [index n]
 no name elan-name server-atm-address atm-address [restricted | un-restricted] [index n]
Syntax Description

elan-name

Name of the emulated LAN. Maximum length is 32 characters.

atm-address

LANE server's ATM address.

restricted | un-restricted

Membership in the named emulated LAN is restricted to the LANE clients explicitly defined to the emulated LAN in the configuration server's database.

index

Priority number. When specifying multiple LANE servers for fault tolerance, you can specify a priority for each server. The highest priority is 0.

Defaults

No emulated LAN name or server ATM address is provided.

Command Mode

Database configuration

Usage Guidelines

Use the lane database command to enter database configuration mode.

Emulated LAN names must be unique within one named LANE configuration database.

Specifying an existing emulated LAN name with a new LANE server ATM address adds the LANE server ATM address for that emulated LAN for redundant server operation or simple LANE service replication. This command can be entered multiple times.

The no form of this command deletes the relationships.

Example

The following example configures the example3 database with two restricted and one unrestricted emulated LANs. The clients that can be assigned to the eng and mkt emulated LANs are specified using the client-atm-address command. All other clients are assigned to the man emulated LAN.

Switch(lane-config-database)# lane database example3
name eng server-atm-address 39.000001415555121101020304.0800.200c.1001.02 restricted
name man server-atm-address 39.000001415555121101020304.0800.200c.1001.01
name mkt server-atm-address 39.000001415555121101020304.0800.200c.4001.01 restricted
client-atm-address 39.000001415555121101020304.0800.200c.1000.02 name eng
client-atm-address 39.0000001415555121101020304.0800.200c.2000.02 name eng
client-atm-address 39.000001415555121101020304.0800.200c.3000.02 name mkt
client-atm-address 39.000001415555121101020304.0800.200c.4000.01 name mkt
default-name man
Related Commands

client-atm-address name
delay
lane database

network-clock-select

To allow the recovered clock to specify a particular port to provide network clocking, use the network-clock-select global configuration command. To disable this feature, use the no form of this command.

network-clock-select priority {{{atm | cbr} card/subcard/port} | system | BITS {E1 | T1}} revertive
no network-clock-select priority {{{atm | cbr} card/subcard/port} | system | BITS {E1 | T1}} revertive
Syntax Description

priority

Specifies the priority between 1 and 4.

atm

ATM interface.

cbr

Constant bit rate.

card/subcard/port

Specifies the card, subcard, and port number of the ATM interface or CBR.

system

The free running clock provided by the route processor, which is the source for all network derived ports.

BITS

Selects a BITS port as the network clock source.

E1

Specifies an E1 interface.

T1

Specifies a T1 interface.

revertive

Causes the clock to revert to a higher priority clock if the current clock goes off-line.

Default

System clock

Command Mode

Global configuration

Usage Guidelines

This command applies to all interfaces except older versions of the DS3 interface. The system clock can be selected at any priority.

Example

The following example shows how to configure ATM 3/0/1 as a network clock source of priority 2 and configure ATM 0/1/0 to use a network-derived clock source.

Switch# configure terminal
Switch(config)# network-clock-select 2 atm 3/0/1
Switch(config)# interface atm 0/1/0
Switch(config)# clock source network-derived

The following example shows how to configure ATM 0/0/0 as a network clock source of priority 1 and revert to a higher priority clock.

Switch# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)# network-clock-select 1 atm 0/0/0
Switch(config)# network-clock-select revertive
Caution

Configure a network clock-source before a port uses it as the clock source. Otherwise, by default, the system clock (route processor resident local oscillator) is used and the transmit clock is configured as network-derived.
Related Commands

clock source
show network-clocks

node

To create, delete, enable, or disable PNNI nodes running on this switch and to specify or change the level of a node, use the node ATM router PNNI configuration command. PNNI node configuration mode is started when this command is entered. To remove a previously set node index, use the no form of this command.

node node_index level level_indicator [lowest] [peer-group-identifier] [pg_id | default] [enable | disable]
no node node_index
Syntax Description

node_index

Specifies the local node index, in the range of 1 to 8, used to identify a PNNI node.

level_indicator

Specifies the PNNI level (position in the PNNI hierarchy), in the range of 1 to 104, at which the node exists.

pg_id

Specifies a non-default peer group identifier for the peer group to which the node belongs. Enter the default keyword in place of an identifier to return from a non-default value to the default peer group identifier.

lowest

Indicates that the node to be created is a lowest-level node (for example, the node runs over physical links and VPCs). If this is not present when a new node_index is specified, the new node becomes a logical group node that represents a PNNI peer group. A logical group node only becomes active when its child node is elected peer group leader.

Default

With the ATM switch router autoconfiguration capabilities, a lowest-level PNNI node with the node index 1 is automatically created and runs on all PNNI interfaces by default (including interfaces determined by ILMI to be PNNI interfaces and on interfaces configured to run PNNI).

The default level is 56, the proper level for lowest-level nodes using autoconfigured Cisco ATM addresses in a single-level hierarchy.

Command Mode

ATM router PNNI configuration

Usage Guidelines

The level of a node can only be modified when the node is disabled.

The enable and disable options can be used to reinitialize PNNI. For example, the node ID and peer group ID are recalculated based on the switch's first ATM address and the node level whenever a node is enabled.

For more information, refer to the Catalyst 8540 MSR Configuration Guide.

Example

The following example shows how to enter PNNI node configuration mode.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# 

The following example shows how to create a lowest-level PNNI node with node index 1 at level 96 (assuming no node currently exists on this switch).

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1 level 96 lowest
Switch(config-pnni-node)# 
Related Commands

atm address
atm router pnni
show atm pnni local-node

nodal-representation

To specify the type of PNNI Logical Group Node (LGN) representation, use the nodal-representation PNNI node configuration command.

nodal-representation {simple | complex [threshold threshold-value | radius-only]}
Syntax Description

simple

Specifies the simple PNNI node representation, where an entire child peer group is represented as a single node.

complex

Specifies the complex PNNI node representation.

threshold threshold-value

Threshold percent for the generation of bypass or spoke exceptions. The threshold value ranges from 0 to 2147483647 percent. The default threshold is 60 percent.

radius-only

Advertises radius metrics only with no bypass or spoke exceptions.

Default

simple

Command Mode

PNNI node configuration

Usage Guidelines

Larger values for the threshold reduces the number of bypass and spoke exceptions advertised by PNNI. If a metric differs from the default metric and the (larger - smaller) / smaller ratio is greater than the threshold percentage, then an exception spoke, or bypass is advertised.

Lowest level nodes are not allowed to have complex nodal-representation.

The radius-only option suppresses all exceptions.

Example

The following example shows how to specify nodal representation for radius only.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 2
Switch(config-pnni-node)# nodal-representation complex radius-only
Related Commands

show atm pnni aggregation link
show atm pnni aggregation node
show atm pnni local-node