              Windows Sockets Net Watch - 95.08.06

      Copyright (C) 1995 John A. Junod.   All rights reserved.

         PLEASE REVIEW THE ENTIRE CONTENTS OF THIS FILE!!!!
              PLEASE LOOK AT THE WHATSNEW.TXT FILE!!!
               PLEASE LOOK AT THE ON LINE HELP FILE!

     Please also read the additional information in WSWATCH1.TXT
               written by Colin Seymour (THANKS!).

  ***********************************************************************
  ** WARNING: Do NOT monitor host systems that you do not have control **
  ** of without the express permission of the owners of that host!!    **
  ***********************************************************************

  THE INFORMATION AND CODE PROVIDED IS PROVIDED AS IS WITHOUT WARRANTY 
  OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
  PURPOSE. IN NO EVENT SHALL JOHN A. JUNOD BE LIABLE FOR ANY DAMAGES 
  WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS 
  OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF JOHN A. JUNOD HAS BEEN 
  ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 
  **********************************************************************
  *  This program executable, help file and related text files may be  *
  *  used without fee by any United States Government organization,    *
  *  by individuals for non-commercial home use, and by students,      *
  *  faculty and staff of academic institutions.                       *
  *                                                                    *
  *  U.S. Government use: Free                                         *
  *  Non-commercial home use: Free                                     *
  *  Academic use: Free                                                *
  *  All other uses: Contact Ipswitch, Inc. for license information    *
  *                                                                    *
  *  Archive sites:  This program may be included on U.S. Government,  *
  *  academic and non-commercial Internet archive sites and on CD-ROM  *
  *  collections distributed by such sites, provided any charge is     *
  *  solely to recover the cost of distribution.  Any such             *
  *  distribution must contain the complete program, including this    *
  *  file.  Non-commercial Internet archive sites must not be in the   *
  *  business of making a profit from selling hardware, software,      *
  *  information or services.  (SimTel and mirrors authorized)         *
  *                                                                    *
  *  For distribution rights and for all other uses, including         *
  *  all corporate use, please contact Ipswitch, Inc. at               *
  *  <info@ipswitch.com> or (617) 676-5700 for license information.    *
  *  Ipswitch may also be contacted via mail at 81 Hartwell Ave.,      *
  *  Lexington, MA 02173 or fax at (617) 676-5710.                     *
  *                                                                    *
  *  Ipswitch, Inc. develops and sells a family of TCP/IP products     *
  *  for a range of PC platforms: Acadia/VxD for Windows, Piper/IP     *
  *  for DOS and Windows, Vantage/IP for OS/2, the Catipult Netware    *
  *  to TCP/IP gateway, IMail electronic mail for Windows and INews    *
  *  network news for Windows.                                         *
  **********************************************************************

 DESCRIPTION:
 ============
 
   This application provides a graphical means for monitoring the 
   status of selected hosts or network equipment on a network and
   a method of alerting you when those systems have problems.

   The alerts are visual, audio (if you have a sound card) and can
   be to a digital beeper or through any user designed application.

   This application is designed to work on Windows NT or Windows 95.
   It will work on Windows for Workgroups 3.11 if you have Win32s
   installed and one of the supported network stacks.

   WS_WATCH also provides the following tools:

     PING:       Provides the ability to measure round trip time
                 to a remote host as well as provide reachability
                 information.

     TRACEROUTE: Provides the ability to view the network path to
                 a remote host.  (not on all network stacks)

     NSLOOKUP:   Provides the ability to retrieve and view Domain
                 Name Service information.

     WHOIS:      Provides the ability to query WHOIS servers for 
                 user and network information.

     FINGER:     Provides the ability to query hosts for user 
                 information.


 REQUIREMENTS:
 =============

   WS_WATCH requires Windows NT, Windows 95 or Win32s 1.15 (or later)

     Windows NT and Windows 95 come with a WSOCK32.DLL. If you
     use a different vendors stack on these platforms you will
     need to replace the WSOCK32.DLL that comes with the OS.
   
   WS_WATCH on Win32s requires you to have a properly installed 
   WINSOCK.DLL and requires Windows 3.1 or later.
   
     If you are running on Windows 3.x and you don't have a 
     WINSOCK.DLL, I'd suggest getting the the shareware Trumpet 
     Winsock from ftp.trumpet.com.au or buying a vendor supported 
     one from Ipswitch, Inc. or from FTP Software, Inc.
   
   WS_WATCH requires a 386, 486 or Pentium processor. (DEC Alpha version
   is available.)
 

 INSTALLATION:
 =============

   YOU MUST HAVE A PROPERLY INSTALLED WINSOCK.DLL FOR THIS APPLICATION
   TO WORK.  REFER TO YOUR WINSOCK.DLL DOCUMENTATION FOR SETUP!!
 
   1. Create a directory for this program and copy WS_WATCH.EXE, 
      WS_WATCH.HLP and unzip SAMPLE.ZIP to that directory. (NOTE:
      many of the ip addresses in the samples are set to 127.0.0.1)

   2. Create an ICON in any Program Manager group.
      a. Use the File Manager and drag the program into a Program
         Manager group.
      b. Use [F]ile [N]ew in the Program Manager.


 UPDATING FROM PREVIOUS VERSIONS:
 ================================
  
   Just install the new EXE and HLP files.  Don't unzip SAMPLE.ZIP.


 VALID COMMAND LINE OPTIONS:
 ===========================

   Map file may be specified on the command line as in:
     WS_WATCH mymap.db
      

 WHERE TO GET IT
 ===============

 (free restricted use versions)

   ftp://ftp.coast.net/SimTel/win3/winsock/ws_watch.zip 
   ftp://ftp.coast.net/SimTel/win3/winsock/watch95.zip 

   ftp://winftp.cica.indiana.edu/pub/pc/win3/winsock/ws_watch.zip
   ftp://winftp.cica.indiana.edu/pub/pc/win3/winsock/watch95.zip

   on Compuserve in WINCON library 11

   ftp://ftp.usma.edu/pub/msdos/winsock.files/ws_watch.zip
   ftp://ftp.usma.edu/pub/msdos/winsock.files/watch95.zip

   http://www.csra.net/junodj/

 (commercial versions)

   contact Ipswitch, Inc. at (617)-676-5700 or FAX:617-676-5710 or
   by E-Mail at <info@ipswitch.com>   http://www.ipswitch.com/


 SUPPORT
 =======

  ALL beginner support is provided through Compuserve in the WINCON
  area.  Please do NOT send "how do I use ws_watch" questions to the
  author.  I will NOT respond.

  ALL bug reports and suggestions for improvement should be sent to
  <junodj@martinez.ipswitch.com> or <junodj@csra.net>

  ALL distribution, commercial purchase requests need to be sent to
  <info@ipswitch.com>


 BUG REPORTS, SUGGESTIONS, ETC...
 ================================

   Send all bug reports, suggestions, etc to "junodj@martinez.ipswitch.com"
   or to "junodj@csra.net"
  
   If you like this program, let other people know about it!
   Post your comments in comp.protocol.tcp-ip.ibmpc, alt.winsock and
   comp.os.ms-windows.networking.tcp-ip on usenet and places like 
   compuserve, aol and msn.


 KNOWN PROBLEMS
 ==============
 
   Does not work properly with Windows for Workgroups 3.11 with the
     Microsoft TCP/IP 32 installed.

   Traceroute functions will not work on a number of network stacks.
     They WILL work on Windows 95 and Windows NT with the Microsoft
     TCP/IP installed and on WfWg 3.11 with Trumpet Winsock.

   Some network stacks will allow you to exit the program while a
     POLL is in progress.  However, you will end up having to reboot
     your system.  DON'T EXIT WS_WATCH WHEN A POLL IS IN PROGRESS!
     Click on the Stop icon or Abort button and WAIT for the poll 
     to stop before exiting.

   Screen redraw during editing is flakey.  Minimize and restore
     window after editing.

   Netbeui and SNMP monitoring methods are disabled.  Contact 
     Ipswitch about commercial version after Oct 95.

   Internal beeper support is not robust and may lock up when the
     com port is in use.  Default beeper string may need more 
     comma's depending on your beeper.  A failed beeper call will
     not retry.


 BEEPER SUPPORT
 ==============

   Beeper support is brand new and the internal support probably will
   not work properly.  I'd suggest using the external program method
   and writing that support yourself.  A code skeleton for a console
   application BEEPER.EXE is provided.   The presence of a program
   name in the beeper section of the host configuration enables the 
   external program.  Make sure you set the settings in Preferences
   Set Beeper!

   The following infomation is made available to the external 
   program via the command line.

   arg 1:   either DN or UP
   arg 2:   the phone number as specified in the host configuration
   arg 3:   the code as specified in the host configuration
   arg 4:   the ip address of the host

   examples:
     0: beeper.exe 1: DN 2: 8694297 3: 3333 4: 127.0.0.1
     0: beeper.exe 1: DN 2: 8694297 3: 2222 4: 127.0.0.1
     0: beeper.exe 1: UP 2: 8694297 3: 2222 4: 127.0.0.1
 
   The external program is executed with SW_SHOWMINNOACTIVE.

   If you have beep each enabled, the external program is executed
   for each down host.  If it is disabled, it is executed once at
   the end of the POLL using the information from the down host 
   that had the highest numeric priority.

   The beep will not be activated if someone silenced the alarm
   before the beep count is reached.

   The UP message will only be sent if the packets lost is greater
   than beep count when the host comes back alive.

   UP and DN messages use the same priority system.  So it is
   possible to receive an UP message from a high priority host
   and miss a DN message from a low priority host.

   PHONE:    This is the number that is dialed or passed as arg 2
             to the external program.

   COUNT:    This is an exact match of the down count when the beeper
             is activated.  This number SHOULD be greater than 4.  The
             default is 15 greater than the sound activation trigger.
             (sound activation trigger is 4)

   CODE:     This is the number that is sent to the beeper or passed
             as arg 3 to the external program.  When the internal 
             code is used, a prefix of 000 is used for down messages
             and 999 is used for up messages.

   PRIORITY: When using the internal code, only the down host with
             the highest numeric priority is sent to the beeper. The
             same is true of the external program when "Beep Each"
             is not enabled.

 Author
 ======
   John A. Junod          Internet: <junodj@css583.gordon.army.mil>
   267 Hillwood Street              <zj8549@trotter.usma.edu>
   Martinez, GA 30907   Compuserve: 72321,366    
   (706)-780-2671
 

