Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

LogRecord class

The LogRecord class represents a log entry in the BMC system event log (SEL).

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties and methods are in alphabetic order, not MOF order.

Syntax

[Provider("IPMIPrv"), Dynamic]class LogRecord : CIM_RecordInLog
{
  string Caption;
  string CreationClassName;
  string Description;
  string ElementName;
  string LogCreationClassName;
  string LogName;
  string MessageTimeStamp;
  string RecordData;
  string RecordFormat;
  string RecordID;
};

Members

The LogRecord class has these types of members:

Properties

The LogRecord class has these properties.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64) , Dynamic

Short string designating the type of event. This property is inherited from CIM_ManagedElement.

Based on SEL byte 3, the logged event can be one of the following types:

  • System

    Concatenation of sensor type (SEL byte 11), Assert or Deassert (SEL byte 13, bit 7), and the event description (translated from SEL byte 14 -16, Event Data according to IPMI version 1.5 specification).

    Example of a normal system event: "Temperature Assert: Upper Non-critical - going high"

    Example of a shutdown event: "OS Stop / Shutdown Assert: OS Graceful Shutdown"

    Example of a bluescreen error event: "OS Stop / Shutdown Assert: Run-time Critical Stop"

  • OEM

    OEM events have a fixed value of "OEM SEL".

  • Other

    An event type other than system or OEM has a fixed value of "Invalid SEL".

CreationClassName
Data type: string
Access type: Read-only

Fixed value: "LogRecord". This property is inherited from CIM_LogRecord.

Description
Data type: string
Access type: Read-only

Description based on the type of record and event description. This property is inherited from CIM_ManagedElement.

Based on SEL byte 3, the logged event can be one of the following types:

  • System

    Concatenation of sensor name, sensor device ID, Sensor Number, Owner LUN, Owner ID, sensor type, entity ID, entity instance "Assert" or "Deassert", and the event description.

    Example of a normal system event: "CPU1Temp(10.0.32): Temperature for Processor 1; Assert: Upper Non-critical – going high"

    Example of a shutdown event: "(0.0.65): OS Stop / Shutdown for Unspecified 0; Assert: OS Graceful Shutdown"

    Example of a bluescreen error event: "(0.0.65): OS Stop / Shutdown for Unspecified 0; Assert: Run-time Critical Stop"

  • OEM

    OEM events have a fixed value of "OEM SEL".

  • Other

    An event type other than system or OEM has a fixed value of "Invalid SEL".

ElementName
Data type: string
Access type: Read-only

Fixed value: "IPMI SEL Record". This property is inherited from CIM_ManagedElement.

LogCreationClassName
Data type: string
Access type: Read-only

Fixed value: "LogRecord". This property is inherited from CIM_LogRecord.

LogName
Data type: string
Access type: Read-only

Fixed value: "IPMI SEL". This property is inherited from CIM_LogRecord.

MessageTimeStamp
Data type: string
Access type: Read-only

Time when the record is saved in CIM datetime format. This property is inherited from CIM_LogRecord. For more information about CIM datetime format, see Date and Time Format.

Example: "20040924152230.000000-480"

Example of non-timestamped OEM SEL and invalid SEL records: "19700101010000.000000-480" (a default value of 00:00:00 Jan 1, 1970 local time)

RecordData
Data type: string
Access type: Read-only

Event data that the LogRecord reports. System events may be normal events, shutdown events, or bluescreen error events.

The RecordData string contains the following:

  • Delimiter character

    The first character in the string is a delimiter character. This character divides the remainder of the string into data substrings.

  • Substrings

    Each substring contains the data of the corresponding RecordFormat substring.

The following IPMI Record Types for operating system SEL events are possible.

Operating system SEL eventIPMI record type

Operating system shutdown

0xDD

Operating system bluescreen error

0xDE

Operating system bootup

0xDC

 

This property is inherited from CIM_LogRecord.

RecordFormat
Data type: string
Access type: Read-only

A free-form string with a delimiter character that specifies how to interpret the RecordData of the LogRecord instance.

The RecordFormat string contains the following:

  • Delimiter character.

    The first character in the string is a delimiter character. This character divides the remainder of the string into format substrings.

  • Substrings.

    Each substring is a declaration with a datatype and a property name. The substrings are used to interpret the RecordData value, which uses the same delimiter.

For example, using a "*" delimiter, a RecordFormat value of"*string ThisDay*uint32 ThisYear*datetime <some time>" may be used to interpret the RecordData value as "*This is Friday*2002*20020807141000.000000-300".

For system events, the value of RecordFormat contains:

