NAME

servicelog - query the contents of the servicelog

SYNOPSIS

/usr/bin/servicelog [options]

DESCRIPTION

The servicelog command queries and displays the contents of the system servicelog. You can use the --query option to select which events to report.

OPTIONS

When run without any command-line arguments, servicelog will report statistics on the types of entries that have been logged to the database.

--dump or -d: Report every event currently logged to the database.
--query="query-string" or -q "query-string": Specify the type of events to report. See the "QUERY STRINGS" section.
--help or -h: Display a help message and exit.
--version or -V: Display the version of the command and exit.

QUERY STRINGS

Servicelog events are stored in a relational database. When you specify --query, query-string is used in an SQL WHERE clause to select the events to report. Here are the column names you can use in query strings.

id: record ID
time_logged, time_event, time_last_update: e.g., '2008-02-08 14:30:05'
type: an integer, or one of the following names: $BASIC (same as 0), $OS (1), $RTAS (2), $ENCLOSURE (3), $BMC (4)
severity: an integer, or one of thew following names: $FATAL (7), $ERROR (6), $ERROR_LOCAL (5), $WARNING (4), $EVENT (3), $INFO (2), $DEBUG (1)
platform: processor type (text)
machine_serial: serial number (text)
machine_model: model number (text)
nodename: name of system reporting the event (text)
refcode: reference code (text)
description: (text)
serviceable: 0 or 1
predictive: 0 or 1
disposition: 0 (Recoverable), 1 (Unrecoverable), or 2 (Unrecoverable, Bypassed)
call_home_status: 0 (None Needed), 1 (Call Home Candidate), or 2 (Called Home)
closed: 0 or 1
repair: numeric ID of repair action that close this event, or 0 if not closed

The following column names can used to select OS-type events: os.version, subsystem, driver, and device (all text).

The following column names can be used to select RTAS-type events: creator_id (text); action_flags, platform_id, subsystem_id, pel_severity, rtas.event_type, event_subtype, kernel_id, and addl_word1 through addl_word8 (all integers).

The following column names can be used to select ENCLOSURE-type events: enclosure_serial, enclosure_model (both text).

The following column names can be used to select BMC-type events: sel_id, sel_type, generator, bmc.version, sensor_type, sensor_number, event_class, bmc.event_type, and direction (all integers).

EXAMPLES

servicelog --query='id=12': prints the event with an ID of 12.
servicelog --query='serviceable=1 AND closed=0': prints all open (unfixed) serviceable events.
servicelog -q 'severity>=$WARNING AND closed=0': prints all open events with a sev of WARNING or greater.
servicelog -q "time_event>'2008-02-08'": prints all events that occurred after Feb 8, 2008.

OLD SYNTAX

This man page describes the command syntax accepted by v1.0 and later of servicelog. In v1.1, backward compatibility with v0.2.9 was added. If servicelog recognizes v0.2.9 command-line options, it will exec the v0.2.9 version of the command.

AUTHOR

Written by Michael Strosaker (strosake@austin.ibm.com), Nathan Fontenot (nfont@austin.ibm.com), Jim Keniston (jkenisto@us.ibm.com), Brad Peters