U.S. Geological Survey WAIS for Windows (WinWAIS) Version 2.4 This floppy or .zip file contains USGS WinWAIS Version 2.4. WinWAIS 2.4 includes bug fixes for problems discovered with the WinWAIS 2.3 release. Considerable new functionality is also included in this release. New for Version 2.4 1. The SLIP dialer has been removed from WinWAIS and established as a separate windows applicaion. WAISDIAL is still called from WinWAIS, but may also br run independently. Several new statements have been added to the SLIP dial scripting language: file ini-filename <-- names a xxx.ini file to be updated during script processing section sectionname <-- names a section within a .ini file that will be updated during script processing set ini-value=capture | speed | port | other-value See the script provided in wais.slp for a Trumpet TCP example. 2. Problems fetching non-text documents from some servers have been fixed. 3. Problems fetching WAIS source descriptions from some servers have been fixed. 4. Horizontal scroll bars have been added to the viewing window. 5. All local server code has been removed from WAIS.DLL. This decreases the size of the DLL. 6. WinSock TCP/IP calls have been rewritten to avoid problems with the "linger" option that seem to plague some winsock implementations. New for Version 2.3. Waterloo TCP has been replaced with Trumpet TCP. There is no longer a separate TCP setup for WinWAIS. SLIP dialing has been rewritten to use Trumpet TCP. The X00 FOSSIL driver is no longer used. The VT100 telnet that was included in prior releases has been moved to a separate application (VTTelnet). VTTelnet is automatically installed during WinWAIS installation. Version 2.3A Bug Fixes: Non text files were truncated when associated with text files of a smaller length when received from some multitype servers. Version 2.2B Bug Fixes: In 2.2A, retrieval for a non text document from a file of less than 29K bytes sometimes caused a null file to be returned. The change button in the source edit window would never allow a change. It required that the old source be deleted, and the new source added. The temp file name passed to filter programs did not include path information from the TMP or TEMP environment variable that is used to place the temporary file on disk. This resulted in the filter program failing to locate the input file. New for Version 2.2A: The WAIS Source window now displays the entire source description, including the technical contact portion of the .src. Up to 500 sources may be displayed per source group (was 100) A list of all WAIS sources cataloged on the Directory of Servers as of 9/15/94 is included in the distribution. This file is named ALLSRC.SRC, and must be manually copied to the target directory. Example: expand b:allsrc.sr_ c:\wais\allsrc.src Bug Fixes: The WAIS, WATSTUB and WINSTUB DLL's have been compiled to access the appropriate DGROUP for each DLL. An updated version of VER.DLL is included in the distribution. This should fix problems encountered by some when installing THREED.VBX New for Version 2.2: Visual Basic Version 3.0 was used to compile WAIS.EXE and WSSETUP.EXE. Earlier versions of some system .VBX and .DLL files must be replaced with versions from this installation. If you get incompatability errors check to make sure you don't have an earlier version of the offending file in a directory included in your PATH statement. Source Groups Information source "groups" have been added. An information source assigned to a particular group is only shown as an available source when the group is selected. This allows you to reduce the length of each set of source listings by assigning only thoses sources related to a particular interest area to each group. For example, a group named SERVERS may be defined to hold only entries for directories of servers. The default group name when WinWAIS is installed is WAIS. Other may be defined by changing the Source Group name in either the Sources Editor or when a new source is displayed after an inquiry. Wais Source Display When a WAIS source is presented in response to searching a directory of servers, a unique viewing window is opened to display the source description. Math Coprocessor Test for the Map Window A warning is issued if an attempt is made to display the spatial searching map on a machine without a hardware math coprocessor. The map takes several minutes to draw when no coprocessor is present. Tempory File Assignments WinWAIS temporary files are now assigned to the directory named in the TEMP or TMP environment variables. Internal Enhancements Memory management now uses Windows subsegment allocation techniques. This reduces the overhead for memory allocation by around a factor of four. Yield functions have been improved in both client and server components. Get next and get previous functions have been completely rewritten to improve memory efficiency. Relevance feedback functions have been completely rewritten to improve memory efficiency. All DLL's have been relinked to use paragraph segment boundaries. Bug Fixes Blank source lines may no longer be added to information source definition files. A HUGE memory leak has been plugged. Phantom button click events when using the tool bars have been fixed. A winsock error code 10042 during close has been fixed. Unresolved Bugs: The setup program still gets confused when installing to network drives. This is the way Microsoft put setup together, and there's really nothing I can do to fix it. Still available from Version 2.1: Support for either an embedded TCP/IP stack or Windows Sockets is included. Setup will ask you to specify the combination of TCPs to be supported. Note that dummy DLLs are placed in your target installation directory for the options that are NOT selected, i.e., a dummy WINSOCK.DLL if Windows Sockets is NOT selected, and a dummy WATTCP.DLL if Waterloo TCP/IP is NOT selected. These must be deleted if you choose to change TCP/IP options by reinstalling WinWAIS. Multiple document types is supported. Online help is available at any time by either selecting help from the menu line or by pressing F1. Still available from Version 2.0: Novell ODI support via the ODIPKT driver developed by Daniel Lanciani. SLIP serial communications support, including an embedded scripting language for dialing and logging onto a SLIP server. (SLIP acccess uses the X00 FOSSIL driver developed by Raymond L. Gwinn. Please be sure to read the LICENSE.TXT file if you use this driver). Direct access to the full set of Clarkson packet drivers. These may be loaded prior to invoking Windows, or may be loaded and accessed dynamically by WinWAIS. Multiple retrieved files management, to allow non-text files to be passed to processing filters. Paint Shop Professional (PSP) is included with this distribution for viewing GIF, TIFF, and a variety of other image formats. Please read the PSP license notice if you choose to use PSP as your imaging filter. USGS spatial searching and an embedded telnet emulator are included within USGS WinWAIS. The various windows and panels have been buffed up quite a bit, and ribbon bars have been added for most commonly used functions. Installation: IF YOU HAVE PROBLEMS RUNNING THE SETUP PROGRAM, A BATCH FILE NAMED UNPACK.BAT IS INCLUDED WITH THE WINWAIS DISTRIBUTION. RUN THIS BATCH FILE TO MANUALLY DECOMPRESS THE INSTALLATION FILES. OTHERWISE: Unzip the distribution file into a convenient directory, or, if you received this distribution on a floppy disk, place the disk in your a: or b: drive. Start Windows From the Program Manager select file/run and enter drive:\path\setup Floppy disk example: a:setup Hard disk example: c:\waisdist\setup Setup will display "c:\wais" as the default installation drive and directory. You may accept this default or change it to something else. Setup will ask you to select TCP/IP installation options. These include whether to support Windows Sockets, the embedded TCP/IP that comes with WinWAIS, and to select packet drivers for inclusion in your destination WAIS directory. You may select drivers at this time, may choose to use other drivers by loading them prior to invoking Windows, or may move drivers to the destination WAIS directory at a later time. The WAIS TCP/IP Setup will only allow you to select drivers that are included in the destination WAIS directory and are defined in the file named WAIS.DRV. (The WAIS.DRV file includes the name of the driver, it's title, and information for formatting parameters that are passed to the driver when it is loaded by WinWAIS.) Setup will decompress the distribution files, place them in your destination directory, and will create a program group and WinWAIS icon. Source code: US Geological Survey wants others to benefit from and further this work. Source code will be provided upon request, subject only to the condition that the USGS must be acknowledged in a Help/About WinWAIS message box that will be displayed by all versions of this program. Also, no copyright or other restriction may be placed on this work. Of course, portions of derived works that originate with others may be copyrighted. Source may be downloaded as follows: >ftp ridgisd.er.usgs.gov (130.11.48.107) >user anonymous >pswd anything >cd software/wais >type binary >get wnwsrc23.zip Unzip as follows: pkunzip -d wnwsrc23 (the -d option is needed to create the various subdirectories) The following files are created in the target directory: readme.txt - this file floppy.bat - makes each subdirectory and compresses executables into the ..\floppy subdirectory cleanup.bat - runs "make clean" in various subdirectories to remove intermediate and executable files The following directories are created subordinate to the directory containing the .zip file: ir - WAIS C code and a makefile that creates WAIS.DLL packet - Clarkson driver source and a makefile that creates the XXX.COM packet drivers used by WinWAIS setup - VB source code for the WSSETUP.EXE module vb - VB source code for the WAIS.EXE module help - rtf format source and bmp files used to create the WAIS.HLP file (compile by running the help compiler: hc31 wais) telnet - VB source code for a telnet emulator that's accessed by WinWAIS. This module may be separately compiled and executed as a stand alone application. lib - a collection of object libraries used during C compilations. These modules are placed here purely as a convenience. util - odds and ends utilities--usually written in qbasic floppy - the place where all the executable and reference files are collected for the distribution version of WinWAIS There are no longer any dependencies on the order in which the various EXEs and DLLs are built. Each makefile may be run as needed to recreate its DLLs or EXEs. They are created in their home directories, and may be moved to \floppy either by hand or by running FLOPPY.BAT. COMPRESS is used to establish the files in \floppy. Here's an example: compress -r wais.dll ..\floppy Please send all comments and suggestions to: tgauslin@isdres.er.usgs.gov Enjoy!!!