CSS Command Reference (Software Version 7.40)
RMON Alarm, Event, and History Configuration Mode Commands
Downloads: This chapterpdf (PDF - 161.0KB) The complete bookPDF (PDF - 5.06MB) | Feedback

RMON Alarm Configuration Mode Commands

Table Of Contents

RMON Alarm Configuration Mode Commands

(config-rmonalarm) active

(config-rmonalarm) falling-event

(config-rmonalarm) falling-threshold

(config-rmonalarm) lookup

(config-rmonalarm) no

(config-rmonalarm) owner

(config-rmonalarm) rising-event

(config-rmonalarm) rising-threshold

(config-rmonalarm) sample-interval

(config-rmonalarm) sample-type

(config-rmonalarm) sample-variable

(config-rmonalarm) startup-type

(config-rmonalarm) suspend

RMON Event Configuration Mode Commands

(config-rmonevent) active

(config-rmonevent) community

(config-rmonevent) description

(config-rmonevent) no

(config-rmonevent) owner

(config-rmonevent) type

(config-rmonevent) suspend

RMON History Configuration Mode Commands

(config-rmonhistory) active

(config-rmonhistory) data-source

(config-rmonhistory) interval

(config-rmonhistory) no

(config-rmonhistory) owner

(config-rmonhistory) requested-buckets


RMON Alarm Configuration Mode Commands

RMON alarm configuration mode allows you to configure an RMON alarm. An RMON alarm allows you to monitor every SNMP object in the CSS for a desired transitory state.

To access RMON alarm configuration mode, use the rmon-alarm command from any configuration mode except boot configuration mode. The prompt changes to (config-rmonalarm [index]). You can also use this command in RMON alarm mode to configure another alarm. For information about commands available in this mode, see the following commands.

Use the no form of this command in global configuration mode to delete an RMON alarm.

rmon-alarm index

no rmon-alarm index

Syntax Description

index

RMON alarm index number. Enter an integer from 1 to 65535.

The RMON alarm index 65535 is administratively predefined and cannot be modified. If you enter this index number, a message similar to the following appears:

%% Index internally used. Administrative 
control not allowed.

(config-rmonalarm) active

To activate the RMON alarm, use the active command. Before you can activate an alarm, you must specify the owner parameter. To suspend an alarm to change its configuration, use the suspend command.

active

Related Commands

(config-rmonalarm) owner
(config-rmonalarm) suspend

(config-rmonalarm) falling-event

To specify the falling event index for the RMON alarm, use the falling-event command. When the falling threshold is exceeded, this is the RMON event that is triggered. Use the no form of this command to reset the event index to 0.

falling-event falling_index

no falling-event

Syntax Description

falling_index

Event index used when a falling threshold is crossed. Enter an integer from 0 to 65535. If you enter 0, no event is generated. The default is 0.


Usage Guidelines

You must suspend the alarm to change the index.

(config-rmonalarm) falling-threshold

To specify the falling threshold for the RMON alarm, use the falling-threshold command. A single event is generated when the sampled value is less than or equal to the threshold, and the value at the last sampling interval is greater than the threshold. Use the no form of this command to reset the threshold to 0.

falling-threshold falling_value

no falling-threshold

Syntax Description

falling_value

Threshold for the falling sample type. Enter an integer from 0 to 4294967295. The default is 0.


Usage Guidelines

You must suspend the alarm to change the threshold.

(config-rmonalarm) lookup

To look up an SNMP variable and to view the description associated with a MIB object, use the lookup command.

lookup variable

Syntax Description

variable

Name of the variable to look up. Enter an unquoted text string with a maximum length of 32 characters.


(config-rmonalarm) no

To negate a command or set it to its default, use the no command. For information on general no commands you can use in this mode, see the general no command. The following options are available in RMON alarm mode.

Syntax Description

no falling-event

Resets the event index to 0

no falling-threshold

Resets the threshold to 0

no owner

Deletes the owner

no rising-event

Resets the event index to 0

no rising-threshold

Resets the threshold to 0

no sample-interval

Resets the interval to 300

no sample-type

Resets the sample type to delta

no sample-variable

Deletes the variable

no startup-type

Resets the type to a rising alarm


(config-rmonalarm) owner

To specify the owner of the RMON alarm, use the owner command. Use the no form of this command to delete the owner.

