		      WINPE System Event Log Viewer - Release Notes
		         Copyright (c) 2007-08, Intel Corporation
			          All Rights Reserved
			             April 10, 2008

The WINPE system event log (SEL) viewer utility is a WINPE-based application program 
used for displaying data from the BMC's system event log.


RELEASE NOTES FOR SEL Viewer VERSION v2.0.1 Build 1

A. SUPPORTED PLATFORMS

    S3210SH, X38MLST, S5400SF, S5000 series and S7000FC4U.


B. DEPENDENCIES
   
   1. Executes under the WinPE command Shell.
   2. Operating systems supported are: Windows 2003 32 bit & EM64T, Longhorn 32bit & EM64T, WINPE 1.5, WINPE 1.6, WINPE 2.0         and WINPE 2.1.

   
C. CHANGES SINCE THE PREVIOUS RELEASE

   1. Supporting Windows 2003 32 bit & EM64T, Longhorn 32bit & EM64T, WINPE 1.5, WINPE 1.6, WINPE 2.0 and WINPE 2.1
   2. Supporting the new INI file format suggested by TME.


D. Installation Procedure and how to use WINPE SEL Viewer utility

The SEL Viewer is meant to be used as a WinPE application on a Microsoft 
Windows Preinstallation Environment* server. 

The WINPE SEL Viewer utility requires IMBdriver to be installed as a pre-requisite. 

*If end user boots the server using WINDOWS 2003 hard disk - then the hard disk should be installed with IMBdriver by following the below procedure:-
	
	1. Go to the command prompt.
	2. Change directory to the path where SEL Viewer package is present (selview.exe exist).
	3. Go to the IMBDRIVER directory for the appropriate OS installation (x86 or x64).
        4. Run install.cmd as follows:
		install.cmd
	** The IMBdriver installation is not needed if the customized WinPE CD, containing the Intel drivers is used.
	5. Change directory to the path where SEL Viewer package is present (selview.exe exist).

*If end user boots the server using WINPE CD then WINPE CD should have IMB drivers installed. 

Now user can run SEL Viewer application either from the USB key or any external disk containing SEL Viewer release binaries. Also user can't save the SEL entries to a file if the SEL Viewer application is running from CD ROM or if the release folders have read-only attribute. User must check this before trying save operation.

The following is the procedure to execute the WINPE SEL Viewer utility:

   1. GUI interface

      The SEL Viewer is invoked by entering the following command at a WINPE prompt:
   
   	selview	


   2. Command-line interface

      The SEL Viewer can be run as a command-line application for some of the actions that
      it performs, including clearing the SEL or saving SEL contents to a file.

               selview [SEL File Name] [Options]

      a. To view the command-line help:

                selview /h   

      b. To save the SEL entries to a file in text format:

                selview log.sel /save
		
      c. To save the SEL entries to a file in hex format:

                selview log.sel /save /hex

****Note: End user needs to ensure that read-only attribute is disabled for SEL Viewer utility's release folders before running SEL Viewer utility application. If the release folders are read-only, user needs to disable the read-only attribute of all the inner folders and all the files in the release folder except hrs.ini, selhelp.txt and ReleaseNotes.txt files.

If still user couldn't able to save the SEL entries to a file, it is wise to do the following:
		1. Create a directory on your USB key or external hard disk,
		2. Copy SEL Viewer release files to the above created directory.
		3. Ensure that all the files are available in the folder. See section E for reference.
		4. Run SEL Viewer application.
****

      d. To clear the SEL entries:

                selview /clear

* In place of '/', user can use '-' also.


E. Required Files


The SEL Viewer utility SHOULD contain the following files and sub directories in the directory from which it is running.

	SELView.exe
	IMBDRIVER (directory)
	imbapi.dll
 	smbios.dll
	seldata.dll
	sel.ini
	selhelp.txt
	enus (directory)
	msvcr71.dll
	msvcp71.dll
	hrs.ini
	hrs.dll.
   


F. KNOWN ISSUES

   None.

G. UNSUPPORTED FEATURES

   None.	

H. INSTRUCTIONS TO END USER
•	Server needs to be updated with the appropriate latest FRUSDR package. SDR repository is essential in translating SEL entries to a Human Readable SEL description.

•	HRS.ini file (in the current directory where SEL Viewer application is running) shouldn't be modified. Any modifications to this file may cause the behavior of SEL Viewer utility un-predictable.

•	If SDR record is not found in the server’s SDR repository for the given SEL event's (Sensor Type, Generator ID and Sensor number) combination, then SEL Viewer utility displays sensor type along with sensor number in place of sensor name field in Human Readable SEL Description. If SDR record is found then SDR string available in SDR record is displayed as sensor name value.

•	If SDR record is not found for the given SEL event's (Generator ID, Sensor number and sensor type) combination then SEL Viewer displays sensor reading and threshold reading values as unspecified in Human Readable SEL description.

•	SDR look up for the given SEL event in SDR repository is based on SEL event’s (sensor number, generator id and sensor type) combination. That means if SEL Viewer couldn't able to locate SDR record for the given SEL event's (sensor number, generator id and sensor type) combination, then SEL Viewer utility won't display Sensor Name/SDR String in GUI as part of decoded SEL string.

•	If SEL Viewer utility couldn't able to find the description string for the given SEL event (sensor type, offset, evd1, evd2 and evd3) combination, then SEL Viewer utility displays the event description for that event as "Unknown Event". If end user feels there should be a valid description for that combination, it should be informed to the developer/TME. Then appropriate string information is added as part of hrs.ini file.

•	If event description for the given SEL event is more than 256 characters:
		- only up to 256 characters displayed, under the event description column of GUI.
		- but the bottom window shows event description completely.

•	HR_SEL.log file contains the information on Type 02 SEL events, which couldn't able to decode by SEL Viewer application. This file is created in the same folder where SEL Viewer application is running.

•	The following are the shortcut keys to be used in SEL Viewer GUI:-
e.g.
		'Alt F' key followed by 'S' key for saving the SEL entries to a file
		'Alt F' key followed by 'O' key for opening the saved SEL file
		'Alt F' key followed by 'x' key for exiting from SEL Viewer GUI , …


 *  Third-party brands and names are the property of their respective owners.