++++++++++++++++++

++++++++++++++++++
++ Event Reader ++
++ ++
++ created by ++
++ ++
++ Tony Edman ++
++++++++++++++++++
++++++++++++++++++

+++++++++++++++
+ Description +
+++++++++++++++
This is a tool that can be used to monitor for "SYSTEM RESTART", "SOFTWARE
ERROR" or "APPLICATION ERROR" printouts from the Ericsson AXE telephone switch.
If one of these printouts occur the program can automatically collect all
detailed information about the fault and log it to a file and optionally send
the collected data to an FTP server for storage.
This can be very useful at times, especially during system test of new software
releases where the system is stressed by introducing congestions to be able to
find software faults, which results in many software event printouts.
Without printing out the detailed information about the event with the command
SYRIP:EVENT=xx; the buffers for storing this information in the AXE will
overflow which results in the possible loss of important information needed to
be able to find the faults and fix them.
The buffers in the AXE can store a maximum of 4 events each of the types RESTART
and FORLOPP and 8 events of type APPLERR. After all event positions have been
used up without being printed with command SYRIP the last event of each type
will be overwritten which results in loss of data needed for trouble shooting.
This tool uses WINFIOL (version 6 and higher) for communicating with the AXE
and it waits for one of the following printouts from the AXE:
SOFTWARE ERROR DATA
SYSTEM RESTARTED
When one of the printouts have been received the program will order WINFIOL to
send the command SYRIP:EVENT=xx; or SYRIP:EVENT=xx,PRINT=yyyy; to the AXE and
then the program will log the received data into a log file stored on disk.
The program can also optionally send the collected log files to an FTP server
for remote storage.

++++++++++++++++
+ Requirements +
++++++++++++++++
Operating system: Windows 95, 98, Me, NT, 2000, XP
Other software: WinFiol version 6 or higher (with COM support)

+++++++++++++++++++++++++
+ Configuration Options +
+++++++++++++++++++++++++
Most of the program options can be configured though the program itself by
using menu File->Configure.
All program options are stored in an INI-file normally called EventReader.ini
which is usually stored in the same directory as the program itself.
There are a few options that can currently only be changed by manually editing
the INI file with a normal editor like notepad.
The options that must be manually edited are the following:
WinfiolName=EventReader
ExternalEditorFileName=notepad.exe
UseWinfiolAutoSend=0
BypassBuggyWinFiol=1
The above parameters are used for the following reason:
WinfiolName
-----------
Name of the current running copy of the Event Reader reported to WinFiol.
If multiple copies of the program is running at the same time on one PC then
each copy of the program must have a unique name otherwise WinFiol will behave
strange.
ExternalEditorFileName
----------------------
Name of program to use for editing event log files and debug information files.
The default value is notepad.exe, if another program should be used instead of
notepad.exe then enter the full program path including directory and ".exe".
Example:
ExternalEditorFileName=C:\PROG1\KEDIT\KEDITW32.EXE
UseWinfiolAutoSend and BypassBuggyWinFiol:
------------------------------------------
Both of these parameters are options I have added to the program because of
(in my opinion) bugs in the COM implementation of WinFiol which causes the
EventReader to not work properly.
The recommended settings for these are "BypassBuggyWinFiol=1" to make the
event reader not wait for an event from WinFiol that a prompt have been received
send a release towards the AXE when an ORDERED printout have been received for a
command. It seems WinFiol always does an automatic release no matter if I tell
WinFiol not to that and it doesn't notify the program that a prompt have been
received.
The recommended setting for "UseWinfiolAutoSend=0" to make the program control
the checking for prompts etc. instead of relying on WinFiol to automatically
doing this. By having it set to 1, i.e. letting WinFiol handling it, the program
stops working after a while because WinFiol stops responding to Connect orders.
The program seems to be much more stable by using value 0 instead of 1 for this
parameter.

Then there are a few options that can not be changed by the user from inside
the program itself and should NOT be manually changed in the INI file.
These parameters are controlled automatically by the program and manually
changing them in the INI file might cause strange program behavior.
These are the following :
ProgramCRC32=1081855742
FormVersion=0
Flags=0
ShowCmd=1
PixelsPerInch=96
MinMaxPos(1024x768)=-1,-1,-1,-1
MinMaxPos=-1,-1,-1,-1
NormPos(1024x768)=28,20,611,411
NormPos=28,20,611,411
Visible=0
The following command line options can be used when starting the program:
ini-file-name
-------------
If specified on the command line the program will read configuration options
from this INI file instead of the default EventReader.ini stored in the program
directory.
Example:
C:\Program Files\LTESoftware\EventReader\EventReader.exe MSC23.ini
This will read the configuration options from the file MSC23.ini in the program
directory.

++++++++++++++++
+ Installation +
++++++++++++++++
Install the program by running the provided SETUP.EXE file and follow the
instructions on the screen.
After the installation have been completed start WinFiol and either create a new
channel file or modify the two provided example files called
"EventReader APG40 Port 5001.chn" and "EventReader IOG20 Port 5001.chn"
and change the IP-address towards the AXE you will be using.
The only important to remember is to keep the "Channel Name" under the General
tab and the channel file name (i.e. the file with extension .chn) the same and
that the "Channel title from" under the Appearance tab set to "channel name".
The Event Reader rely on the fact that these have been set correctly.
For example:
If the file name for the channel file is called
"C:\Program Files\Element Management\ChnFiles\Event Reader @ Localport 4711.chn"
then the "Channel name" should be set to "Event Reader @ Localport 4711" and the
"Channel title from" should set to "channel name".
The only other important thing to remember is that the AXE port that is used for
the event reader receives the software error and restart printouts from the AXE.
There are a number of ways this can be done.
1) Either printout category (PRCA) 32 is defined to be routed to the port being
used. See commands IOROP, IOROL and IOROI.
2) If IOG20 or APG40 is used then connect to port number 5001,5011,5101 or 5111
and not to port 23,5000,5010,5100 or 5110.
3) If APG40 is used it is also possible to connect to port 23 if the "-a"
parameter is used for the mml command i.e. use "mml -a" instead of just "mml"
when connection to the AXE.

++++++++++++++++++++++++++++
+ Uninstalling the program +
++++++++++++++++++++++++++++
To uninstall the program just open the control panel and run the program
"Add/Remove Programs" and select "Event Reader" from the list.

+++++++++++++++++++++++
+ Contact Information +
+++++++++++++++++++++++
If you have any questions about the program or ideas for improvements etc.
please send an email to the following address:
Tony.Edman@ericsson.com