owner "owner_name"

no owner

Syntax Description

"owner_name"

Name of the owner that configured this entry and is using its assigned resources. Enter a quoted text string with a maximum length of 32 characters.


Usage Guidelines

Before activating the alarm, you must specify an owner.

(config-rmonalarm) rising-event

To specify the rising event index for the RMON alarm, use the rising-event command. Use the no form of this command to reset the event to 0.

rising-event rising_index

no rising-event

Syntax Description

rising_index

Event index used when a rising threshold is crossed. Enter an integer from 0 to 65535. If you enter 0, no event is generated. The default is 0.


Usage Guidelines

You must suspend the alarm to change the index.

(config-rmonalarm) rising-threshold

To specify the rising threshold for the RMON alarm, use the rising-threshold command. When the sampled value is greater than or equal to the threshold and the value at the last sampling interval was less than the threshold, a single event is generated. Use the no form of this command to reset the threshold to 0.

rising-threshold rising_value

no rising-threshold

Syntax Description

rising_value

Threshold for the rising sample type. Enter an integer from 0 to 4294967295. The default is 0.


Usage Guidelines

You must suspend the alarm to change the threshold.

(config-rmonalarm) sample-interval

To specify the sampling interval for the RMON alarm, use the sample-interval command. Use the no form of this command to reset the interval to 300.

sample-interval interval

no sample-interval

Syntax Description

interval

Interval, in seconds, over which the data is sampled and compared with the rising and falling thresholds. Enter an integer from 1 to 65535. With delta sampling, be careful to set the interval short enough so that the sampled variable is not likely to increase or decrease by more than 231-1 during a single sampling interval. The default is 300.


Usage Guidelines

You must suspend the alarm to change the interval.

(config-rmonalarm) sample-type

To specify the sample type for the RMON alarm, use the sample-type command. Use the no form of this command to reset the type to delta sampling.

sample-type absolute|delta

no sample-type

Syntax Description

absolute

Uses absolute sampling

delta

Uses delta sampling (default)


Usage Guidelines

You must suspend the alarm to change the sample type.

(config-rmonalarm) sample-variable

To specify the sample variable for the RMON alarm, use the sample-variable command. Use the no form of this command to delete the variable.

sample-variable snmp_object_id

no sample-variable

Syntax Description

snmp_object_id

SNMP object ID. To see a list of SNMP object IDs, enter:

sample-variable ?

Usage Guidelines

You must suspend the alarm to change the variable.

(config-rmonalarm) startup-type

To specify the initial alarm type for the RMON alarm, use the startup-type command. Use the no form of this command to reset the type to a rising alarm.

startup-type falling|rising|rising-and-falling

no startup-type

Syntax Description

falling

Uses a falling alarm

rising

Uses a rising alarm (default)

rising-and-falling

Uses both rising and falling alarms


Usage Guidelines

You must suspend the alarm to change the startup type.

(config-rmonalarm) suspend

To suspend the RMON alarm allowing you to change its configuration setting, use the suspend command.

suspend

Related Commands

(config-rmonalarm) active

RMON Event Configuration Mode Commands

RMON event configuration mode allows you to configure an RMON event. An RMON event defines what should occur when an RMON alarm is triggered.

To access RMON event configuration mode, use the rmon-event command from any configuration mode except boot configuration mode. The prompt changes to (config-rmonevent [index]). You can also use this command in RMON event mode to configure another event. For information about commands available in this mode, see the following commands.

Use the no form of this command to delete an RMON event. Use the no form of this command only in global configuration mode.

rmon-event index

no rmon-event index

Syntax Description

index

RMON event index number. Enter an integer from 1 to 65535.

The RMON event index 65535 is administratively predefined and cannot be modified. If you enter this index number, a message similar to the following appears:

%% Index internally used. Administrative 
control not allowed.

(config-rmonevent) active

To activate the RMON event, use the active command. Before you can activate an event, you must specify the owner of the event. To suspend an event to change its configuration, use the suspend command.

active

Related Commands

(config-rmonevent) owner
(config-rmonevent) suspend

(config-rmonevent) community

To specify the RMON event community where you want to send the SNMP trap, use the community command. Use the no form of this command to reset the community to public.

community community_name

no community

Syntax Description

