HMC Manual Reference Pages  - LSSVCEVENTS (1)

NAME

lssvcevents - list console or serviceable events

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author

SYNOPSIS

lssvcevents -t {console | hardware}
[-d number-of-days | -i number-of-minutes]
[-m managed-system]
[--filter "filter-data"]
[-F [attribute-names] [--header]] [--help]

DESCRIPTION

lssvcevents lists console events logged by the Hardware Management Console (HMC), or serviceable events.

OPTIONS

-t The type of events to list. Valid values are console for console events, or hardware for serviceable events.
-d The number of days prior to today for which events will be listed. Events that occurred today will be listed, along with any events that occurred during the past number-of-days days.

If this option is omitted when listing console events, console events that occurred within the past 7 days will be listed.

If this option is omitted when listing serviceable events, all serviceable events will be listed.

-i The number of minutes to go back and search for events. This search is based on the time that the event was initially created on the HMC, and is not affected by later updates to the event.
-m The name of the managed system for which serviceable events are to be listed. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.

If this option is omitted, all serviceable events will be listed.

This option is only valid when listing serviceable events.

--filter The filter to apply to the serviceable events to be listed. A filter is used to select which serviceable events are to be listed. For example, only open serviceable events can be listed by using a filter to specify the status (open) of the serviceable events to list. If a filter is not used, then all serviceable events will be listed.

The filter data consists of filter name/value pairs, which are in comma separated value (CSV) format. The filter data must be enclosed in double quotes.

The format of the filter data is as follows:

"filter-name=value,filter-name=value,..."

Note that certain filters accept a comma separated list of values, as follows:

"" filter-name=value,value,... ",..."

When a list of values is specified, the filter name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a ’#146; character.

Multiple values can be specified for each filter.

Valid filter names for serviceable events:
problem_nums
Specify event problem number(s)
status
Specify event status. Valid values are
open or closed.
approval_state
Specify event approval state. Valid values
are approved or unapproved.

This option is not valid when listing console events.

-F A delimiter separated list of attribute names for the desired attribute values to be displayed for each event. If no attribute names are specified, then values for all of the attributes for each event will be displayed.

When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option.

This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

--header Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.
--help Display the help text for this command and exit.

EXAMPLES

List the serviceable events that occurred today:

lssvcevents -t hardware -d 0

List the console events that occurred within the past 3 days:

lssvcevents -t console -d 3

List all of the open serviceable events for the system system1:

lssvcevents -t hardware -m system1 --filter "status=open"

List only the problem numbers and status of all serviceable events for the system that occurred within the last 7 days, and separate the output values with a colon:

lssvcevents -t hardware -m 9406-570*101234A -d 7 -F
problem_num:status

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin


Linux LSSVCEVENTS (1) "June 2014"
Generated by manServer 1.07 from lssvcevents.1 using man macros.