home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Magazin 1995 November / CD_11_95.BIN / share95 / tools / wswatch / ws_watch.txt < prev    next >
Text File  |  1995-08-06  |  12KB  |  286 lines
  1.               Windows Sockets Net Watch - 95.08.06
  2.  
  3.       Copyright (C) 1995 John A. Junod.   All rights reserved.
  4.  
  5.          PLEASE REVIEW THE ENTIRE CONTENTS OF THIS FILE!!!!
  6.               PLEASE LOOK AT THE WHATSNEW.TXT FILE!!!
  7.                PLEASE LOOK AT THE ON LINE HELP FILE!
  8.  
  9.      Please also read the additional information in WSWATCH1.TXT
  10.                written by Colin Seymour (THANKS!).
  11.  
  12.   ***********************************************************************
  13.   ** WARNING: Do NOT monitor host systems that you do not have control **
  14.   ** of without the express permission of the owners of that host!!    **
  15.   ***********************************************************************
  16.  
  17.   THE INFORMATION AND CODE PROVIDED IS PROVIDED AS IS WITHOUT WARRANTY 
  18.   OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
  19.   THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
  20.   PURPOSE. IN NO EVENT SHALL JOHN A. JUNOD BE LIABLE FOR ANY DAMAGES 
  21.   WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS 
  22.   OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF JOHN A. JUNOD HAS BEEN 
  23.   ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  24.  
  25.   **********************************************************************
  26.   *  This program executable, help file and related text files may be  *
  27.   *  used without fee by any United States Government organization,    *
  28.   *  by individuals for non-commercial home use, and by students,      *
  29.   *  faculty and staff of academic institutions.                       *
  30.   *                                                                    *
  31.   *  U.S. Government use: Free                                         *
  32.   *  Non-commercial home use: Free                                     *
  33.   *  Academic use: Free                                                *
  34.   *  All other uses: Contact Ipswitch, Inc. for license information    *
  35.   *                                                                    *
  36.   *  Archive sites:  This program may be included on U.S. Government,  *
  37.   *  academic and non-commercial Internet archive sites and on CD-ROM  *
  38.   *  collections distributed by such sites, provided any charge is     *
  39.   *  solely to recover the cost of distribution.  Any such             *
  40.   *  distribution must contain the complete program, including this    *
  41.   *  file.  Non-commercial Internet archive sites must not be in the   *
  42.   *  business of making a profit from selling hardware, software,      *
  43.   *  information or services.  (SimTel and mirrors authorized)         *
  44.   *                                                                    *
  45.   *  For distribution rights and for all other uses, including         *
  46.   *  all corporate use, please contact Ipswitch, Inc. at               *
  47.   *  <info@ipswitch.com> or (617) 676-5700 for license information.    *
  48.   *  Ipswitch may also be contacted via mail at 81 Hartwell Ave.,      *
  49.   *  Lexington, MA 02173 or fax at (617) 676-5710.                     *
  50.   *                                                                    *
  51.   *  Ipswitch, Inc. develops and sells a family of TCP/IP products     *
  52.   *  for a range of PC platforms: Acadia/VxD for Windows, Piper/IP     *
  53.   *  for DOS and Windows, Vantage/IP for OS/2, the Catipult Netware    *
  54.   *  to TCP/IP gateway, IMail electronic mail for Windows and INews    *
  55.   *  network news for Windows.                                         *
  56.   **********************************************************************
  57.  
  58.  DESCRIPTION:
  59.  ============
  60.  
  61.    This application provides a graphical means for monitoring the 
  62.    status of selected hosts or network equipment on a network and
  63.    a method of alerting you when those systems have problems.
  64.  
  65.    The alerts are visual, audio (if you have a sound card) and can
  66.    be to a digital beeper or through any user designed application.
  67.  
  68.    This application is designed to work on Windows NT or Windows 95.
  69.    It will work on Windows for Workgroups 3.11 if you have Win32s
  70.    installed and one of the supported network stacks.
  71.  
  72.    WS_WATCH also provides the following tools:
  73.  
  74.      PING:       Provides the ability to measure round trip time
  75.                  to a remote host as well as provide reachability
  76.                  information.
  77.  
  78.      TRACEROUTE: Provides the ability to view the network path to
  79.                  a remote host.  (not on all network stacks)
  80.  
  81.      NSLOOKUP:   Provides the ability to retrieve and view Domain
  82.                  Name Service information.
  83.  
  84.      WHOIS:      Provides the ability to query WHOIS servers for 
  85.                  user and network information.
  86.  
  87.      FINGER:     Provides the ability to query hosts for user 
  88.                  information.
  89.  
  90.  
  91.  REQUIREMENTS:
  92.  =============
  93.  
  94.    WS_WATCH requires Windows NT, Windows 95 or Win32s 1.15 (or later)
  95.  
  96.      Windows NT and Windows 95 come with a WSOCK32.DLL. If you
  97.      use a different vendors stack on these platforms you will
  98.      need to replace the WSOCK32.DLL that comes with the OS.
  99.    
  100.    WS_WATCH on Win32s requires you to have a properly installed 
  101.    WINSOCK.DLL and requires Windows 3.1 or later.
  102.    
  103.      If you are running on Windows 3.x and you don't have a 
  104.      WINSOCK.DLL, I'd suggest getting the the shareware Trumpet 
  105.      Winsock from ftp.trumpet.com.au or buying a vendor supported 
  106.      one from Ipswitch, Inc. or from FTP Software, Inc.
  107.    
  108.    WS_WATCH requires a 386, 486 or Pentium processor. (DEC Alpha version
  109.    is available.)
  110.  
  111.  
  112.  INSTALLATION:
  113.  =============
  114.  
  115.    YOU MUST HAVE A PROPERLY INSTALLED WINSOCK.DLL FOR THIS APPLICATION
  116.    TO WORK.  REFER TO YOUR WINSOCK.DLL DOCUMENTATION FOR SETUP!!
  117.  
  118.    1. Create a directory for this program and copy WS_WATCH.EXE, 
  119.       WS_WATCH.HLP and unzip SAMPLE.ZIP to that directory. (NOTE:
  120.       many of the ip addresses in the samples are set to 127.0.0.1)
  121.  
  122.    2. Create an ICON in any Program Manager group.
  123.       a. Use the File Manager and drag the program into a Program
  124.          Manager group.
  125.       b. Use [F]ile [N]ew in the Program Manager.
  126.  
  127.  
  128.  UPDATING FROM PREVIOUS VERSIONS:
  129.  ================================
  130.   
  131.    Just install the new EXE and HLP files.  Don't unzip SAMPLE.ZIP.
  132.  
  133.  
  134.  VALID COMMAND LINE OPTIONS:
  135.  ===========================
  136.  
  137.    Map file may be specified on the command line as in:
  138.      WS_WATCH mymap.db
  139.       
  140.  
  141.  WHERE TO GET IT
  142.  ===============
  143.  
  144.  (free restricted use versions)
  145.  
  146.    ftp://ftp.coast.net/SimTel/win3/winsock/ws_watch.zip 
  147.    ftp://ftp.coast.net/SimTel/win3/winsock/watch95.zip 
  148.  
  149.    ftp://winftp.cica.indiana.edu/pub/pc/win3/winsock/ws_watch.zip
  150.    ftp://winftp.cica.indiana.edu/pub/pc/win3/winsock/watch95.zip
  151.  
  152.    on Compuserve in WINCON library 11
  153.  
  154.    ftp://ftp.usma.edu/pub/msdos/winsock.files/ws_watch.zip
  155.    ftp://ftp.usma.edu/pub/msdos/winsock.files/watch95.zip
  156.  
  157.    http://www.csra.net/junodj/
  158.  
  159.  (commercial versions)
  160.  
  161.    contact Ipswitch, Inc. at (617)-676-5700 or FAX:617-676-5710 or
  162.    by E-Mail at <info@ipswitch.com>   http://www.ipswitch.com/
  163.  
  164.  
  165.  SUPPORT
  166.  =======
  167.  
  168.   ALL beginner support is provided through Compuserve in the WINCON
  169.   area.  Please do NOT send "how do I use ws_watch" questions to the
  170.   author.  I will NOT respond.
  171.  
  172.   ALL bug reports and suggestions for improvement should be sent to
  173.   <junodj@martinez.ipswitch.com> or <junodj@csra.net>
  174.  
  175.   ALL distribution, commercial purchase requests need to be sent to
  176.   <info@ipswitch.com>
  177.  
  178.  
  179.  BUG REPORTS, SUGGESTIONS, ETC...
  180.  ================================
  181.  
  182.    Send all bug reports, suggestions, etc to "junodj@martinez.ipswitch.com"
  183.    or to "junodj@csra.net"
  184.   
  185.    If you like this program, let other people know about it!
  186.    Post your comments in comp.protocol.tcp-ip.ibmpc, alt.winsock and
  187.    comp.os.ms-windows.networking.tcp-ip on usenet and places like 
  188.    compuserve, aol and msn.
  189.  
  190.  
  191.  KNOWN PROBLEMS
  192.  ==============
  193.  
  194.    Does not work properly with Windows for Workgroups 3.11 with the
  195.      Microsoft TCP/IP 32 installed.
  196.  
  197.    Traceroute functions will not work on a number of network stacks.
  198.      They WILL work on Windows 95 and Windows NT with the Microsoft
  199.      TCP/IP installed and on WfWg 3.11 with Trumpet Winsock.
  200.  
  201.    Some network stacks will allow you to exit the program while a
  202.      POLL is in progress.  However, you will end up having to reboot
  203.      your system.  DON'T EXIT WS_WATCH WHEN A POLL IS IN PROGRESS!
  204.      Click on the Stop icon or Abort button and WAIT for the poll 
  205.      to stop before exiting.
  206.  
  207.    Screen redraw during editing is flakey.  Minimize and restore
  208.      window after editing.
  209.  
  210.    Netbeui and SNMP monitoring methods are disabled.  Contact 
  211.      Ipswitch about commercial version after Oct 95.
  212.  
  213.    Internal beeper support is not robust and may lock up when the
  214.      com port is in use.  Default beeper string may need more 
  215.      comma's depending on your beeper.  A failed beeper call will
  216.      not retry.
  217.  
  218.  
  219.  BEEPER SUPPORT
  220.  ==============
  221.  
  222.    Beeper support is brand new and the internal support probably will
  223.    not work properly.  I'd suggest using the external program method
  224.    and writing that support yourself.  A code skeleton for a console
  225.    application BEEPER.EXE is provided.   The presence of a program
  226.    name in the beeper section of the host configuration enables the 
  227.    external program.  Make sure you set the settings in Preferences
  228.    Set Beeper!
  229.  
  230.    The following infomation is made available to the external 
  231.    program via the command line.
  232.  
  233.    arg 1:   either DN or UP
  234.    arg 2:   the phone number as specified in the host configuration
  235.    arg 3:   the code as specified in the host configuration
  236.    arg 4:   the ip address of the host
  237.  
  238.    examples:
  239.      0: beeper.exe 1: DN 2: 8694297 3: 3333 4: 127.0.0.1
  240.      0: beeper.exe 1: DN 2: 8694297 3: 2222 4: 127.0.0.1
  241.      0: beeper.exe 1: UP 2: 8694297 3: 2222 4: 127.0.0.1
  242.  
  243.    The external program is executed with SW_SHOWMINNOACTIVE.
  244.  
  245.    If you have beep each enabled, the external program is executed
  246.    for each down host.  If it is disabled, it is executed once at
  247.    the end of the POLL using the information from the down host 
  248.    that had the highest numeric priority.
  249.  
  250.    The beep will not be activated if someone silenced the alarm
  251.    before the beep count is reached.
  252.  
  253.    The UP message will only be sent if the packets lost is greater
  254.    than beep count when the host comes back alive.
  255.  
  256.    UP and DN messages use the same priority system.  So it is
  257.    possible to receive an UP message from a high priority host
  258.    and miss a DN message from a low priority host.
  259.  
  260.    PHONE:    This is the number that is dialed or passed as arg 2
  261.              to the external program.
  262.  
  263.    COUNT:    This is an exact match of the down count when the beeper
  264.              is activated.  This number SHOULD be greater than 4.  The
  265.              default is 15 greater than the sound activation trigger.
  266.              (sound activation trigger is 4)
  267.  
  268.    CODE:     This is the number that is sent to the beeper or passed
  269.              as arg 3 to the external program.  When the internal 
  270.              code is used, a prefix of 000 is used for down messages
  271.              and 999 is used for up messages.
  272.  
  273.    PRIORITY: When using the internal code, only the down host with
  274.              the highest numeric priority is sent to the beeper. The
  275.              same is true of the external program when "Beep Each"
  276.              is not enabled.
  277.  
  278.  Author
  279.  ======
  280.    John A. Junod          Internet: <junodj@css583.gordon.army.mil>
  281.    267 Hillwood Street              <zj8549@trotter.usma.edu>
  282.    Martinez, GA 30907   Compuserve: 72321,366    
  283.    (706)-780-2671
  284.  
  285.  
  286.