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

SEE ALSO¶

servicelog_manage(8) servicelog_notify(8) log_repair_action(8)