cc/td/doc/product/atm/ls1010s/wa4/12_0_4
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

R Commands for the LightStream 1010 ATM Switch

R Commands for the LightStream 1010 ATM Switch

random-detect

To enable random early detection on an interface, use the random-detect interface configuration command. To disable random early detection on the interface, use the no form of this command.

random-detect [weighting]
no random-detect
Syntax Description

weighting

Exponential weighting constant in the range 1 to 16 used to determine the rate that packets are dropped when congestion occurs. The default is 10 (that is, drop 1 packet every 10).

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

On high-speed networks, random detection is used to avoid congestion by dropping packets at a controlled rate.

Use the default value for the exponential weighting constant; however, you might need to change this value depending on your operational environment. For example, a value of 10 (the default), which might achieve a loss rate of 10-4, is recommended for high-speed links such as DS3 and OC3; while a value of 7, which might achieve a loss rate of 10-3, is recommended for T1 links.

Random early detection cannot be configured on an interface already configured with custom, priority, or fair queueing default values.

When RSVP is configured on the interface, packets from other traffic flows are dropped before RSVP flows (when possible). Also, the IP precedence of the packet determines whether the packet is dropped.

Lower-precedence traffic is dropped before higher-precedence traffic.

Example

The following example shows how to enable random early detection on an ASP interface.

Switch(config)# interface 2/0/0
Switch(config-if)# random-detect
Related Commands

custom-queue-list
priority-group
show interface

redistribute

To instruct the PNNI to redistribute static routes throughout the PNNI routing domain, use the redistribute PNNI node configuration command. To disable redistribution of static routes, use the no form of this command.

redistribute protocol
no redistribute protocol
Syntax Description

protocol

The protocol keyword used for static routes is atm-static.

Default

Enabled for atm-static.

Command Mode

PNNI node configuration

Usage Guidelines

All redistributed routes are advertised in exterior reachable address PTSE with default scope and without metric. All redistributed routes are summarized by the summary-address command.

In autoconfiguration mode, PNNI is set to redistribute the configured static routes.

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

Example

The following script shows how to access the redistribute PNNI node configuration command.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# node 1
Switch(config-pnni-node)# redistribute atm-static
Related Commands

atm route
show atm route

refuse-message

To define a line-in-use message, use the refuse-message line configuration command. To disable the message, use the no form of this command.

refuse-message d message d
no refuse-message
Syntax Description

d

