SEL Viewer Help 
===============


Overview
=========
The System Event Log (SEL) Viewer displays current system SEL information, saves the SEL to a file, and displays the SEL from a previously saved file.

The SEL Viewer's main window consists of a pull-down menu, a multi-column display window and Window at the bottom that displays the SEL Information.  Use the Alt key to select the menu. The below mentioned keys can be used to select the menu directly
Alt-F: Select File menu
Alt-S: Select SEL Menu
Alt-v: Select View menu
ALT-h: Select Help menu 
To move to the main display window press tab. Prior to selcting a menu item if a SEL Record was selected then pressing tab moves to the same row. Else press Tab and down arrow key to press the select first record.

By left clicking the mouse on menu item ,menu item can be selected . SEL Record in multi-column display window can be selected by left clicking the particular record.

The SEL records read from the server can be viewed in either interpreted format or in raw hexadecimal format.  When the SEL Viewer starts, it loads and displays the SEL records from the server.  If the log is full or there are no SEL entries, this utility displays a message to indicate this.

The pull-down menu allows you to select the main features of the utility.  Use the mouse or Alt and  arrow keys and press the <Enter> key to select a menu item.  

The display window displays the SEL entries read from either the server or a file.  The SEL entries are displayed in a multi-column format when the interpreted mode has been selected from the menu.  Use the arrow keys, <PgUp>, <PgDn>, <Home>, and <End> to scroll around the display window.  To scroll horizontally in the multi-column window, use the function key right arrow key to scroll to the right and left arrow key to scroll to the left.


Displaying SEL Properties
=========================
To display information about the System Event Log from the BMC, select "Properties..." from the "SEL" menu.  The SEL Properties are displayed in a dialog box, which contains the IPMI version supported, number of SEL entries, last add and erase time, and the amount of free space remaining in bytes.  

A warning message, indicating that the log is full, is displayed at the top of the SEL properties dialog box whenever the free space remaining is below 16 bytes.


Clearing the SEL
=================
To clear the event log of the server, from the "SEL" menu select "Clear SEL".  A confirmation window is displayed to allow you to proceed with the command.  Select "OK" to clear the SEL entries or "Cancel" to abort the operation.


Viewing Events from the Log
============================
SEL entries are read from the BMC and displayed when the SEL Viewer is first invoked.  The SEL events can be reloaded by selecting "Reload" from the "SEL menu".

Display Modes
==============
The SEL Viewer supports two display modes, interpreted and raw hexadecimal formats.  In the interpreted format, each SEL entry is decoded and displayed in a textual, interpreted format.  

In the hexadecimal format, each SEL entry is displayed in a raw hexadecimal format, as read from the BMC.  Each hex data value is displayed in brackets and preceded by a key as follows:

	Key   Definition
	----------------
	RID   Record ID
	RT    Record Type
	TS    Time Stamp
	GID   Generator ID
	ER    Event Message Format Revision
	ST    Sensor Type
	SN    Sensor Number
	EDIR  Event Dir and Event Type
	ED1   Event Data 1
	ED2   Event Data 2
	ED3   Event Data 3
	MID   Manufacturer ID
	OEM   OEM defined

Note that hexadecimal format displays all the records including the invalid ones, but interpreted format only displays valid SEL entries.

Sorting SEL Events
===================
SEL events that are displayed in interpreted format can be sorted using the "Sort by" menu item or by clicking on the column heading with mouse.  From the "SEL" menu select "Sort by" and then select a column heading.  Events are sorted in ascending order and they can be sorted by Number, Time Stamp, Sensor Type and Number, Event Description, or Generator ID.

SEL events displayed in hexadecimal format cannot be sorted out.


View/Hide Sel Information Window
=================================
The detailed SEL information can also be viewed in a bottom window also known as SEL information window. From the "View" menu select "View SEL Info Window". A new window which contains the SEL information of the currently selected SEL entry is displayed. The SEL information window can be removed by selecting "Hide SEL Info Window" from the "View" menu.


Saving SEL Events to a File
============================
To save the SEL entries to a file, from the "File" menu select "Save As...".  The SEL entries are saved in the active display format (interpreted or raw hexadecimal).  

When this option is selected, a file dialog box is displayed to allow you to enter a file name and path and extension can be selected. select a file name from a file list, and to browse directories and drives from a directory and drive list.  Use the <Tab> key to move between these options.  Use the left/Up and right/Down arrow keys to move between the file and directory lists, and the <Esc> key to cancel altogether.  The  <Home>, <End>, and left/right arrow keys are supported in the edit box for entering a file name.

SEL entries loaded from a file, cannot be saved to a file.

Viewing a SEL File
==================
To view a SEL file, select "Open..." from the "File" menu.  A similar file dialog box, described in the "Saving SEL Events to a File" help topic, is displayed to allow you to select a file.

The display mode is automatically toggled between text and hex when the SEL entries are read from a file, depending on whether the file contains hex data or text data.

General Help
============
To view help, select "General Help" from the "Help" menu.
Selhelp.txt file will open,which contains all the help information of the utility.

About
=====
To view About, select "About" from the "Help" menu.
About dialog box displayed,which contains release and IPMI version information.