SERVICELOG(8)

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)