*string CIM_Sensor.DeviceID
*uint8[2] IPMI_RecordID
*uint8 IPMI_RecordType
*uint8[4] IPMI_Timestamp
*uint8[2] IPMI_GeneratorID
*uint8 IPMI_EvMRev
*uint8 IPMI_SensorType
*uint8 IPMI_SensorNumber
*boolean IPMI_AssertionEvent
*uint8 IPMI_EventType
*uint8 IPMI_EventData1
*uint8 IPMI_EventData2
*uint8 IPMI_EventData3*

For timestamped OEM events, the value of RecordFormat contains:

*uint8[2] IPMI_RecordID
*uint8 IPMI_RecordType
*uint8[4] IPMI_Timestamp
*uint8[3] IPMI_ManufacturerID
*uint8[6] IPMI_OEMDefinedData*

For non-timestamped OEM events, of RecordFormat contains:

*uint8[2] IPMI_RecordID
*uint8 IPMI_RecordType
*uint8[13] IPMI_OEMDefinedData*

For invalid events with a record type other than OEM SEL or system events (see Caption property), the value of RecordFormat contains:

*uint8[2] IPMI_RecordID
*uint8 IPMI_RecordType
*uint8[13] IPMI_RecordData*

This property is inherited from CIM_LogRecord. For an example that shows RecordFormat and RecordData values, see the Remarks section. For more information about the SEL record formats and for the description of each field, refer to section 26 in IPMI v1.5 rev 1.1 specification.

RecordID
Data type: string
Access type: Read-only

Sequential number reflecting the order in which the records are read. The numbers start at 1 for the 1st entry in the SEL and continue sequentially to n, the number of entries in the SEL. This property is inherited from CIM_LogRecord.

Example: "16"

Remarks

The following example shows the relationship between RecordFormat and RecordData for a system event LogRecord instance and an operating system shutdown event LogRecord instance.

System SEL Event

The RecordFormat string is "*string CIM_Sensor.DeviceID*uint8[2] IPMI_RecordID*uint8 IPMI_RecordType*uint8[4] IPMI_Timestamp*uint8[2] IPMI_GeneratorID*uint8 IPMI_EvMRev*uint8 IPMI_SensorType*uint8 IPMI_SensorNumber*boolean IPMI_AssertionEvent*uint8 IPMI_EventType*uint8 IPMI_EventData1*uint8 IPMI_EventData2*uint8 IPMI_EventData3*".

The RecordData string is "*SEL(114.0.32)*01 00*02*0F AC C1 49*20 00*04*10*72*true*6F*02*FF*FF*".

RecordFormatRecordDataMeaning
*string CIM_Sensor.DeviceIDSEL(114.0.32)The ID of the sensor device that generated this event is 114.0.32.
*uint8[2] IPMI_RecordID01 00The ID of this SEL Record is 1.
*uint8 IPMI_RecordType02The record type of this event is "System Event Log".
*uint8[4] IPMI_Timestamp0F AC C1 49The event timestamp is 3/19/2009 2:21:03 AM.
*uint8[2] IPMI_GeneratorID20 00The ID is an I2C Slave Address, 0x20. This event message was received through the system interface, primary IPMB, or was internally generated by the BMC. The IPMB device LUN is 0x0.
*uint8 IPMI_EvMRev04Event Message format version is IPMI v1.5/v2.0.
*uint8 IPMI_SensorType10The SensorType code that generated this event is 10,Event Logging Disabled.
*uint8 IPMI_SensorNumber72The number of the sensor that generated this event is 114.
*boolean IPMI_AssertionEventtrueThis is an assertion event.
*uint8 IPMI_EventType6FThe event type of this event is a sensor-specific. The sensor class is discrete.
*uint8 IPMI_EventData102Event request message data.
*uint8 IPMI_EventData2FFEvent request message data.
*uint8 IPMI_EventData3FFEvent request message data.

 

Operating system shutdown SEL event

The RecordFormat string is "*uint8[2] IPMI_RecordID*uint8 IPMI_RecordType*uint8[4] IPMI_Timestamp*uint8[3] IPMI_ManufacturerID*uint8[6] IPMI_OEMDefinedData*".

The RecordData string is "*03 00*DD*7B FE C4 49*37 01 00*00 00 00 00 C0 00".

RecordFormatRecordDataMeaning
*uint8[2] IPMI_RecordID03 00The ID of this SEL Record is 3.
*uint8 IPMI_RecordTypeDDThe record type of this event is "Timestamped OEM SEL" record.
*uint8[4] IPMI_Timestamp7B FE C4 49The event timestamp is 3/21/2009 2:49:31 PM
*uint8[3] IPMI_ManufacturerID37 01 00The manufacturer ID is 311, which is the IANA enterprise number for Microsoft.
*uint8[6] IPMI_OEMDefinedData00 00 00 00 C0 00The OEM defined data is a Windows Shutdown Reason: C0000000.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003 R2

Namespace

\root\hardware

MOF

Ipmiprv.mof

See also

IPMI Provider

 

 

Show:
© 2014 Microsoft. All rights reserved.