---------------------------------------------------------------------

This file is additional information by:
Colin Seymour                  | Tel. +44 181 848 6551
CRL, Dawley Road, Hayes,       | Fax. +44 181 848 6565
Middx. UB3 1HH, United Kingdom | Internet: cseymo@thorn-emi-crl.co.uk

---------------------------------------------------------------------
Utility: Windows Sockets Net Watch - Alpha version 13 - 95.02.11
         Displays state of network hosts and allows remote
         logins to displayed hosts by "point and click".

Author:  WS_WATCH is Copyright 1995 by the author John A. Junod.
         (All rights reserved).
---------------------------------------------------------------------

Source of WS_WATCH:  Anonymous ftp from host:  129.29.64.246
                                   Directory:  pub/msdos

See the author's WS_WATCH.TXT file for documentation and update info.

This file created 26/1/95 for Alpha version 11
Updated 27/1/95 (Undocumented editing facilities described, & various
minor corrections), 30/1/95 minor corrections + more info about
netwatch.db file format.
Updated for Alpha version 13, 13/2/95.


Installing WS_WATCH with a database configured for local requirements
---------------------------------------------------------------------

The author's documentation is in WS_WATCH.TXT
On-line help is available by selecting Help on the main
menu (The help file WS_WATCH.HLP need only
be in the \WS_WATCH directory to be accessible).

The author's files (including the above) are packed in
the WS_WATCH.ZIP distribution file.

The WS_WATCH.ZIP file should be unpacked using PKUNZIP
or a compatible archive unpacking program.
For example: Copy all the distribution files to a suitable
directory (e.g. C:\WS_WATCH), and in DOS type PKUNZIP WS_WATCH
Another well known shareware unpacker running in Windows
is called WinZip, which is (R) and copyright Nico Mac Computing Inc.
There is also Info-ZIP's self-extracting package for decompressing
.ZIP files available from public domain FTP sites; distributed
as UNZ512X3.EXE for DOS running on 386+ PC-compatibles;
plus other unzipping utilities too numerous to mention.

To install, run Windows file manager.  Locate the WS_WATCH.EXE file
in the directory WS_WATCH and drag it with the mouse on to a suitable
Program Manager group where you want the WS_WATCH icon;
this automatically installs the correct icon for WS_WATCH.

Run the WS_WATCH program by double clicking on your new group
icon.  Use the options menu to select appropriate settings.

Users may prefer to set up and distribute their own WS_WATCH.INI
file tailored to local requirements.  The locally adjusted version
of the WS_WATCH.INI file can be stored in the WS_WATCH directory.
If you then copy your file from the WS_WATCH
subdirectory to your Windows directory before running WS_WATCH,
you will get the locally adjusted settings, otherwise 
WS_WATCH will create a default .INI file in the Windows directory.


Description
-----------

WS_WATCH monitors routing hosts on the TCP/IP (Internet)
network.  Every so often it checks to see if each host in
its database is responding.  Initially the hosts are shown
in yellow in a graphic display.  If they respond to a check,
they turn green.  If there is an error, they turn red.
There is also an indeterminate state where they stay yellow
if they have failed to respond at least once;
they will turn red after a pre-determined number of failures
to respond (Consult the on-line help for further information).
Hosts turn red if they are responding slowly, i.e. slower
than the timeout period set in the options menu.

The value of this utility is that you can see whether failure
to connect via the Internet is due to a gateway machine being
down (an error condition may mean several things, but if
the machine is down, that will certainly show as an error).
It also serves as a handy graphical method of logging in
as a remote terminal to a displayed host.

The netwatch.db file contains details of the routing computers
on the TCP/IP network, and should be edited for local requirements.

If you use the sample netwatch.db file supplied in the .ZIP
file, it is really valid only for local conditions at the
author's network.  The netwatch.db file is kept in the
WS_WATCH directory.

Read WS_WATCH.TXT for author's information about the utility.

