INSTALLING AND CONFIGURING ABEND-ANALYZER 
===================================

File    : abend-analyzer-documentation.txt
Author  : Bob Jonkman bjonkman@sobac.com 
Date    : 3 June 2008 

Copyright 2008 Bob Jonkman and/or SOBAC Microcomputer Services 

This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version. 

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details. 

You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/>. 


Updates
=======

The current version of ABEND-ANALYZER is available from http://sobac.com/sobac/diskfree/


Purpose
=======

ABEND-ANALYZER has been developed to semi-automate the procedure of analyzing
ABEND.LOG files on Netware servers. 

This applies to any installation of NetWare servers where the ABEND logs
need to be checked regularly, and trend data is needed. 

ABEND-ANALYZER is currently a semi-automated process, requiring a
dedicated workstation running ABEND-ANALYZER.BAT as a daily Scheduled Event. 

ABEND-ANALYZER is a combination of scheduled tasks, MS-DOS Batch files and
.AWK programs, providing output as an HTML report and .CSV files. 


Installation
============

1. If GAWK is not installed on the workstation then download GAWK from
   http://gnuwin32.sourceforge.net/downlinks/gawk.php and install according
   to the instructions at http://gnuwin32.sourceforge.net/install.html 

2. UnZIP the AWK programs from ABEND-ANALYZER.ZIP into the "GnuWin32\Share" folder. 

3. UnZIP the Batch programs from ABEND-ANALYZER.ZIP into the C:\bin\batch\
   folder. Creat a file "servers.cfg" is in the C:\bin folder 

4. Ensure that "C:\bin\batch\" is on the executable program path:
   - Select "Control Panel, System, Advanced, Environment Variables"
   - highlight "Path", 
   - click "Edit" 
   - add "C:\bin\batch\;" to the "Variable value" field

5. Ensure that the "AWKPATH" environment variable is set to the
   "GnuWin32\Share" folder:
   - Select "Control Panel, System, Advanced, Environment Variables"
   - click "New" in the System "variables" section
   - type "AWKPATH" in the "Variable Name" field
   - type the fully qualified path to "GnuWin32\Share" in the 
     "Variable Value" field. 

6. Add a Scheduled Task:
   - Select "Start, All Programs, Accessories, System Tools, Scheduled Tasks"
   - select "Add a scheduled task"
   - follow the Scheduled Task Wizard to run ABEND-ANALYZER.BAT daily (or whenever required)
   - Use the "nodisplay" parameter to prevent the report from displaying automatically.

7. Optional: Run the ABEND-ANALYZER.BAT file to create the ABEND-ANALYZER.HTM report
   file, then create a shortcut on the desktop for ABEND-ANALYZER.HTM 

8. Optional: Create a shortcut for ABEND-ANALYZER.BAT on the desktop


End-user Instructions 
===================== 

ABEND-ANALYZER is currently a semi-automated process, requiring a
dedicated workstation running the "ABEND-ANALYZER" scripts as a daily
Scheduled Event. 

1. Log in to th workstation that has the ABEND-ANALYZER scripts
   installed. 

2. Double-click on desktop icon "Report-ABEND-ANALYZER". 

3. For each ABEND log entry, compare the value of the current day's to
   the previous day's value. 

5. Each table in the report can be exported as a .CSV file for further
   analysis in a spreadsheet application.

6. Close the "Report-ABEND-ANALYZER" document. 


Sample SERVERS.CFG
==================

# File      :   servers.cfg
# Purpose   :   Lists servers to be monitored with abend-analyzer.awk
# Author    :   Bob Jonkman bjonkman@sobac.com
# Date      :   10 July 2007
# Note      :   Blank lines and lines starting with # are ignored

server01
server02

# The following server doesn't need checking, it NEVER abends :-)
# server13

===== EOF: SERVERS.CFG ====


(EOF: abend-analyzer-documentation.txt)