Delimiting character of your choice---for example, a pound sign (#). You cannot use the delimiting character in the message.

message

Message text.

Default

No line-in-use message is defined.

Command Mode

Line configuration

Usage Guidelines

Follow the command with one or more blank spaces and a delimiting character of your choice. Then enter one or more lines of text, terminating the message with the second occurrence of the delimiting character. You cannot use the delimiting character within the text of the message.

When you define a message using this command, the switch performs the following tasks:

    1. Accepts the connection.

    2. Prints the custom message.

    3. Clears the connection.

Example

In the following example, line 0 is configured with a line-in-use message, and the user is instructed to try again later.

Switch(config)# line aux 0
Switch(config-line)# refuse-message /The dial-out modem is currently in use.
 
Please try again later./

reload

To reload the operating system, use the reload privileged EXEC command.

reload [at hh:mm day month] [cancel] [in delay] [reason]
Syntax Description

hh:mm

Specifies the time to reload.

day

Specifies the day of the month.

month

Specifies the month as a character string.

cancel

Cancels any scheduled reload.

delay

Specifies the delay before reload in the format mmm or hhh:mm.

reason

Text that specifies the reason for the reload.

Command Mode

Privileged EXEC

Usage Guidelines

The reload command halts the system. If the system is set to restart on error, it reboots itself. Use the reload command after configuration information is entered into a file and saved to the startup configuration.

You cannot reload from a virtual terminal if the system is not set up for automatic booting. This prevents the system from dropping to the ROM monitor and taking the system out of the remote user's control.

If you modify your configuration file, the system prompts you to save the configuration. During a save operation, the system asks you if you want to proceed with the save if the config_file environment variable points to a startup configuration file that no longer exists. If you enter "yes", the system saves the running configuration to startup configuration.

Example

The following example illustrates how to enter the reload command at the specified time.

Switch# reload 18:30 20 jan
Related Commands

copy running-config
copy startup-config

resource-poll-interval

To configure the period of time that PNNI polls resource management to update the values of the interface metrics and attributes, use the resource-poll-interval ATM router PNNI configuration command. To return to the default value, use the no form of this command.

resource-poll-interval seconds
no resource-poll-interval
Syntax Description

seconds

Specifies the interval, in seconds, at which the values of the interface metrics and attributes are updated.

Default

5 seconds

Command Mode

ATM router PNNI configuration

Usage Guidelines

The maximum allowable poll interval is 300 seconds. Using this value impacts the number of self-generated PTSEs created by the switch. A larger resource-poll-interval can generate a smaller number of PTSE updates, as PNNI polls the interface resource information less frequently. A large resource-poll-interval is desirable when reducing the number of self-generated PTSEs caused by interface traffic fluctuation.

Lowering the default allows PNNI to poll the resource manager (for resource information) at a higher frequency. This allows PNNI to track resource information faster, but it costs more in processing time and should be adjusted only when needed.

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

Example

The following example shows how to change the period of time the interface metrics and attributes are updated using the resource-poll-interval ATM router PNNI configuration command.

Switch# configure terminal
Switch(config)# atm router pnni
Switch(config-atm-router)# resource-poll-interval 30
Related Command

show atm pnni resource-info

resume

To switch to another open Telnet, LAT, or PAD session, use the resume EXEC command.

resume [connection] [keyword]
Syntax Description

connection

The name or number of the connection; the default is the most recent connection.

keyword

One of the options listed in Table 17-1.

Default

/noline1

Command Mode

EXEC

Usage Guidelines

Several concurrent sessions can be open and you can switch back and forth between them. The number of sessions that can be open is defined by the sessions command.

You can switch between sessions by escaping one session and resuming a previously opened session, as follows.

Step 1 Escape out of the current session by pressing the escape sequence (Ctrl^ then x [Ctrl^x] by default) and return to the EXEC prompt.

Step 2 Enter the where command to list the open sessions. All open sessions associated with the current terminal line are displayed.

Step 3 Enter the resume command and the session number to make the connection.

You also can resume the previous session by pressing the Return key.

The Ctrl^x, where, and resume commands are available with all supported connection protocols.

Table 17-1 lists the Telnet and rlogin resume options.


Table 17-1: Telnet and rlogin Resume Options
Option Description

/debug

Displays parameter changes and messages. In the Cisco IOS software, this option displays informational messages whenever the remote host changes an X.3 parameter, or sends an X.29 control packet.

/echo

Performs local echo.

/line

Enables line-mode editing.

/nodebug

Cancels printing of parameter changes and messages.

/noecho

Disables local echo.

/noline1

Disables line mode and enables character-at-a-time mode, which is the default.

/nostream

Disables stream processing.

/set parameter:value

Sets X.3 connection options.

/stream

Enables stream processing.

Examples

The following example shows how to escape out of a connection and to resume connection 2.

Swift% ^^X 
Switch> resume 2 
 

You can omit the command name and simply enter the connection number to resume that connection. The following example illustrates how to resume connection 3.

Switch> 3 
Related Commands

session-timeout
show sessions
where

rif

To enter static source-route information into the routing information field (RIF) cache, use the rif global configuration command. To remove an entry from the cache, use the no form of this command.

rif mac-addr [rif-string]
no rif mac-addr [rif-string]
Syntax Description

mac-addr

MAC address of the RIF entry.

rif-string

Series of 4-digit hexadecimal numbers separated by a period (.). This RIF string is inserted into the packets sent to the specified MAC address.

Default

No static source-route information is entered.

Command Mode

Global configuration

Usage Guidelines

If a Token Ring host does not support the use of IEEE 802.2 TEST or XID datagrams as explorer packets, you may need to add static information to the RIF cache.

Using the command rif mac-address without any other arguments puts an entry into the RIF cache indicating that packets for this MAC address will not have RIF information.

Do not configure a static RIF with any of the all rings type codes. Doing so causes traffic for the configured host to appear on more than one ring and leads to unnecessary congestion.

Example

The following example shows inserting a RIF cache entry with MAC address 1000.5A12.3456 and RIF 0630.0081.0090.

Switch(config)# rif 1000.5A12.3456 0630.0081.0090
Related Commands

multiring
show rif

rif always-forward

To specify that RIFs always be stored in the forward direction, use the rif always-forward global configuration command. To disable forward-direction storing of RIFs, use the no form of this command.

rif always-forward
no rif always-forward

Syntax Description

This command has no keyword or arguments.

Default

RIFs are not stored in the forward direction.

Command Mode

Global configuration

Related Commands

rif
show rif

rif timeout

To specify the number of minutes an inactive entry is kept in the RIF cache, use the rif timeout global configuration command. To restore the default time, use the no form of this command.

rif timeout minutes
no rif timeout
Syntax Description

minutes

Number of minutes an inactive RIF entry is kept in the cache. The valid range is 1 to 120.

Default

15 minutes

Command Mode

Global configuration

Usage Guidelines

A RIF entry is refreshed only if a RIF field of an incoming frame is identical to the RIF information of the RIF entry in the cache.

Until a RIF entry is removed from the cache, no new information is accepted for that RIF entry.

Example

The following example shows changing the timeout to 5 minutes.

Switch(config)# rif timeout 5
Related Commands

clear rif-cache
rif
show rif

rif validate-age

To permit invalidated and aged-out entries to be removed from the RIF cache, use the rif validate-age global configuration command. To disable this feature, use the no form of this command.

rif validate-age
no rif validate-age

Syntax Description

This command has no keywords or options.

Default

Aged entries are removed.

Command Mode

Global configuration

Related Commands

rif
rif timeout
show rif

rif validate-enable

To enable RIF validation for entries learned on an interface, use the rif validate-enable global configuration command. To disable the specification, use the no form of this command.

rif validate-enable
no rif validate-enable

Syntax Description

This command has no keywords or arguments.

Default

RIF validation is enabled.

Command Mode

Global configuration

Usage Guidelines

A RIF validation algorithm is used for the following cases:

A directed IEEE TEST command is sent to the destination MAC address. If a response is received in the time specified by rif validate-time, the entry is refreshed and is considered valid. Otherwise, the entry is removed from the cache. To prevent sending too many TEST commands, any entry that has been refreshed in less than 70 seconds is considered valid.

Validation is triggered when any of the follows occurs:


Note If the RIF entry has been in the RIF cache for six hours, and has not been refreshed for the time specified in the rif timeout command, the entry is removed from the cache.

Note This command has no effect on remote entries learned over RSRB.
Related Command

rif timeout

rif xid-explorer

To send IEEE XID explorer packets instead of TEST commands to learn RIF information, use the rif xid-explorer global configuration command. To disable this specification, use the no form of this command.

rif xid-explorer
no rif xid-explorer

Syntax Description

This command has no keywords or arguments.

Default

TEST commands are sent.

Command Mode

Global configuration

Related Commands

rif
show rif

rmon alarm

To set an alarm on any MIB object, use the rmon alarm configuration command. To disable the alarm, use the no form of this command.

rmon alarm number variable interval {delta | absolute} rising-threshold value
[event-number] falling-threshold value [event-number] [owner string]
no rmon alarm number
Syntax Description

number

Alarm number, which is identical to the alarmIndex in the alarm Table in the RMON MIB.

variable

MIB object to monitor, which translates into the alarmVariable used in the alarmTable of the RMON MIB.

interval

Time in seconds the alarm monitors the MIB variable, which is identical to the alarmValue used in the alarmTable of the RMON MIB.

delta

Tests the change between MIB variables, which affects the alarmSampleType in the alarmTable of the RMON MIB.

absolute

Tests each MIB variable directly, which affects the alarmSampleType in the alarmTable of the RMON MIB.

rising-threshold value

Value at which the alarm is triggered.

event-number

Event number to trigger when the rising or falling threshold exceeds its limit. This value is identical to the alarmRisingEventIndex or the alarmFallingEventIndex in the alarmTable of the RMON MIB.

falling-threshold value

Value at which the alarm is reset.

string

Specifies an owner for the alarm, which is identical to the alarm owner in the alarmTable of the RMON MIB.

Default

No alarms configured.

Command Mode

Global configuration

Usage Guidelines

To disable the RMON alarms, you must use the no form of the command on each configured alarm. For example, enter no rmon alarm 1, where the 1 identifies which alarm is to be removed.

See RFC 1757 for more information about the RMON alarm group.

Example

The following example configures an RMON alarm using the rmon alarm command.

Switch# rmon alarm 10 ifOutErrors.1 20 delta rising-threshold 15 1 falling-threshold 0 owner jhunt
 

This example configures RMON alarm number 10. The alarm monitors the MIB variable ifOutErrors.1 once every 20 seconds until the alarm is disabled, and checks the change in the variable's rise or fall. If the ifOutErrors.1 value shows a MIB counter increase of 15 or more, such as from 100000 to 100015, the alarm is triggered. The alarm in turn triggers event number 1, which is configured with the rmon event command. Possible events include a log entry or a SNMP trap.

If the ifOutErrors.1 value changes by 0 (falling-threshold 0), the alarm is reset and can be triggered again.

Related Commands

rmon event
show rmon alarms

rmon event

To add or remove an event in the RMON event table that is associated with an RMON event number, use the rmon event global configuration command. To disable RMON on the interface, use the no form of this command.

rmon event number [log] [trap community] [description string] [owner string]
no rmon event number
Syntax Description

number

Assigned event number, which is identical to the eventIndex in the eventTable in the RMON MIB.

log

Generates an RMON log entry when the event is triggered and sets the eventType in the RMON MIB to log or log-and-trap.

community

SNMP community string used for this trap. Configures the setting of the eventType in the RMON MIB for this row as either snmp-trap or log-and-trap. This value is identical to the eventCommunityValue in the eventTable in the RMON MIB.

description string

Specifies a description of the event, which is identical to the event description in the eventTable of the RMON MIB.

owner string

Specifies the owner of this event, which is identical to the eventDescription in the eventTable of the RMON MIB.

Default

No events configured

Command Mode

Global configuration

Usage Guidelines

See RFC 1757 for more information about the RMON MIB.

Example

The following example enables the rmon event command.

Switch# rmon event 1 log trap eventtrap description "High ifOutErrors" owner jhunt 
 

This example configuration creates RMON event number 1, which is defined as High ifOutErrors, and generates a log entry when the event is triggered by an alarm. The user jhunt owns the row that is created in the event table by this command. This configuration also generates an SNMP trap when the event is triggered.

Related Commands

rmon alarm
show rmon events

route-map


Note This command or some of its parameters might not function as expected in the LightStream 1010 ATM switch environment.

router


Note This command or some of its parameters might not function as expected in the LightStream 1010 ATM switch environment.

rotary


Note This command or some of its parameters might not function as expected in the LightStream 1010 ATM switch environment.

rsh

To execute a command remotely on a remote rsh host, use the rsh privileged EXEC command.

rsh {ip-address | host} [/user username] line
Syntax Description

ip-address

IP address of the remote host on which to execute the rsh command. Either the IP address or the host name is required.

host

Name of the remote host on which to execute the command. Either the host name or the IP address is required.

username

Remote username.

line

Required parameter to be executed remotely.

Default

If you do not specify the /user keyword and argument, the switch sends a default remote username. As the default value of the remote username, the switch software sends the username associated with the current TTY process if that name is valid. For example, if the user is connected to the switch through Telnet and the user was authenticated through the username command, the switch software sends that username as the remote username. If the TTY username is invalid, the switch software uses the switch host name as both the remote and local usernames.


Note TTYs are commonly used in Cisco communications servers. The concept of TTY originated with UNIX. For UNIX systems, each physical device is represented in the file system. Terminals are called TTY devices, which stands for teletype, the original UNIX terminal.
Command Mode

Privileged EXEC

Usage Guidelines

Use the rsh command to execute commands remotely. The host on which you remotely execute the command must support the rsh protocol, and the .rhosts files on the rsh host must include an entry that permits you to remotely execute commands on that host.

For security reasons, the switch software does not default to a remote login if no command is specified. Instead, the switch provides Telnet and connect services that you can use rather than rsh.

Example

The following command specifies that user rusty attempts to remotely execute the UNIX ls command with the -a argument on the remote host mysys.cisco.com. The command output resulting from the remote execution follows the command example.

Switch1# rsh mysys.cisco.com /user rusty ls -a
.
..
.alias
.cshrc
.emacs
.exrc
.history
.login
.mailrc
.newsrc
.oldnewsrc
.rhosts
.twmrc
.xsession
jazz

rxspeed

To set the terminal baud rate receive (from terminal) speed, use the rxspeed line configuration command. To set the baud rate to the default, use the no form of this command.

rxspeed bps
no rxspeed
Syntax Description

bps

Baud rate in bits per second (bps); see the "Usage Guidelines" below for settings.

Default

9600 bps

Command Mode

Line configuration

Usage Guidelines

This command pertains to the auxiliary port only. Set the speed to match the baud rate of any device you connect to the port. Some baud rates available on devices connected to the port might not be supported on the switch. The switch indicates if the speed you select is not supported.

The following is a list of supported baud rates:

75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 4800, 9600, 19200, 38400

Example

The following example sets the auxiliary line receive rate to 2400 bps.

Switch(config)# line aux 0
Switch(config-line)# rxspeed 2400
Related Commands

speed
txspeed


hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Jun 22 13:40:35 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.