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 * * 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 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 or ALL distribution, commercial purchase requests need to be sent to 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: 267 Hillwood Street Martinez, GA 30907 Compuserve: 72321,366 (706)-780-2671