Export (0) Print
Expand All

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_LogRecord
{
  string   Caption;
  string   CreationClassName;
  string   DataFormat;
  string   Description;
  string   ElementName;
  string   LogCreationClassName;
  string   LogName;
  datetime 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)

A short string that specifies the type of event of the log record. This property is inherited from CIM_ManagedElement.

This property contains one of the following values:

ValueMeaning
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 blue screen 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
Qualifiers: Key, MaxLen (256)

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

DataFormat
Data type: string
Access type: Read-only
Qualifiers: Deprecated (CIM_LogRecord.RecordFormat)

Note  This property is deprecate. Instead, we recommend that you use the RecordFormat property.

A description of this data structure.

Description
Data type: string
Access type: Read-only

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

This property contains one of the following values:

ValueMeaning
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

The user friendly name of the log record.

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

LogCreationClassName
Data type: string
Access type: Read-only
Qualifiers: Key, Propagated (CIM_MessageLog.CreationClassName)

The name of the class type of the log record.

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

LogName
Data type: string
Access type: Read-only
Qualifiers: Key, MaxLen (256) , Propagated (CIM_MessageLog.Name)

The name of the record represented by this object.

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

MessageTimeStamp
Data type: datetime
Access type: Read-only
Qualifiers: Key

The datetime that indicates when the recod was saved. 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
Qualifiers: Experimental, ModelCorrespondence (CIM_LogRecord.RecordFormat)

A set of event data to report. 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
Qualifiers: Experimental, ModelCorrespondence (CIM_LogRecord.RecordData)

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
Qualifiers: Key, MaxLen (256)

A sequential number that indicates the order to read the records. 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

DLL

IpmiPrv.dll

See also

IPMI Provider

 

 

Show:
© 2014 Microsoft