This document shows you how to install, and start the KTOOLS Software (WA) for a variety of popular IBM-PC operating systems. See the README.TXT file for a description of the program. The four operating systems covered in this document are: 1) DOS (Version 4.0 and higher) 2) Windows 3.1 or 3.11 hosted by DOS 3) Windows 95 4) OS/2 In this document we use the convention where string is something to be entered with the keyboard. If the string entered is a command to the operating system, a Carriage Return (CR) key is assumed to be pressed after you enter the string. The convention [name] is used to identify things by literal name (like names of icons and menu items). *************************** * Notice for Down Loaders * *************************** If you downloaded this program from a BBS or from the internet, you will need to make an installation diskette before you can install the program correctly. Use the PKUNZIP program to unzip the file onto a 1.44Mb floppy ************** * In General * ************** Installation of KTOOLS on your hard drive only adds a new directory tree, it does not effect any other files on your disk including your AUTOEXEC.BAT and CONFIG.SYS files. If your have previous versions of the software, you can use the same directory name to upgrade the program. ***************************** * DOS Version 3.x and later * ***************************** ->-> INSTALL <-<- 1) Put the program diskette in drive A: or B: and change the default drive to the diskette typing or . 2) Type and press the Enter key to install the software to the PATH you specify. For example, if you wanted KTOOLS to be installed the C:\KTOOLS directory type: . 3) The installation will copy all the necessary files from the diskette and create the pathname you specify along with several subdirectories for support files and sample input files (see the Packing List) 4) Run the program and select the Setup/Weather Data menu from either NEAT or MHEA to install selected weather data files for your location. The separate 'Weather Data' disk is used in this step. ->-> START <-<- 1) Log to the directory containing the KT.EXE file by typing where path is the name of your NEAT directory. If you are running the program for the first time, you may want to view the contents of the README.TXT file. This file is in simple ASCII format so you can use your favorite word processor or text editor to view this file. It contains last minute notes not found in the on-line help material. 2) Type to start the program. 3) You can now run either the NEAT or MHEA programs, or get overview help from the openning screen. To bypass the openning screen and run one of the programs directly, type either or . 3) Use the Setup main menu in the program to specify the directory pathnames where you want the program to look for input data and where to write its results. Default data and output directories are created during installation. However, you can use this feature to locate your data and output results in any directory path (true for NEAT only). ************************************** * Windows 3.1 or 3.11 hosted by DOS * ************************************** ->-> INSTALL <-<- If you are running Windows 3.1 or higher in 386 Extended mode, you can run KTOOLS from a DOS window. If you would like to install KTOOLS as a program item, a program information file (.PIF) and icon file (.ICO) are provided. To install KTOOLS as a program item: 1) Exit Windows and follow the instructions for DOS (above). 2) When installation is complete, start windows and select the program group you want to install KTOOLS in (e.g. Double click on the [Applications] program group). 2) Choose [File/New] from the Program Manager main menu. 3) Type as the Description String; type as the command string; and type for the working directory (or whatever you labeled the directory at installation). Windows will assign a default 'DOS' icon and add this as a program item. 4) Chose [File/Change Properties] and press the [Change Icon] button. A message about 'no icons available' will appear ignore it and press the OK button. 5) An icon change window will appear. Type , where 'C:\KTOOLS' is the drive and path where you installed the software. The KTOOLS icon will be assigned. 6) Run the program by double clicking the KTOOLS icon. The first time you run the program (NEAT or MHEA) be sure to use the Setup/Weather Data menu to install selected weather data files for your location. The separate 'Weather Data' disk is used for this step. ->-> START <-<- 1) Open the program group where you have installed KTOOLS and double click on the icon to start the program. 2) If you have not installed KTOOLS into a program group you can still run the program from Windows. Open the [Main] Window folder and double click on the MS-DOS icon to open a full screen DOS window. Change directories to the KTOOLS directory and type KTOOLS to run the program. You should be able to use the regular and keys to navigate between KTOOLS and your other Windows applications. Be sure to see the note about Windows delays. WARNING: WHEN YOU EXIT FROM KTOOLS AFTER A WORKING SESSION, WINDOWS 3.1x MAY TAKE A LONG TIME TO RELEASE THE MEMORY ASSIGNED. THIS LONG WAIT (UP TO 1 MINUTE) MAKES IT APPEAR THAT YOUR COMPUTER HAS CRASHED. BE PATIENT AND WINDOWS WILL RETURN EVENTUALLY. WARNING: WINDOWS CAN EXHIBIT STRANGE SYMPTOMS IF THE GRAPHICS MODE USED BY A FULL SCREEN DOS-BOX APPLICATION DOES NOT MATCH THE GRAPHICS MODE USED BY WINDOWS. IF YOU WANT TO SWITCH BACK AND FORTH BETWEEN KTOOLS AND OTHER WINDOWS APPLICATIONS WHILE KTOOLS IS RUNNING, YOU MUST MATCH THE GRAPHICS MODES. KTOOLS USES STANDARD VGA (640X480X16 COLOR) ON STARTUP. *************** * Windows 95 * *************** ->-> INSTALL <-<- 1) Double click on [My Computer] icon. 2) Double click on the [Control Panel] folder. 3) Double click on the [Add/Remove Programs] icon. 4) Click the [Install] button. 5) Place the installation diskette into drive A: You must have a 1.44Mb high density disk drive as drive A: since Windows 95 only looks for installation programs on the first diskette or CD-ROM drive. 6) Windows 95 should find the A:\INSTALL.BAT file. Press the edit key on your keyboard and add the desired path name so it reads: A:\INSTALL.BAT C:\PATH where C:\PATH is the name of the disk drive and path name where you want the program installed. For example, if you want the program installed in the KTOOLS directory of your C drive, type 7) Press or click on [Finish] to begin installation. 8) Windows will open a DOS box and run the installation program and copy all files to the path you have specified. When the file copy stops, click on the [X] button in the upper right corner of the window to close the DOS box. 9) Close the [Control Panel] folder. 10) Open the folder you just installed. 10) Run the program by double clicking the KTOOLS 'MSDOS' short cut icon. You can edit the 'properties' of this shortcut (use the right mouse click) and replace the icon with the KTOOLS icon in the same folder. The first time you run the program (NEAT or MHEA) be sure to use the Setup/Weather Data menu to install selected weather data files for your location. The separate 'Weather Data' disk is used for this step. ->-> START <-<- 1) From the [My Computer] icon, double click on the drive where you have installed the program. 2) You should see a folder for the program. Double click to open the folder. 3) If you are running the program for the first time, view the contents of the README.TXT file by double clicking on the [Readme] icon. 4) To start the program double click on the MS-DOS shortcut icon. 5) See the Windows95 help for instruction for adding a 'shortcut' to the 'Start/Programs' menu if you want KTOOLS to appear in that menu. *********** * OS/2 * *********** ->-> INSTALL <-<- 1) Double click on [OS/2 System] icon. 2) Double click on the [Command Prompts] folder. 3) Double click on the [DOS Window] or [DOS Full Screen] icon. 4) Install as you would under DOS. Switch to the A: or B: drive and type where C:\PATH is the directory path name where you want to install the program. 5) When the installation batch file is completed, close the DOS window by typing . 6) Can stop at this point, and simply run KTOOLS from the [DOS Full Screen] command prompt, or you can migrate the application and have OS2 assign it a program object and folder. 7) To migrate KTOOLS, Open the [OS/2 System] icon and double click on the [System Setup] icon. 8) Double click on the [Migrate Applications] icon. In the check box area, only check the [DOS programs] box. Then press [Find]. 9) OS/2 will look through all of your directories for programs. Click on the [Add programs] button and scan through the list of available programs (it will likely appear near the bottom of the list). 10) If you find KTOOLS.EXE in the list, click on it, and then click on the [Add] button (KTOOLS will appear in the list of selected programs on the right side of the screen. Press [Ok] to leave the [Add programs] form. 11) A folder called [Additional DOS Programs] should appear on your desk top (if you don't already have such a folder). 12) Run the program and select the Setup/Weather Data menu from either NEAT or MHEA to install selected weather data files for your location. The separate 'Weather Data' disk is used in this step. ->-> START <-<- 1) If you have migrated the KTOOLS application to OS/2, simply open the [Additional DOS Programs] folder and double click on the KTOOLS DOS icon. 2) If you have not migrated KTOOLS, then double click on [OS/2 System], and open the [Command Prompts] folder. Double click on [DOS Full Screen], then change directories to the KTOOLS directory and type to start the program KTOOLSRNING: OS/2 CAN EXHIBIT STRANGE SYMPTOMS IF THE GRAPHICS MODE USED BY A DOS-BOX APPLICATION DOES NOT MATCH THE GRAPHICS MODE USED BY OS/2. IF YOU KTOOLSNT TO SWITCH BACK AND FORTH BETWEEN KTOOLS AND OS/2 WHILE KTOOLS IS RUNNING, YOU MUST MATCH THE GRAPHICS MODES. KTOOLS USES STANDARD VGA (640X480X16 COLOR) ON STARTUP.