Diagnosing RTAS events

You can install and use the ppc64-diag, libservicelog, servicelog, and powerpc-utils packages to diagnose RTAS (Run Time Abstraction Services) events.

RTAS events (also known as platform events) might occur while your system is booting or running. RTAS events might be logged in the following places:

  • The console and the kernel ring buffer
  • The servicelog database
  • The /var/log/platform file

Displaying RTAS events in the kernel ring buffer

The kernel displays RTAS events in the console, and captures them in the kernel ring buffer. To display the kernel ring buffer, run the following command:

# dmesg

The following example shows RTAS events that are reported in the console and kernel ring buffer:

RTAS: event: 2340, Type: Platform Error, Severity: 2
RTAS: event: 2341, Type: Dump Notification Event, Severity: 1

The event numbers displayed as 2340 and 2341 in the example identify events on your system. They have no diagnostic meaning.

Displaying RTAS events in the servicelog database

The ppc64-diag package includes the rtas_errd daemon, which logs RTAS events to the servicelog database with the libservicelog package. The servicelog package provides commands for viewing the database. Install each package. See Platform diagnostics (ppc64-diag) and servicelog for information about these packages.

You can display a summary of servicelog events to determine whether any RTAS events are saved to the servicelog database. To display the summary, run the following command:

servicelog

The following sample output shows that there are 5 RTAS events:

Servicelog Statistics:

There are 3 open events requiring action.

Summary of Logged Events:

        Type   Total    Open  Closed    Info

        RTAS       5       3       2       0
             -------------------------------
                   5       3       2       0

Logged Repair Actions:         2
Registered Notification Tools: 3

To display the servicelog database, run the following command:

# servicelog --dump

The following sample output shows an example of an RTAS event in the servicelog database:

Servicelog ID:      4
Log Timestamp:      Fri Jul 27 04:51:31 2012
Event Timestamp:    Fri Jul 27 08:51:29 2012
Update Timestamp:   Fri Jul 27 04:51:31 2012
Type:               Power Platform (RTAS) Event
Severity:           3 (EVENT)
Platform:           ppc64
Model/Serial:       8406-71Y/108B7AA
Node Name:          abc.ibm.com
Reference Code:     B7004400
Serviceable Event:  No
Predictive Event:   No
Disposition:        0 (Recoverable)
Call Home Status:   0 (None Needed)
Status:             Closed
Action Flags:       2000
Event Type:         228 - Dump Notification Event
Kernel ID:          2
Platform ID:        50142eee
Creator ID:         H - Hypervisor
Subsystem ID:       82 - Platform firmware
RTAS Severity:      00 - Informational or non-error event
Event Subtype:      08 - Dump Notification

Extended Reference Codes:
2: 00000000  3: 00000000  4: 00000000  5: 00000000
6: 00000000  7: 00000000  8: 00000000  9: 00000000

Description:
Platform Firmware Informational (non-error) Event. Refer to the system
service documentation for more information.

A platform dump was generated and downloaded to the filesystem (1739921
bytes): /var/log/dump/FSPDUMP.108B7AA.AA000000.20120727044812

For information associated with the reference code in an RTAS event logged in servicelog, search for the reference code in Knowledge center.

Displaying RTAS events logged in the /var/log/platform file

Install the powerpc-utils package, which provides the rtas_dump command. See Service aids for information about the package.

