INSTALLATION NOTES ================== This file provides important installation information. It is divided into the following major sections: 0. Getting Started 1. Software Requirements 2. Hardware Requirements 3. Foxpro 2.6 for DOS Installation 4. Foxpro 2.6 for Windows Installation 5. Visual Foxpro 6.0 Installation 6. Visual Foxpro 9.0 Installation 7. Foxpro 2.6 for Macintosh Installation 8. Foxpro 2.6 for Unix Installation 9. Network Installation 10. Installing over Existing Application 11. Uninstalling Application 12. Warranty Notice 13. Copyright Notices 14. Freeware Notice 0. Getting Started ================== There is no installation program. After you download MAL.ZIP, create a directory for this application and unzip all files into it. The following is a MS-DOS command line example: C: [Enter] MD \DMAIL4 [Enter] CD \DMAIL4 [Enter] PKUNZIP MAL.ZIP [Enter] ...where "C:\DMAIL4" is the application directory, and "MAL.ZIP" is the pkzip file (you can find an pkunzip.exe at www.pkware.com). 0.1 Application Modules(s) ========================== Your application directory should contain Foxpro 2.6 "*.FXP" program modules ("MAL.FXP" is the startup module), the Visual Foxpro 6.0 version of this application "VMAL.APP", and the Visual Foxpro 9.0. version of this application "VMAL9.APP". 0.2 Application Manual(s) ========================= Your application directory should include two manuals: A user manual called "MAL.MAN" and a configuration manual "MALCFG.MAN". The user manual provides information on application use and data entry. The configuration manual provides information on configuring and customizing this application. When you run this application, you can display/print the user manual by selecting option "M" of the system setup menu. If you are a system administrator, you can display/print the configuration manual from the Foxpro system menu. The Foxpro system menu is activated by pressing [Alt] ([Ctrl]+[Opt] on the Mac, [F10] in Unix). Read the software and hardware requirements. Follow the installation instructions appropriate for your operating system and version of Foxpro. 1. Software Requirements ======================== This Foxpro application REQUIRES either Foxpro 2.6 for DOS, Foxpro 2.6 for Windows, Foxpro 2.6 for Macintosh, Foxpro 2.6 for Unix, Visual Foxpro 6.0 or Visual Foxpro 9.0. Foxpro runtime units are available on the web site http://www.dennisallen.com. Note: Have Foxpro or the Foxpro runtime unit installed BEFORE installing this application. If you have your own copy of Foxpro, FOXUSER?.* resource files are available on the web site www.dennisallen.com. 2. Hardware Requirements ======================== For the Foxpro 2.6 for DOS/Windows runtimes, an IBM personal computer (80386 or better) is recommended. For improved performance, it is highly recommended that the user obtain at least four megabytes of extended memory. A color monitor and a mouse are also recommended. The Foxpro 2.6 for Macintosh runtime requires System 7 or better. An LC III or better is highly recommended. The Visual Foxpro 6.0 runtime requires a Windows 95/NT personal computer. Visual Foxpro 9.0 requires a Windows XP/7/8 personal computer. 3. Foxpro 2.6 for DOS Installation ================================== To run this application, type the following MS-DOS prompt commands: c: [Enter] cd \dmail4 [Enter] c:\foxrun\foxr +x -cc:\foxrun\config.fp mal [Enter] ...where "c:\foxrun" is the runtime directory, "foxr.exe" is the Foxpro 2.6 runtime launcher, "config.fp" resides in the user resource directory "c:\foxrun\", "mal" is the startup application module "MAL.FXP", and "c:\dmail4\" is the application (working) directory. Note: If you don't have a runtime, you must create your own user resource directory. Information on setting up a user resource directory can be found in the configuration manual. A copy of the CONFIG.FP and FOXUSER?.* resource files can be found on the web site http://www.dennisallen.com. 4. Foxpro 2.6 for Windows Installation ====================================== To run this application, you will need to create a link to Foxpro. Create a Windows shortcut icon and modify the properties, as in the following example: Command Line : c:\foxrunw\foxrw.exe -t -cc:\foxrunw\config.fpw mal Working Directory: c:\dmail4\ ...where "c:\foxrunw" is the runtime directory, "foxrw.exe" is the Foxpro for Windows runtime launcher, "config.fpw" resides in the user resource directory "c:\foxrunw\", "mal" is the startup application module "MAL.FXP", and "c:\dmail4\" is the application (working) directory. Note: If you don't have a runtime, you must create your own user resource directory. Information on setting up a user resource directory can be found in the configuration manual. A copy of the CONFIG.FPW and FOXUSER?.* resource files can be found on the web site http://www.dennisallen.com. Shortcut Note: There is a bug in the FPW runtime. If you use the FXP file extension, you need to spell out the file path (example: k:\dmail4\MAL.FXP). Otherwise, the FPW runtime can't find it. Windows Note: This application is designed to use a 24 by 80 character window. It is suggested that you start with a maximized, not minimized, window. Video Mode Note: At a very high resolution, 1024x768 in 256 colors for example, screens may become so big that Foxpro 2.6a for Windows cannot store them and may shut down. If this ever happens, try reducing your resolution. ATI Mach32 Drivers: If you are running Foxpro for windows, you may experience problems with your mach32 drivers set at high resolution. If so, in the [Mach] section of your win.ini file is a DeviceBitMap command. Change the setting from DeviceBitMap=on to DeviceBitMap=off. 5. Visual Foxpro 6.0 Installation ================================= To run this application, you will need to create a link to Foxpro. Create a Windows shortcut icon and modify the properties, as in the following example: Command Line : c:\vfprun\vfpr.exe -t -cc:\vfprun\config.fpw vmal Working Directory: c:\dmail4\ ...where "c:\vfprun" is the runtime directory, "vfpr.exe" is the Visual Foxpro 6.0 runtime launcher, "config.fpw" resides in the user resource directory "c:\vfprun\", "vmal" is the startup application module "VMAL.APP", and "c:\dmail4\" is the application (working) directory. Note: If you don't have a runtime, you must create your own user resource directory. Information on setting up a user resource directory can be found in the configuration manual. A copy of the CONFIG.FPW and FOXUSER?.* resource files can be found on the web site http://www.dennisallen.com. Font Note: This Foxpro 2.6a application works best in a maximized window using the font FOXFONT, 9 pitch. If your WINDOWS\SYSTEM directory does not have FOXFONT.FON, grab a copy from your runtime directory. Or you could try a similar font, such as FIXEDSYS. See video modes in the Foxpro system menu. 6. Visual Foxpro 9.0 Installation ================================= To run this application, you will need to create a link to Foxpro. Create a Windows shortcut icon and modify the properties, as in the following example: Command Line : c:\vfprun9\vfpr9.exe -t -cc:\vfprun9\config.fpw vmal9 Working Directory: c:\dmail4\ ...where "c:\vfprun9" is the runtime directory, "vfpr9.exe" is the Visual Foxpro 9.0 runtime launcher, "config.fpw" resides in the user resource directory "c:\vfprun9\", "vmal9" is the startup application module "VMAL9.APP", and "c:\dmail4\" is the application (working) directory. Note: If you don't have a runtime, you must create your own user resource directory. Information on setting up a user resource directory can be found in the configuration manual. A copy of the CONFIG.FPW and FOXUSER?.* resource files can be found on the web site http://www.dennisallen.com. Font Note: This Foxpro 2.6a application works best in a maximized window using the font FOXFONT, 9 pitch. If your WINDOWS\SYSTEM directory does not have FOXFONT.FON, grab a copy from your runtime directory. Or you could try a similar font, such as FIXEDSYS. See video modes in the Foxpro system menu. 7. Foxpro 2.6 for Macintosh Installation ======================================== This application is compatible with Foxpro 2.6 for Macintosh. Create a folder for this application. Take the file called "MAL.ZIP" and apple file exchange it to the Macintosh. Find and use a utility that can unzip this Pkware ZIP v2.04g file into the application folder. Note: On a Macintosh, you must create your own user resource directory. Since there are no environment variables, you must create your own FOXPRO.INI file. Information on setting up the CONFIG.FPM and FOXPRO.INI files can be found in the configuration manual. A copy of the CONFIG.FPM and FOXUSER?.* resource files can be found on the web site dennisallen.com. UnZipping Note: "CDX", "DBF", and "FPT" files should NOT have Linefeeds. 7.1 Foxpro for Macintosh ======================== When you start Foxpro, perform the following commands: set default to ::dmail4 do mal ...where "::dmail4" is the application folder and "mal" is the startup application name. 7.2 Foxpro for Macintosh Runtime ================================ The Foxpro for Macintosh runtime, called "FOXMAC26.ZIP", can be found on the web site http://www.dennisallen.com. Find this file and apple file exchange to the Macintosh. Find and use a utility that can unzip this Pkware ZIP v2.04g file into the application folder. Move the files FOXFONT and FOXPRINT to your system folder, where fonts are stored. Now add the following lines to your CONFIG.FPM: path = ::dmail4 default = ::dmail4 command = do mal ...where "::dmail4" is the application folder and "mal" is the startup application name. Now when you double-click on FOXMAC26.ESL, your CONFIG.FPM will execute your application. 8. Foxpro 2.6 for Unix Installation =================================== This application is compatible with Foxpro 2.6 for Unix. Create a directory for this application and copy "mal.zip" to it. Use the command "unzip -L -o mal.zip" to extract this Pkware ZIP v2.04g file into the application directory. The "-L" option will leave filenames in lowercase. Note: On a Unix system, you must create your own user resource directory. You must also create your own FOXPRO.INI file. Information on setting up the CONFIG.FPU, and FOXPRO.INI files can be found in the configuration manual. A copy of the CONFIG.FPU and FOXUSER?.* resource files can be found on the web site http://www.dennisallen.com. UnZipping Note: You do not need to remove carriage returns from text files. 8.1 Foxpro for Unix =================== When you start Foxpro, perform the following commands: set default to /dmail4 do mal ...where "/dmail4" is the application directory and "mal" is the startup application name. 8.2 Foxpro for Unix Runtime =========================== Have the Foxpro runtime installed. To run your application, perform the following Unix commands: cd /dmail4 foxr -c/dmail4/config.fpu mal ...where "foxr" is the Foxpro startup script "/usr/bin/foxr", "/dmail4" is the application directory, "config.fpu" is in your user resource directory "/dmail4", and "mal" is the startup application name "mal.fxp". Note: For further information, such as installing Foxpro on a Linux system, read the Foxpro for Unix FAQ sheet found on the web site http://www.dennisallen.com. 9. Network Installation ======================= To make this a multi-user application, simply set the environment variable SET MULT=YES or add MULT=YES to your FOXPRO.INI file. For more information, refer to the configuration manual. In a network environment, you can either configure each work station with it's own user resource directory or create a single copy on the server, to be shared by all users. To share a user resource directory, first create it. Copy files from an existing startup directory. Edit the shared "CONFIG.FP?" file so that "RESOURCE =" is the shared foxuser.dbf file. Finally, change RESOURCE=ON to RESOURCE=OFF. From now on, only the system administrator will be able to change preferences and printer control codes. For more information, refer to the configuration manual. My advice: Whenever you install a local Foxpro runtime, also install a local startup (user resource) directory. While a single copy might be easier to maintain, separate copies will allow each workstation to control individual color/font preferences and printer control codes. Note: On older networks, there is a tendency not to use any memory manager at all. This may result in all network drivers loading into conventional memory, leaving nothing for Foxpro. If starting Foxpro locks up your workstation, ask network support to look at the possibily of increasing conventional memory. 10. Installing over Existing Application ======================================== For most systems, reinstalling over an existing system should not erase existing data files. A more recent version of this application might add fields and rebuild indices. If you are unzipping over an existing application, some files might not have been updated. The most likely cause is files marked read-only. To unzip over these files, you need to first remove their read-only marks. In the application directory, execute the following MS-DOS command: for %f in (*.*) do attrib -r %f Note: Whenever you install over an existing system, there is always a chance of losing data. Always create a backup of existing data before installing or reinstalling any application. 11. Uninstalling Application ============================ Removing this application is simple. Just delete the application directory and all the files contained within it. Some MS-DOS files may be marked read-only. To delete these files, you need to first remove these read-only marks. In the application directory, execute the following MS-DOS command: for %f in (*.*) do attrib -r %f 11.1 Uninstalling Runtime ========================= Removing the Foxpro for DOS/Foxpro for Windows runtime is simple. Just delete the runtime directory and all the files contained in it. Again, some MS-DOS files might be marked read-only. To delete these files, you need to first remove these read-only marks. From the runtime directory, you would execute the previous MS-DOS command. To remove a Visual Foxpro runtime, execute the original VFP runtime installation program. You will see options to add or remove components. Select [Remove All] to remove the Visual Foxpro runtime. To remove a Foxpro for Unix runtime, simply remove all files in the directory /usr/lib/foxpro. Also remove the startup script /usr/bin/foxr. 12. Warranty Notice =================== THIS SOFTWARE IS PROVIDED AS IS. THERE IS NO WARRANTY OF ANY KIND. THE COPYRIGHT OWNER MAY NOT BE HELD LIABLE FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR INABILITY TO USE THE SOFTWARE. BY USING THE SOFTWARE, YOU AGREE TO THIS. 13. Copyright Notices ===================== Foxpro and MS-DOS are registered trademarks of Microsoft Corporation PKSFX self-extractor is a product of PkWare, Inc. JKEY is supplied by Joe Gotthelf EXPRMENU is supplied by Robert A. Pope DDS LINPUT.EXE and XD.EXE were created by Dennis Allen, using HOMONLIB.QLB by Raymond W. Marron. Foxpro MAL v04.09.05 (freeware) (c) 1993-2013 Dennis Allen (http://www.dennisallen.com) All rights reserved 14. Freeware Notice =================== Foxpro MAL v04.09.05 is copyrighted freeware. You may freely copy and distribute this package as long as all the files are included in unmodified form and no fee is charged beyond a reasonable amount for the media and handling. If you wish to bundle this package with your software, you must ask for permission and please mention the package name and copyright somewhere in your product. Foxpro source code is available upon request. Note: To obtain the latest software version, or to make a donation, my web site is http://www.dennisallen.com. If you have any questions, my email address is dennis@dennisallen.com