Event control commands

event-control

Syntax

event-control application-id [event-name | event-number] [generate [severity-level] [throttle]

event-control application-id [event-name | event-number] suppress

no event-control application [event-name | event-number]

Context

config>log

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies that a particular event or all events associated with an application is either generated or suppressed.

Events are generated by an application and contain an event number and description describing the cause of the event. Each event has a default designation which directs it to be generated or suppressed.

Events are generated with a default severity level that can be modified by using the severity-level option.

Events that are suppressed by default are typically used for debugging purposes. Events are suppressed at the time the application requests the event generation. No event log entry is generated regardless of the destination. While this feature can save processor resources, there may be a negative effect on the ability to troubleshoot problems if the logging entries are squelched. In reverse, indiscriminate application may cause excessive overhead.

The rate of event generation can be throttled by using the throttle parameter.

The no form of the command reverts the parameters to the default setting for events for the application or a specific event within the application. The severity, generate, suppress, and throttle options are also reset to the initial values.

Default

Each event has a set of default settings. To display a list of all events and the current configuration use the event-control command.

Parameters

application-id

The application whose events are affected by this event control filter.

Default

None, this parameter must be explicitly specified.

Values

A valid application name. To display a list of valid application names, use the applications command. Valid applications are:

event-name | event-number

To generate, suppress, or revert to default for a single event, enter the specific number or event short name. If no event number or name is specified, the command applies to all events in the application. To display a list of all event short names use the event-control command.

Default

none

Values

A valid event name or event number.

generate

Specifies that logger event is created when this event occurs. The generate keyword can be used with two optional parameters, severity-level and throttle.

Default

generate

severity-name

An ASCII string representing the severity level to associate with the specified generated events

Default

The system assigned severity name

Values

One of: cleared, indeterminate, critical, major, minor, warning.

throttle

Specifies whether events of this type are throttled. By default, event throttling is on for most event types.

suppress

Indicates that the specified events are not logged. If this keyword is not specified, the events are generated by default.

route-preference

Syntax

route-preference primary {inband | outband} secondary {inband | outband | none}

no route-preference

Context

config>log

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the primary and secondary routing preference for traffic generated for SNMP notifications and syslog messages. If the remote destination is not reachable through the routing context specified by primary route preference, the secondary routing preference is attempted.

The no form of the command reverts to the default values.

Default

no route-preference

Parameters

primary

Specifies the primary routing preference for traffic generated for SNMP notifications and syslog messages.

Default

outband

secondary

Specifies the secondary routing preference for traffic generated for SNMP notifications and syslog messages. The routing context specified by the secondary route preference is attempted if the remote destination was not reachable by the primary routing preference, specified by primary route preference. The value specified for the secondary routing preference must be distinct from the value for primary route preference.

Default

inband

inband

Specifies that the logging utility attempts to use the base routing context to send SNMP notifications and syslog messages to remote destinations.

outband

Specifies that the logging utility attempts to use the management routing context to send SNMP notifications and syslog messages to remote destinations.

none

Specifies that no attempt is made to send SNMP notifications and syslog messages to remote destinations.