Editing the netwatch.db file for local requirements may be
done using facilities built in to the utility
(see Additional Editing Facilities).  It can also be edited
with a text editor, but this method is more prone to error
and the built-in facilities are easier to use.

Extracts from a sample netwatch.db file are shown below:

T NETWATCH - DB ver 94.10.22
Bnetwatch.bmp
Hlocalhost,127.0.0.1,Loopback,CRL,10,280,0,1
Hgblink,146.101.128.1,uknet link m/c,?,140,280,0,1
HCanterbury2,146.101.3.2,Canterbury2.GB.EU.net,External router,290,105,0,1
Hlinx-gw...,146.101.28.2,linx-gw.GB.EU.net,External router,290,420,0,1
N12,270,280,140,280
N12,290,105,270,105
N12,140,280,10,280
N12,290,420,270,420
N12,270,595,270,35

The first line is version information.
The second line relates to the author's other software and is not
thought to be used by the present version of WS_WATCH (Alpha v. 13).
There is a netwatch.bmp file in the authors's NETWATCH utility
(which is a completely separate application from WS_WATCH).
The lines starting with "H" describe hosts, and contain fields for
name, IP address, description, location and displayed screen
coordinates.  The lines starting with "N" are records for the lines
that make up the graphic display but otherwise do not affect the
function of the program with respect to the active host checking
process.
Specifying the IP address 127,0,0,1 for the local machine will work
for any machine that WS_WATCH runs on, since this is the standard
"loopback" IP address.  You do not therefore need a separate local
IP address for each machine that WS_WATCH runs on.


Additional Editing Facilities
-----------------------------

The author's 12/12/94 development history quotes:
  "Check out the menu available by RIGHT clicking on a host or the
   screen.  The NETBEUI option is NOT complete, nor is the New->Line
   menu item.  The EDIT mode will eventually disappear. Not all
   menu items work yet...."

Documentation is in fact now being added in WS_WATCH
distributions for these facilities in the on-line Windows help file.

As the author barely has time to work on the program, there is
unfortunately very limited documentation from the horse's mouth.
We can, I suspect, expect further interesting developments in
WS_WATCH.  It is a very useful utility which, in the
event of local network problems, can save Internet users a lot of
time, and the graphical Telnet feature can also save time.
Consequently support for WS_WATCH such as this file is in my
opinion well worth giving.

Further details in support of WS_WATCH documentation are given below.

Some of these details may vary, depending on a specific system
configuration.

There are some very useful facilities available through the mouse
(This description is based on a system running
Windows for Workgroups 3.11 with Microsoft
TCP/IP and WIN32s 1.20).

Click right on a host, in the upper left corner, and
you will get a menu:

    ----------
    New
    Delete
    ----------
    Connect
    Ping
    Traceroute
    ----------
    Properties
    ----------

Delete gets rid of the host (you still have to use edit mode to
delete lines).  Connect activates Telnet (a reference to your Telnet
program is needed in the Options menu) so you can log in to any of
the displayed hosts.
Ping and Traceroute are grayed, but can be accessed anyway on the
Tools menu-
Ping doesn't work on my machine - can't find ICMP.DLL
Traceroute has the same behaviour (this "ICMP support" DLL is
specific to Windows NT and Windows 95, so don't expect it to work on
Windows for Workgroups).
Properties allows you to edit the information associated with the
host (so it isn't actually necessary to edit the .DB file unless you
want to change the order in which hosts are checked, which follows
the order in which their lines appear in the file).

Click right elsewhere on the screen, and the menu appears with only
New enabled, which allows you to place new hosts.

Click left on a host and a list of host information is displayed
(which varies with the system platform and setups you are running)
Double click left on a host displays the same information plus
Flags information (may be ACTIVE, or some number: meaning is unknown
to me).


Updating hosts information
--------------------------

Network hosts may change, and the .DB file needs to be kept
up to date to correspond with what is actually on the
network.  To verify Internet connectivity, you need to have the
machines on the routing path out of your local network on display.

