README.1ST - 24 May, 1995 (Version 2.01 maintenance release)

This text is provided as an ASCII formatted overview of the TCP/IP Subnet Assistant, Version 2.01. It contains system requirements, pre- install information, and last minute information that is not in the User Guide.

Version 2.0 (released 11 April, 1995) contained two major operational bugs that caused v2.01 to be developed. As v2.01 is a maintenance level upgrade no functional changes were implemented to the v2.0 code. The SETUP program flow was altered to better accommodate necessary changes (detailed below.) Both the online help file and the User's Guide contain minor changes to reflect the new version number.

-----------------------------------------------------------------------
Changes implemented between v2.0 and v2.01:
-----------------------------------------------------------------------

* SETUP1.EXE failed to copy necessary DLL and VBX files unless a prior version of the file in question existed on the destination drive. The controlling IF-block was corrected.

* WIPASST.EXE aborted with an overflow or an "Invalid Property Value" error after certain combinations were saved to the INI file. Though this particular error was noted in the v2.0 release notes the error was far more common than initially believed. The fix simply corrected the processing of parameters input from the INI file.

* SETUP1.EXE modified to allow copy of all files to a common path in the event an installation uses a non-updateable shared system directory.

* SETUP1.EXE improperly tracked progress of a virus scan program during the setup process. The correct INI parameter block is now searched.

Except for these changes, v2.01 remains operationally identical to v2.0.


COPYRIGHT and DISCLAIMER


TCP/IP Subnet Assistant
Copyright 1994 - 1997 David B. Stewart

THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, AND IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Permission to use, copy, and distribute this software and its documentation for any purpose other than its commercial exploitation is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice, disclaimer, and this permission notice appear in supporting documentation, and that the name of author not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The author makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

Author: David B. Stewart (72440.2467@compuserve.com)

SYSTEM REQUIREMENTS

DISK SPACE REQUIRED

The installed software requires approximately 1.1 MB of disk space when considering the necessary DLL and VBX files. Should your system already have COMMDLG.DLL, VBRUN300.DLL, CMDIALOG.VBX, and GRID.VBX installed, the product will require only 0.5 MB of disk space.



SYSTEM RECOMMENDATION

Windows version 3.1 (or above) is required. DOS 6.x is recommended, but not necessarily required. The program has NOT been tested on a PC having less than 4 MB of memory, though it may be able to operate on systems with less memory.

**NOTE**

As of this writing, the program has been successfully installed on Windows 3.1, Windows for Workgroups 3.11 (DOS 6.21), and Windows NT 3.5 workstations. Attempts to install via SETUP.EXE onto a Windows 95 final Beta release system have failed. Later Beta builds (yes, there is life after "final" beta) of Windows 95 code have not been tested.



INSTALLATION

HANDLING OF EXISTING SYSTEM FILES

SETUP installs new copies of COMMDLG.DLL, VBRUN300.DLL, CMDIALOG.VBX, and GRID.VBX files. NO BACKUP COPIES ARE MADE by the SETUP program. You are encouraged to make your own backup copies of these system files prior to installing the TCP/IP Subnet Assistant v2.0. If existing copies of the files are found on the destination system, the SETUP program will simply warn you and ask whether the existing files should be overwritten. If you answer "NO", the files are skipped and installation continues.

PREVIOUS INSTALLATIONS

SETUP installs program and documentation files under the same names as used in the previous version. Any previous copies or earlier versions of these files will be overwritten if found in the selected destination path.

EXECUTING SETUP

Installation of the described software implies acceptance of terms of the copyright and disclaimer as set forth, above.

The SETUP program creates a new Program Manager group (WIPASST.GRP) and installs the program and on-line documents into the new group. After installation, you may manually move items to another group, if you wish.

** NOTE ** NOTE ** NOTE ** NOTE ** NOTE **