community_name

Name of the community. This variable is the name of the SNMP community you configured using the snmp trap-host command. Enter an unquoted text string with a maximum length of 127 characters.


Usage Guidelines

If you have activated the event, you cannot specify a community. Suspend the event through the (config-rmonevent) suspend command.

Related Commands

snmp trap-host

(config-rmonevent) description

To specify the RMON event description, use the description command. Use the no form of this command to delete the description.

description "description"

no description

Syntax Description

"description"

Description of the RMON event. Enter a quoted text string with a maximum length of 126 characters.


Usage Guidelines

If you have activated the event, you cannot specify a description. Suspend the event through the (config-rmonevent) suspend command.

(config-rmonevent) no

To negate a command or set it to its default, use the no command. For information on general no commands you can use in this mode, see the general no commands. The following options are available in RMON event mode.

Syntax Description

no community

Resets the community to public

no description

Deletes the description

no type

Resets the generated event type to log

no owner

Deletes the owner


(config-rmonevent) owner

To specify the owner of the RMON event, use the owner command. Use the no form of this command to delete the owner.

owner "owner_name"

no owner

Syntax Description

"owner_name"

Name of the owner that configured this entry and is using its assigned resources. Enter a quoted text string with a maximum of 126 characters.


Usage Guidelines

Before activating the event, you must specify an owner. To change the owner, first, suspend the event through the (config-rmonevent) suspend command.

Related Commands

(config-rmonevent) active

(config-rmonevent) type

To specify the generated RMON event type, use the type command. Use the no form of this command to reset the type to generate a log.

type log|log-and-trap|trap

no type

Syntax Description

log

Generates a log

log-and-trap

Generates a log and a trap

trap

Generates a trap


Usage Guidelines

If you have activated the event, you cannot specify this parameter. Suspend the event through the (config-rmonevent) suspend command.

(config-rmonevent) suspend

To suspend the RMON event allowing you to change its configuration setting, use the suspend command.

suspend

Related Commands

(config-rmonevent) suspend

RMON History Configuration Mode Commands

RMON history configuration mode allows you to configure the RMON history operation. To access RMON history configuration mode, use the rmon-history command from any configuration mode except boot configuration mode. The prompt changes to (config-rmonhistory [index]). For information about commands available in this mode, see the following commands.

Use the no form of this command to delete an RMON history. Use the no form of this command only in global configuration mode.

rmon-history index

no rmon-history index

Syntax Description

index

RMON history index number. Enter an integer from 1 to 65535.

Some history index numbers are administratively predefined and cannot be modified. If you enter an index number under administrative control, a message similar to the following appears:

%% Index internally used. Administrative 
control not allowed.

(config-rmonhistory) active

To activate an RMON history entry, use the active command.

active

Usage Guidelines

Before activating this command, you must specify an owner of the RMON history entry.

Related Commands

(config-rmonhistory) owner

(config-rmonhistory) data-source

To specify the object of the RMON history operation, use the data-source command.

data-source data_object_id

Syntax Description

data_object_id

Data object ID. To see a list of data object IDs, enter:

data-source ?

Usage Guidelines

If you have activated the history, you cannot specify this object.

(config-rmonhistory) interval

To specify the bucket interval for the RMON history operation, use the interval command.

interval value

Syntax Description

value

Interval value in seconds. Enter an integer from 1 to 3600. The default is 1800.


Usage Guidelines

If you have activated the history, you cannot specify an interval.

(config-rmonhistory) no

To negate a command or set it to its default, use the no command. For information on general no commands you can use in this mode, see the general no command.

(config-rmonhistory) owner

To specify the owner of the RMON history event, use the owner command.

owner "owner_name"

Syntax Description

"owner_name"

Name of the owner that configured the entry and is using its assigned resources. Enter a quoted text string with a maximum length of 32 characters.


Usage Guidelines

Before activating the event, you must specify an owner.

Related Commands

(config-rmonhistory) active

(config-rmonhistory) requested-buckets

To specify the bucket count for the RMON history operation, use the requested-buckets command.

requested-buckets count

Syntax Description

count

Requested number of discrete time intervals in buckets over which to save data associated with the history entry. Enter an integer from 1 to 65535. The default is 50.


Usage Guidelines

If you have activated the history, you cannot specify this parameter.