You can display the RTAS events logged in the /var/log/platform file in two ways:

  • View the file in a text editor. The events display without formatting.
  • Run the rtas_dump command to display the events with formatting. For example:
    rtas_dump -f /var/log/platform

    The following sample output shows several RTAS events logged in the /var/log/platform file:

    ==== RTAS Event Dump (1) Begin ======================================
    Version:            00000006    Severity:           00000001 (Event)
    Type                000000e4 (Dump Notification Event)
    Status:             new
    
    ==== Private Header =================================================
    Date:               27 Jul 2012
    Time:               4:50:52:5
    Creator ID:         PHyp (H).
    Creator Subsystem Version: 0000000000000000.
    Platform Log ID:    50142eee    Log Entry ID:       820001fc
    
    ==== User Header ====================================================
    Subsystem ID:       00000082 (Platform Firmware)
    Event Data          00000003
    
    Event Type:         00000008
    Dump notification.
    
    Event Severity:     00000000
    Informational or non-error event,
    
    Action Flag:        00002000 Report Externally, (HMC and Hypervisor).
    
    ==== Primary SRC Section ============================================
    Platform Data:
    0x0000:  00000100 000048                         [......H.        ]
    
    Extended Reference Codes:
    2: 00000000  3: 00000000  4: 00000000  5: 00000000
    6: 00000000  7: 00000000  8: 00000000  9: 00000000
    
    Primary Reference Code: "B7004400                        "
    
    ==== Unknown Section ================================================
    Section ID:               EH    Section Length:     0000004c
    Version:            00000001    Sub_type:           00000000
    Component ID:       00004552
    
    Raw Section Data:
    0x0000:  38343036 2d373159 31303842 37414120     [8406-71Y108B7AA ]
    0x0010:  00000000 41583731 305f3131 39000000     [....AX710_119...]
    0x0020:  00000000 30303034 30373031 30343036     [....000407010406]
    0x0030:  30313836 00000000 00000000 00000000     [0186............]
    0x0040:  00000000                                [.....           ]
    
    ==== Machine Type ===================================================
    Model/Type:         8406-71Y (tttt-mmm)
    Serial Number:      108B7AA
    
    ==== Dump Locator section ===========================================
    Dump ID:            00000001    Dump Field Format:     ascii
    Dump Location:      Partition
    Dump Size:          0000000012b4d790
    
    ==== Unknown Section ================================================
    Section ID:               LP    Section Length:     00000018
    Version:            00000001    Sub_type:           00000000
    Component ID:       00004552
    
    Raw Section Data:
    0x0000:  00000401 00000000 00000000 00010000     [................]
    
    ==== RTAS Event Dump (1) End ========================================
    ==== RTAS Event Dump (2) Begin ======================================
    Version:            00000006    Severity:           00000001 (Event)
    Type                000000e4 (Dump Notification Event)
    Status:             new
    
    ==== Private Header =================================================
    Date:               27 Jul 2012
    Time:               4:51:29:71
    Creator ID:         PHyp (H).
    Creator Subsystem Version: 0000000000000000.
    Platform Log ID:    50142eee    Log Entry ID:       820001ff
    
    ==== User Header ====================================================
    Subsystem ID:       00000082 (Platform Firmware)
    Event Data          00000003
    
    Event Type:         00000008
    Dump notification.
    
    Event Severity:     00000000
    Informational or non-error event,
    
    Action Flag:        00002000 Report Externally, (HMC and Hypervisor).
    
    ==== Primary SRC Section ============================================
    Platform Data:
    0x0000:  00000100 000048                         [......H.        ]
    
    Extended Reference Codes:
    2: 00000000  3: 00000000  4: 00000000  5: 00000000
    6: 00000000  7: 00000000  8: 00000000  9: 00000000
    
    Primary Reference Code: "B7004400                        "
    
    ==== Unknown Section ================================================
    Section ID:               EH    Section Length:     0000004c
    Version:            00000001    Sub_type:           00000000
    Component ID:       00004552
    
    Raw Section Data:
    0x0000:  38343036 2d373159 31303842 37414120     [8406-71Y108B7AA ]
    0x0010:  00000000 41583731 305f3131 39000000     [....AX710_119...]
    0x0020:  00000000 30303034 30373031 30343036     [....000407010406]
    0x0030:  30313836 00000000 00000000 00000000     [0186............]
    0x0040:  00000000                                [.....           ]
    
    ==== Machine Type ===================================================
    Model/Type:         8406-71Y (tttt-mmm)
    Serial Number:      108B7AA
    
    ==== Dump Locator section ===========================================
    Dump ID:            aa000000    Dump Field Format:     ascii
    Dump Location:      Partition
    Dump Size:          00000000001a8c91
    
    ==== Unknown Section ================================================
    Section ID:               LP    Section Length:     00000018
    Version:            00000001    Sub_type:           00000000
    Component ID:       00004552
    
    Raw Section Data:
    0x0000:  00000401 00000000 00000000 00010000     [................]
    
    ==== RTAS Event Dump (2) End ========================================
    ==== RTAS Event Dump (3) Begin ======================================
    Version:            00000006    Severity:           00000002 (Warning)
    Type                000000e0 (Platform Error)
    Status:             unrecoverable new
    
    ==== Private Header =================================================
    Date:               27 Jul 2012
    Time:               4:48:6:8
    Creator ID:         Service Processor (E).
    Creator Subsystem Name: .
    Platform Log ID:    50142eee    Log Entry ID:       50142eee
    
    ==== User Header ====================================================
    Subsystem ID:       00000000
    Event Data          00000003
    
    Event Type:         00000000
    Unknown event type (0).
    
    Event Severity:     00000040
    Unrecoverable error, general.
    
    Action Flag:        0000a902 Unknown action flag (0x0000a902).
    
    ==== Primary SRC Section ============================================
    Platform Data:
    0x0000:  04000900 000048                         [......H.        ]
    
    Extended Reference Codes:
    2: 000000f0  3: 00000c00  4: 00000000  5: 20000000
    6: 070c001c  7: 00000000  8: 00000000  9: 00000000
    
    Primary Reference Code: "A1003000                        "
    
    ==== Unknown Section ================================================
    Section ID:               EH    Section Length:     00000060
    Version:            00000001    Sub_type:           00000000
    Component ID:       00003100
    
    Raw Section Data:
    0x0000:  38343036 2d373159 31303842 37414100     [8406-71Y108B7AA.]
    0x0010:  00000000 41583731 305f3131 39000000     [....AX710_119...]
    0x0020:  00000000 62313130 39625f31 3139302e     [....b1109b_1190.]
    0x0030:  37313200 00000000 00000000 00000000     [712.............]
    0x0040:  00000014 41313030 33303030 5f303030     [....A1003000_000]
    0x0050:  30304330 30000000                       [00C00....       ]
    
    ==== Unknown Section ================================================
    Section ID:               UD    Section Length:     0000009c
    Version:            00000002    Sub_type:           00000004
    Component ID:       00003100
    
    Raw Section Data:
    0x0000:  00003300 2f6f7074 2f666970 732f6269     [..3./opt/fips/bi]
    0x0010:  6e2f6475 6d707379 7374656d 00000000     [n/dumpsystem....]
    0x0020:  00000000 00000000 00000000 00000000     [................]
    0x0030:  00000000 00000000 00000000 00000000     [................]
    0x0040:  00000000 00000000 00000000 00000000     [................]
    0x0050:  00000000 00000000 66697073 3731322f     [........fips712/]
    0x0060:  62313130 39625f31 3139302e 37313200     [b1109b_1190.712.]
    0x0070:  00000000 00000000 00000001 00000002     [................]
    0x0080:  00000804 00000005 0000000f 000131cc     [..............1.]
    0x0090:  00000000                                [.....           ]
    
    ==== Machine Type ===================================================
    Model/Type:         8406-71Y (tttt-mmm)
    Serial Number:      108B7AA
    
    ==== Unknown Section ================================================
    Section ID:               SW    Section Length:     00000014
    Version:            00000002    Sub_type:           00000001
    Component ID:       0000f000
    
    Raw Section Data:
    0x0000:  00000b00 00030008 00000001              [.............   ]
    
    ==== RTAS Event Dump (3) End ========================================

    For information associated with the primary reference codes in each RTAS event logged in the /var/log/platform file, search for the reference code in Knowledge center.