Should the Program Manager group count be at the maximum allowed number of groups, SETUP may install the v2.01 files into the STARTUP.GRP. In this case, WIPASST.GRP will not be created...no room for it. Should this occur, you must manually move the icons into an appropriate group for your applications. This limitation is expected to be addressed at a future release.

  1. UNZIP the distribution file (WIPAV201.ZIP) to either a blank floppy diskette or a separate subdirectory (i.e. C:\DISK1) on your hard disk.
  2. From Windows (File -> Run) execute SETUP.EXE from your installation path (floppy or C:\DISK1)
  3. Follow the prompts from SETUP.
  1. If a virus scanner is detected on disk, you will be prompted to automatically execute the scanner. Accept the reminders about virus scan (execution of a scanner, if found, will terminate this pass of SETUP; scan will be skipped the next execution of SETUP). Should you choose not to execute the scan, you will be prompted again in step "f", below.

  2. Accept the copyright terms to continue installation.

  3. If prompted, enter the source path for installation files. (default is A:\)

  4. Enter the target path for installed files. (default is C:\WINDOWS)
    Version 2.01 provides a check-box allowing necessary *.DLL and *.VBX files to be written to the chosen target path should your \WINDOWS\SYSTEM or \WINDOWS path(s) be shared network directories to which you may not have write access.

  5. When installation is complete you will be prompted to read the User Guide (you may choose "Print" from WRITE.EXE).

  6. If a virus scanner was detected and the scan was skipped in step "a", above, you will be prompted one last time to execute the virus scan.

  1. Remove installation media.
IN CASE OF SETUP FAILURE

If for some reason SETUP fails to copy necessary files you may use the \WINDOWS\EXPAND.EXE program to uncompress the product files. Compressed files are identified by the underscore "_" in the third character of the file extension (e.g. GRID.VB_). To expand the files manually from the DOS prompt, use the following example (modify for the appropriate file name)...

C:> EXPAND -R GRID.VB_

This example assumes GRID.VB_ is in the current directory and the output file (GRID.VBX) will be expanded to the current directory. Be certain to use the "-r" option to ensure proper renaming of the output file.

SETUP normally renames WIPASST2.* to WIPASST.* and README.1ST to WIPAREAD.1ST to avoid conflict with previously installed "read me" files. You may wish to do the same if you are faced with a manual install.

VBX/DLL VERSION INCOMPATIBILITY

Should you chose _not_ to overwrite existing DLL or VBX files, you may get an error message indicating a particular file is not compatible with the WIPASST.EXE program. The message will indicate the faulty file by name. If you experience this, simply re-run SETUP and select "YES" when queried about overwriting the system file in question. This should not occur if you chose to place all files in a common directory as the appropriate files will be present for WIPASST.EXE.



FEATURES

DOCUMENTATION

A complete "User Guide and Tutorial" document is delivered in Windows WRITE.EXE format. The help file was developed largely from the User Guide. At the end of the SETUP process, the installer is prompted to view the on-line documentation. If selected, WRITE.EXE is spawned and the User Guide is presented. The installer may print the document at that time, if so desired.

v1.0 BUGS FIXED

* removed default beep on screen update
* video attributes for "bits", "class", "address range" and "base subnet" fields
* tab ordering

NEW FEATURES

* installation via Windows SETUP.EXE
* installation can auto-execute F-PROT, Virucide, or Microsoft Antivirus (if found)
* familiar drop down menus
* display list of subnets or host addresses
* print hardcopy of list (single sheet)
* standard Windows print dialog
* next/previous subnet hot-keys
* option to allow use of subnet "zero"
* subnet partitioning (pseudo classes)
* default IP class values (per RFC 1597)
* user preferred defaults
* values from previous session are saved
* limited copy & paste functions 
* slide bar adjustment of IP address input

KNOWN LIMITATIONS

* "Print to File" option from print dialog is ignored
* print does not support landscape mode

KNOWN BUGS

* occasionally loses track of class or mask data with pseudo-class
* change of default network options doesn't always re-calculate w/o prior selection of Class-A default