NAME

       ipmctl-show-error-log - Shows thermal or media errors on the specified PMem modules

SYNOPSIS

           ipmctl show [OPTIONS] -error (Thermal|Media) [TARGETS] [PROPERTIES]

DESCRIPTION

       Shows thermal or media errors on the specified PMem modules.

OPTIONS

       -a, -all
           Shows all attributes.

       -h, -help
           Displays help for the command.

       -ddrt
           Used to specify DDRT as the desired transport protocol for the current invocation of
           ipmctl.

       -smbus
           Used to specify SMBUS as the desired transport protocol for the current invocation of
           ipmctl.

           Note
           The -ddrt and -smbus options are mutually exclusive and may not be used together.

       -lpmb
           Used to specify large transport payload size for the current invocation of ipmctl.

       -spmb
           Used to specify small transport payload size for the current invocation of ipmctl.

           Note
           The -lpmb and -spmb options are mutually exclusive and may not be used together.

       -o (text|nvmxml), -output (text|nvmxml)
           Changes the output format. One of: "text" (default) or "nvmxml".

TARGETS

       -dimm [DimmIDs]
           Filter output to specific PMem modules by optionally supplying one or more comma
           separated PMem module identifiers. The default is to include all manageable PMem
           modules.

PROPERTIES

       SequenceNumber
           Error log entries are stored with a sequence number starting with 1 and rolling over
           back to 1 after 65535. Limit the error log entries returned by providing a sequence
           number. Only errors with a sequence number equal to or higher than provided will be
           returned. The default is 1.

       Level
           Severity level of errors to be fetched. One of:

           •   "High": High severity errors (Default)

           •   "Low": Low severity errors

       Count
           Max number of error entries to be fetched and printed. The default is 8 for media
           errors and 16 for thermal errors.

EXAMPLES

       Show all high thermal error log entries

           ipmctl show -error Thermal Level=High

       Show all low media error log entries

           ipmctl show -error Media Level=Low

LIMITATIONS

       To successfully execute this command, the specified PMem modules must be manageable by the
       host software. In addition, for PMem modules with firmware version 2.3 and above, errors
       due to AIT operations are no longer exposed.

RETURN DATA

       Prints errors of the specified type for the specified PMem modules. If no errors are
       found, the following message will be printed:

           No errors found on PMem module (DimmID)

SAMPLE OUTPUT

            DimmID | System Timestamp    | Error Type
           =============================================================
            0x0001 | 01/01/1970 00:00:20 | 0x04 - Locked/Illegal Access
            0x0001 | 01/01/1970 00:00:21 | 0x04 - Locked/Illegal Access
           Show error executed successfully

           ---DimmID=0x0001---
              ---Error=Thermal
                 System Timestamp=08/09/2021 05:12:27
                 Temperature=84
                 Reported=High
                 Temperature Type=Media Temperature
                 Sequence Number=1

           ---DimmID=0x0001---
              ---Error=Media
                 System Timestamp=01/01/1970 00:00:22
                 Error Type=0x04 - Locked/Illegal Access
                 Transaction Type=0x0B - CSR Write
                 Error Flags=0x02 - DPA Valid
                 DPA=0x0000000000020A40
                 PDA=N/A
                 Range=4B
                 Sequence Number=1