Routing outside any particular location, such as CRL, is likely to
change (as is the network inside a location) and may be different
from day to day.  The further the host is along the route,
the more likely it is to vary according to the destination
address.  So there is little point in displaying routing nodes
past the first external connection, unless you want to use
WS_WATCH to telnet to external hosts (which could be very useful!).

Information on the hosts may be obtained (if you have
Microsoft TCP/IP-32) by using the tracert program in a
Windows DOS box (not in real mode DOS, it will crash);
by using the traceroute facility built in to WS_WATCH itself,
if you have ICMP support; or by other similar utility programs which
will vary slightly from one platform to another.

Using a sufficiently far destination will show up all
the local routing.  E.g. for users in the UK, tracert 149.171.248.9
which is the University of New South Wales.
Make a note of the first few host IP numbers and names,
and update the WS_WATCH database accordingly.
Additional hosts can be added using the editing facilities
of WS_WATCH (see under Additional Editing Facilities), or by
copying one of the lines in the .DB file starting with H,
then using the WS_WATCH program to move the new graphic to
a suitable new location and adding a line to the
"network" picture.


Example Table of sample IP addresses for tracert route analysis
---------------------------------------------------------------

These are selected as various "compass headings" from London
and similar examples may be found by searching the FTP sitelist
file, which can be obtained by anonymous ftp from
                 Site: garbo.uwasa.fi 
                 Dir:  /pc/doc-net/ftp-list.zip

Suitable "compass headings" will obviously vary depending on
where you are.  At my location, I found that most communications
went through one particular external router, but a different one
came into use when communicating between London and Scotland.

"NW"
193.4.210.1      complex.is                 Iceland
"NE"
193.71.1.7       ftp.eunet.no               Norway
"N"
129.215.112.130  ftp.ed.ac.uk               Edinburgh
130.209.240.50   dcs.gla.ac.uk              Glasgow
"W"
134.226.32.15    ftp.cs.tcd.ie              Ireland
134.226.81.10    ftp.maths.tcd.ie           Ireland
192.48.96.9      ftp.uu.net                 New Jersey
16.1.0.1         decwrl.dec.com             New Jersey
"SW"
146.155.1.43     malloco.ing.puc.cl         Chile
"SE"
193.127.1.2      ftp.eunet.es               Spain
130.206.1.2      archie.rediris.es          Spain
149.171.248.9    keystone.arch.unsw.edu.au  Australia
"E"
129.69.18.15     ftp.uni-stuttgart.de       Germany
129.20.254.2     archie.univ-rennes1.fr     France


Bug Reports
-----------

Bug reports should be sent as instructed by the author of the
utility, also, I suggest you quote the following technical
details to enable accurate bug diagnosis:

   WS_WATCH version, e.g. A13, 95.02.11
   Your personal details and email address
   Description of bug and circumstances when it appeared
   Program options selected (particularly type of ICMP ping)
   Copy of your personalised .DB file
   Description of your PC, DOS version,
   free space on disk, type of graphic display,
   version of Windows, Virtual memory setup,
   type of Windows Sockets software and version,
   Windows memory (quoted in Program Manager About box)
   Network settings e.g. Microsoft Windows Network v. 3.11
                         Novell Netware (Workstation Shell 3.X)
   Type of network card
   Network drivers used
   Netware version, e.g. if you are using Novell Netware,
   you can get information from the Netware Version utility such as:
     NETWARE VERSION UTILITY, VERSION 3.12:
     NetBIOS Protocol Specification:  V-2.0
     IPX Version: 3.16
     SPX Version: 3.16
     LAN Driver:   V0.00
     Shell:       V3.32 Rev. A
     Novell NetWare v3.11 (250 user) (8/9/91)
   Other networks will have different features but will likely have some
   means of displaying version information.


DISCLAIMER

  Neither the Author or the Author's employers accept any liability
  should any person incur expense or damage by following these
  guidelines.

