*******************************************************************************
*   W A N S T A T                                                             *
*   LAN/WAN Statistics Logger                                                 *
*                                                                             *
*    Version: 1.20b                                                           *
*    http://www.officenet.hu/utils/wanstat                                    *
*******************************************************************************

   Member of Winners Circle at Novell Developers' Contest, 1st round:

     A strong and secure SMTP/POP3 implementation, a unique Pegasus Mail
    Gateway and a powerful list server: these are the key features of
    Niagara Mail Server. Consider also the easy management through NetWare
    Administrator and the built-in Anti-SPAM capability, making this smart
    mailer a perfect choice for your network. Detailed product description
    and a downloadable evaluation version can be found on our web page:

     http://www.officenet.hu/niagara

*******************************************************************************


Contents
--------

1. Installation
2. Usage guidelines
3. Log file format
4. Copyright and licensing information
5. Registering your copy
6. Technical support
7. Contacting us
8. History


1. Installation
---------------

Pkunzip the compressed original distribution archive file, and copy the
WANSTAT.NLM into sys:system directory on your destination server.
Server needs to be NetWare 4.11 or any newer version. Bindery emulation
is not required nor used.


2. Usage guidelines
-------------------

First, load WANSTAT in the board listing mode:

  LOAD WANSTAT

WANSTAT will display a list of available LAN/WAN boards, with a board
number at the beginning of every line in the list.
Decide what boards you want to include in the log, and invoke WANSTAT
in the logging mode:

  LOAD WANSTAT [UTC] [DBF] [TXT] [DISPLAY] [30M|60M|3H|6H|12H|24H] brdnums ...

Parameters:
- UTC forces the timestamp values in the log file to be expressed in UTC
  instead of local time.
- DBF turns on logging in xBASE (*.dbf) file format
- TXT turns on logging in plain text (*.txt) file format
- DISPLAY turns on logging to the console screen
- 30M causes logging to happen at every 30 minutes (default setting)
- 60M causes logging to happen at every hour
- 3H causes logging to happen at every 3 hours
- 6H causes logging to happen at every 6 hours
- 12H causes logging to happen at every 12 hours
- 24H causes logging to happen at every day
- brdnums ... are the board number values determined from the first step.

  LOAD WANSTAT HELP

Will display the parameter list and explanation above, then unload itself.

Example:
  LOAD WANSTAT DBF DISPLAY 3H 1 3 4

WANstat will be logging traffic for board numbers 1, 3 and 4 in DBF format
at every 3 hours.

Log files are stored in the sys:etc/wanstat directory, which will be
created automatically if does not exists.

Log file update will be occuring when:
- loading  WANSTAT in logging mode, the line will be ended with a "(starting)"
  remark;
- unloading WANSTAT, loaded previously in logging mode, the line will be ended
  with a "(shutdown)" remark;
- the specified interval elapses.

--- Important note ---

WANstat uses several new functions which may not be available in the
original out-of-the box NetWare product. You have to apply the latest
support pack on your server, or WANstat may refuse to load with undefined
public symbol errors.

Also, loading CLIBAUX.NLM prior to loading WANstat may be required,
especially on NetWare 4.x versions. Novell does not recommend autoloading
this NLM for 3rd party developers, that's why you are required to load it
manually. You can do so from AUTOEXEC.NCF, as other applications may also
require this NLM to be loaded. CLIBAUX.NLM is included with the latest
support packs, or it is available as a separate download (CLIBAUX1.EXE)
from Novell's ftp site.


3. Log file format
------------------

Here is a sample log file from our test server:

NW411_EII: Tx 4429 kB, Rx 1378 kB at 13/09/1997 05:48:57 (starting)
NW411_EII: Tx 4444 kB, Rx 1384 kB at 13/09/1997 06:00:01
NW411_EII: Tx 5579 kB, Rx 1832 kB at 13/09/1997 06:30:01
NW411_EII: Tx 18754 kB, Rx 2526 kB at 13/09/1997 07:00:00
NW411_EII: Tx 18867 kB, Rx 2560 kB at 13/09/1997 07:30:01
NW411_EII: Tx 18877 kB, Rx 2560 kB at 13/09/1997 08:00:00
NW411_EII: Tx 18898 kB, Rx 2572 kB at 13/09/1997 08:13:51 (shutdown)

- NW411_EII is the name of the board, as shown in Monitor under
  LAN/WAN information;
- the value following Tx means Total bytes sent;
- the value following Rx means Total bytes received;
- the time is expressed in local time (UTC was not specified), or
  in UTC (UTC was specified).

If you load WANstat with the DBF parameter, the log files will be created as
xBASE (*.DBF) files using the following structure:

    Field       Type   Length   Decimals   Remarks
    ___________________________________________________________________
    INTERFACE   Char     18
    DATE        Date
    TIME        Char      8                 hh:mm:ss
    EVENT       Char      1                 L=load, T=timer, S=shutdown
    RECEIVED    Num      18        0
    SENT        Num      18        0


4. Copyright and licensing information
--------------------------------------

This version of WanStat is freeware. You can use the software on any number
of servers. You can also give the software to other people in it's original
distribution form, with every component in the original compressed archive.


5. Registering your copy
------------------------

If you have downloaded WANstat from our web site, you are already
registered. Otherwise, we kindly ask you to write an e-mail to
"WANSTAT Registration" <support@officenet.hu>. Please include the
following informations:

Name:            ................................................
Company:         ................................................
Country:         ................................................
Email address:   ................................................

Product:         LAN/WAN Statistics Logger v1.20b
Comments:        ................................................
                 ................................................

Note: your data will be held protected, and will not be given out
to anyone. We also hate spam, like you.


6. Technical support
--------------------

Limited support is available only for registered users, via e-mail.
We always try to offer excellent technical support for our products.
Reported issues are being investigated and discovered bugs are
corrected as necessary. However, in case of freeware utilities like
WANstat, we can't even guarantee that you will receive a response
from us.
See the following section on how to contact us.


7. Contacting us
----------------

Company: Office-Net Kkt.
Address: Futar u. 17.
         H-1131 Budapest
         Hungary
Phone:   +36-30-951-2479
Fax:     +36-30-980-2479
Email:   support@officenet.hu
Web:     http://www.officenet.hu

Please use the email address shown above for your technical support
questions.

8. History
----------

 9th Mar 2000   v1.20b  Minor bugs fixed
                        Clarified CLIBAUX requirement in this readme.txt
27th Dec 1999   v1.20   NetWare 5.1 Ready
			Login name no longer required
			Bindery emulation no longer required
			xBase and TXT log file formats made optional
			logging interval can be selected from 30 mins to 24 hours
24th Nov 1998	v1.10	Added optional xBASE (*.DBF) log file format
                        Displaying on the server console made optional
			No longer works on NetWare 3.x
21st Jan 1998	v1.01	Split into 3.x/4.x versions because of Clib differences
27th Nov 1997	v1.0	Initial release


------------------------------------------------------------------------------
                        Last updated on 9th March 2000
                     Copyright (c) CamaSoftware 1997-2000
               Portions Copyright (c) Office-Net Kkt. 1997-2000
                             All Rights Reserved
