evweb_eventviewer(1)

Specifies the age of an event. The age consists of a number and the unit of age. The possible values for unit are:

Specify an argument (a number followed by its unit) for the -a switch. The number and its unit must be separated using a colon. If you do not use the colon, specify the complete argument within double quotes. Following are the examples of the -a option:

The following two commands have the same meaning:

Deletes an event. Use the -D option to delete one or more events from the Event Archive. You can use the following switches with the -D option:

Following are the examples of the -D options:

Specifies the severity as a part of the events archive search criteria, for either viewing the summary list of events, or for deleting events.

Severity is represented by an operator followed by the severity values. The : demarcates the operator and the severity values. The following operators can be used:

The default value of operator is eq. You must use only one operator at a time.

To use the bw operator, you must specify the lower and upper severity levels. For all other operators, you must specify only one severity level.

The severity level ranges from 0 to 7, where 0 is least severe and 7 is most severe. Following lists the severity levels in ascending order of severity:

Use a colon to separate an operator and a severity level. Use a comma to separate two severity levels.

You can also use a space to separate an operator and a severity level. However, in this case, you should enclose the operator and severity values within double quotes.

You must specify only one -e switch in a command. Following are the examples of the -e option:

The following two commands have the same meaning:

The following three commands have the same meaning:

Displays the details of an event identified by an event number. You can use the following switches with the -E option:

Following are the examples of the -E option:

Forces the command without asking for a confirmation. You can use -f switch only with the -D option. Following are the examples of the -f option:

Displays how to use the evweb eventviewer command. Following are the examples of the -h option:

Specifies one or more Event IDs. Use this option as a part of the subscription criteria. You cannot use this switch more than once in a command. Following are the examples of the -i option:

Displays a list of events and their summary. The summary is extracted from the Event Archive based on the search criteria. You can use the following switches with the -L option:

Following are the examples of the -L option:

Specifies one or more event numbers, separated by a comma.

If you use the -n switch with the -E option, you can use the -n switch only once.

If you use the -n switch with the -D option, you can use the -n switch multiple times. Following are the examples of the -n option:

Defines the size of the summary list. You can use the -o switch only with the evweb eventviewer -L command. During a search operation, if the number of events in the summary list is large, use the -o and -c switches to specify the number of events in the summary list. Use the -o switch to define the offset and the -c switch to specify the number of events in the summary list. For example, assume that there are 200 events in the summary list. To view the first twenty events, specify an offset of zero and a count equal to 20, as follows:

To view the next set of twenty events specify:

Searches the Event Archive for information based on the specified search string. The search is not case-sensitive. To use this switch, type an operator followed by a string. Use a colon to separate the operator and the string. Enclose the entire argument (operator and string) within double quotes. You can use the -r switch more than once within one command. The following operators can be used with the -r switch:

Following are the examples of the -r option:

Displays the summary list of events sorted by specified order (ascending or descending) and column name. You can use -s switch only with the evweb eventviewer -L command. By default, the summary list is displayed in ascending order (asc). Use a colon to separate the sorting order and the summary column. Alternatively, you can separate the sort order and summary column with a space, but you must then enclose the entire string within double quotes. Following are the examples of the -s option:

The following three commands have the same meaning:

Specifies date and time. Date-time can be represented by an operator followed by the date-time values. The following operators can be used with the -t switch.

Only one operator can be used at one time.

To use the bw operator, specify the lower and upper date-time values. For all other operators, you must specify only one date-time value. The format to specify date-time value is mm:dd:yyyy:hh:mi:ss. The date-time value are defined as:

Use a colon (:) to separate an operator and a date-time value. Use a comma (,) to separate two date-time values. Alternatively, you can specify an operator and a date-time value within double quotes. You must specify only one -t switch in a command.

Following are the examples of the -t option:

The following two commands have the same meaning:

Note: The -a and -t switches are mutually exclusive. An error message is displayed if both the switches are used together in a command.

Specifies a list of event categories, separated by comma. Use this option as a part of the search criteria. Use evweb list -v command to find the possible values for this option. The event category strings are case-sensitive. Following are the examples of the -v option: