Chapter 4 : Installation and Setup
Microsoft FoxPro Support Engineers
Microsoft Corporation
Created: December 15, 1993
Abstract
This section discusses the installation and setup of Microsoft FoxPro for Windows version 2.5x, and contains the following topics:
·	Introduction
·	System Requirements
·	Preparing to Install
·	Network Installation
·	Tips for Installation
·	Additional Information
Introduction
Microsoft FoxPro for Windows is an xBase compliant, Database Management System (DBMS) that also has a powerful programming language. FoxPro for Windows is capable of using the code and data from other xBase compatible languages, yet at the same time provides the user with a development environment that is both expandable and powerful. This section discusses the installation and setup of Microsoft FoxPro for Windows version 2.5x. This section is not meant to be a replacement for the "Installation and Configuration" manual supplied with Microsoft FoxPro for Windows.
System Requirements
Minimum Requirements
·	80386 SX or higher processor
·	Microsoft Windows operating system version 3.0 or later running in 386 enhanced mode, with a 2 MB Swap File.
·	4 MB of memory
·	A 5.25" high-density(1.2 MB) or a 3.5" high-density(1.44 MB) floppy diskette drive
·	A 40 MB fixed disk drive (for minimum installation of FoxPro)
·	Microsoft Mouse or compatible pointing device
·	VGA or higher-resolution monitor
Suggested Requirements
·	80386 DX or higher processor
·	Microsoft Windows operating system version 3.1 or later running in 386 enhanced mode, with a 4 MB Permanent Swap File using 32 bit access.
·	8 MB of memory
·	A 5.25” high-density(1.2 MB) or a 3.5” high-density(1.44 MB) floppy diskette drive.
·	An 80 MB fixed disk drive.
·	Microsoft Mouse or compatible pointing device
·	VGA or higher-resolution monitor
Network Requirements
·	Network software that supports NETBIOS
·	Server with a fixed disk
Preparing to Install
Microsoft FoxPro for Windows must have read, write, create, and delete access to the following directories:
·	Root Directory
·	\WINDOWS
·	\WINDOWS\MSAPPS
·	\WINDOWS\MSAPPS\MSGRAPH
·	\WINDOWS\MSAPPS\PROOF
·	\FOXPROW or wherever FoxPro for Windows will reside
NOTE:     If the directories, \WINDOWS\MSAPPS, \WINDOWS\MSAPPS\MSGRAPH, and \WINDOWS\MSAPPS\PROOF do not already exist then the Setup program for Microsoft FoxPro for Windows will create them.
Files Changed During Installation
FoxPro for Windows must be able to modify, rename, and delete the following files:
1)	Root Directory
·	CONFIG.SYS
2)	\WINDOWS
·	WIN.INI
·	REG.DAT
·	VER.DLL
·	TOOLHELP.DLL
·	SHELL.DLL
·	OLESVR.DLL
·	OLECLI.DLL
·	DDEML.DLL
·	COMMDLG.DLL
3)	\WINDOWS\MSAPPS\MSGRAPH
·	GRAPH.EXE
·	MSGRAPH.HLP
4)	\WINDOWS\MSAPPS\PROOF
·	CUSTOM.DIC
·	MSSPELL.DLL
·	MSSPELL.LEX
·	MSSP_BR.LEX
NOTE:     All of the files above, (except for CONFIG.SYS, WIN.INI, and REG.DAT), will only get updated by the Setup program if the copies that are currently on your fixed disk are older than the copies on the FoxPro for Windows installation diskettes.
Details Concerning Changes to CONFIG.SYS, WIN.INI, and REG.DAT
CONFIG.SYS
FoxPro for Windows requires an absolute minimum FILES setting of 40 in your CONFIG.SYS file. If you have a FILES setting of less than 40, then the Setup program gives you the following options:
·	Make modifications for you. The Setup program for FoxPro will modify your CONFIG.SYS file and set the FILES equal to 40.
·	Let you review and edit changes before modifications are made. The Setup program displays both the old and new versions of your CONFIG.SYS file. The new version will have the suggested changes already made. At this point you may make modifications to these changes or discard whatever changes have been made by the Setup program.
·	Let you make modifications later. The Setup program for FoxPro for Windows does not modify your CONFIG.SYS.
TIP:     While a FILES setting of 40 is the minimum required for FoxPro for Windows to run, a FILES setting of 60 or higher is recommended.
WIN.INI
The following lines are added to the WIN.INI file if they have not previously been added by another application:

[MSAPPS]
msapps=c:\windows\msapps

[MS Proofing Tools]
Custom Dict 1=c:\windows\msapps\proof\custom.dic
Spelling 2057,0=c:\windows\msapps\proof\msspell.dll,
		c:\windows\msapps\proof\mssp_br.lex
Spelling 1033,0=c:\windows\msapps\proof\msspell.dll,
		c:\windows\msapps\proof\mssp_am.lex
TIP:     The Setup program for Microsoft FoxPro for Windows does not make a backup copy of your WIN.INI file. Prior to installing FoxPro for Windows, copy your WIN.INI file to WIN.BAK so that any changes made by the Setup program may be reversed if necessary.
REG.DAT
The Setup program for FoxPro for Windows makes the following changes to the Windows registration database (REG.DAT):
Keys:			.app=MSFoxPro
					.fxp=MSFoxPro
					.prg=MSFoxPro
Identifier:	MSFoxPro
File Type:	Microsoft FoxPro for Windows
Action:		Open
Command:		C:\FOXPROW\FOXPROW.EXE %1
NOTE:     To see these keys you must execute REGEDIT with the /V parameter. These keys in REG.DAT provide FILE MANAGER with information on these files. Notice, however, that only FoxPro programs are registered, not database files and other FoxPro file types. If you were to associate a .DBF extension with FoxPro for Windows and then selected a .DBF file in FILE MANAGER then FoxPro would load but you would get the FoxPro error "Line Too Long." This is because FoxPro just tried to run your database file like a program.
The following REG.DAT entry for Microsoft Graph is made only if it does not already exist. Other applications like Microsoft Excel for Windows may make a Microsoft Graph entry also.
Identifier:	MSGraph
File Type:	Microsoft Graph
Action:		Open
Command:	

The addition of a REG.DAT entry for Microsoft FoxPro instructs Windows to run FoxPro when the user double clicks on a file that it recognizes as a FoxPro file. FoxPro can only run the files passed to it by FILE MANAGER as programs (see note above).
Network Installation
There are two portions to a Network Installation of FoxPro for Windows; an Administrative setup and a Workstation setup. Each type is required to properly install FoxPro for Windows on your network.
Administrative Setup
An Administrative setup of FoxPro for Windows is the first step to install FoxPro on your network. To begin this process do the following:
·	Insert FoxPro Disk 1 into drive A.
·	Choose the Run... option from the Windows Program Manager File menu. The Run dialog appears.
·	In the Command Line box, type A:\SETUP /A, then press Enter. The message "Initializing Setup ..." appears.
NOTE:     The "Initializing Setup ..." text, the title of this first window, the name and size of the Setup program's temporary directory come from the file SETUP.LST on Disk 1.
·	Next you will see the User Information dialog that will ask you to enter your name and your company's name. This information is stored in an encrypted format, and cannot be changed without re-installing FoxPro. This is important to note in an Administrative setup because all subsequent Workstation installations will be branded with the same user name and company name.
·	The Select Installation Directory dialog appears (see Figure 1.) and asks you to tell the FoxPro for Windows Setup program where the shared copy of FoxPro will reside as well as where to place the subdirectories for MS Graph and the spelling checker. The information for the location of MS Graph and the spelling checker is placed in a file called PATHS.INI in the \FOXPROW\SETUP directory.
NOTE:     If your copy of Windows is a shared copy, the individual performing the Administrative setup needs full access to the shared Windows directory.

Figure 1.

After the Setup program has the information that it needs, it begins to request the diskettes. If you have 3.5" high-density diskettes then you should be prompted for 6 diskettes, if you have the 5.25" high-density diskettes then you will be prompted for 7 diskettes to install Microsoft FoxPro for Windows version 2.5x.
If the Setup program completed its task properly then you will see the screen displayed in Figure 2. This screen is only displayed after an Administrative setup of FoxPro and its purpose is to inform you that there are some critical .DLL files that FoxPro for Windows needs to be in the \WINDOWS\SYSTEM directory.

Figure 2.

Once the Figure 2 screen has been displayed then you are ready to perform individual Workstation installations of FoxPro.
The Setup Directory
An important difference between the Normal setup of FoxPro and the Administrative setup is the presence of the SETUP directory. The SETUP directory is a sub-directory of the Administrative setup of FoxPro and is used to perform Workstation installations. The contents of the SETUP directory are listed below:
COMMDLG.DLL		Windows Common Dialogs library
DDEML.DLL			DDE Management Library
OLECLI.DLL			Client library for OLE
OLESVR.DLL			Server library for OLE
SHELL.DLL			Shell library
TOOLHELP.DLL		Windows tool helper library
VER.DLL			Version Resource and File Installation library
MSCUISTF.DLL		Used by SETUP.EXE
MSCOMSTF.DLL		Used by SETUP.EXE
MSINSSTF.DLL			Used by SETUP.EXE
MSDETSTF.DLL		Used by SETUP.EXE
MSSHLSTF.DLL		Used by SETUP.EXE
MSCPYDIS.DLL		Used by SETUP.EXE
MSUILSTF.DLL			Used by SETUP.EXE
ICONBTN.DLL			Used by SETUP.EXE

_MSTEST.EXE			Used by SETUP.EXE
_MSSETUP.SUP		Used by SETUP.EXE
FOXPROW.MST		Source code for SETUP.EXE for FoxPro for Windows
SETUP.INC			Include file for SETUP.EXE
FOXPRO.INF			Setup information and configuration file (see below)
PATHS.INI			Tells SETUP.EXE where to put MS Graph etc. . . .
FOXPRINT.TTF			FoxPrint True Type Font
FOXPRINT.FOT		FoxPrint True Type Font
WINHELP.EXE			Windows help engine
WINHELP.HLP			Help file for Windows help
FOXLABEL.DBF		FoxPro label types database
FOXLABEL.FPT			FoxPro label types memo file
Workstation Setup
A Workstation setup of FoxPro for Windows on your network's individual workstations will save resources and will allow the network administrator to control access to FoxPro for Windows. To begin the Workstation installation, do the following:
·	Attach to your network server where the shared copy of FoxPro for Windows resides.
·	Choose the Run... option from the Windows Program Manager, File menu. The Run dialog appears.
·	In the Command Line box, type <network drive>:\SETUP /N, then press Enter. The message "Initializing Setup ..." appears.
NOTE:     The "Initializing Setup ..." text, the window title and the name and size of the Setup program's temporary directory come from the file SETUP.LST in the directory of the shared copy of FoxPro.
·	The Workstation setup creates a FoxPro for Windows directory for the individual user and copies the FOXUSER.DBF and .FPT to this directory. In addition, a Program Manager group and a FoxPro program icon are created.
Once the Workstation setup is complete, the individual at that workstation may begin using the shared copy of FoxPro from the network.
Tips for Installation
FOXPROW.INF
The code listing found below is a portion of the FOXPROW.INF file. The section shown is the [reqfiles] or "required files" section which explains to the FoxPro for Windows Setup program what files are necessary to successfully run FoxPro. This file provides the following information:
·	The diskette number each file should come from
·	File name and date
·	Whether it should be decompressed, marked read only, etc.
·	What the decompressed file size should be
·	Whether or not the program is vital to FoxPro's execution
This file may be found on Disk 1 of the installation diskettes or in the \FOXPRO\SETUP directory for an Administrative installation. For the Administrative setup, all of the diskette references are changed to 1.
[reqfiles]
"prodfile" = 2, foxprow.exe,,,, 1993-09-28,,,,,, foxprow.exe,,,, 2468119, SYSTEM,,,,
6, transprt.prg,,,, 1993-09-28,,,, !READONLY,, transprt.prg,,,, 342751,,,,, !VITAL
6, genscrn.prg,,,, 1993-09-28,,,, !READONLY,, genscrn.prg,,,, 277228,,,,, !VITAL
6, genpd.app,,,, 1993-09-28,,,, !READONLY,, genpd.app,,,, 379037,,,,, !VITAL
1, readme2.txt,,,, 1993-09-28, !DECOMPRESS,,, !READONLY,, readme.txt,,,, 46309,,,,, !VITAL
1, psskb.txt,,,, 1993-09-28, !DECOMPRESS,,, !READONLY,, psskb.txt,,,, 38309,,,,, !VITAL
6, foxtools.fll,,,, 1993-09-28,,,, !READONLY,, foxtools.fll,,,, 60238,,,,, !VITAL
6, genmenu.prg,,,, 1993-09-28,,,, !READONLY,, genmenu.prg,,,, 50404,,,,, !VITAL
6, psapi.fll,,,, 1993-09-28,,,, !READONLY,, psapi.fll,,,, 27668,,,,, !VITAL
6, foxpro.int,,,, 1993-09-28,,,, !READONLY,, foxpro.int,,,, 31214,,,,, !VITAL
6, driver2.fll,,,, 1993-09-28,,,, !READONLY,, driver2.fll,,,, 17876,,,,, !VITAL
6, genxtab.prg,,,, 1993-09-28,,,, !READONLY,, genxtab.prg,,,, 29217,,,,, !VITAL
6, reserved.fll,,,, 1993-09-28,,,, !READONLY,, reserved.fll,,,, 12764,,,,, !VITAL
6, foxfont1.852,,,, 1993-09-28,,,, !READONLY,, foxfont.852,,,, 15872,,,,, !VITAL
6, foxfont.850,,,, 1993-09-28,,,, !READONLY,, foxfont.850,,,, 15872,,,,, !VITAL
6, foxfont.fon,,,, 1993-09-28,,,, !READONLY,, foxfont.fon,,,, 15872,,,,, !VITAL
6, foxstart.app,,,, 1993-09-28,,,, !READONLY,, foxstart.app,,,, 8674,,,,, !VITAL
6, cpzero.prg,,,, 1993-09-28,,,, !READONLY,, cpzero.prg,,,, 3372,,,,, !VITAL
6, foxrun.pif,,,, 1993-09-28,,,, !READONLY,, foxrun.pif,,,, 545,,,,, !VITAL
6, fox.msk,,,, 1993-09-28,,,, !READONLY,,,,,, 166,,,,, !VITAL
6, fox.bmp,,,, 1993-09-28,,,, !READONLY,,,,,, 534,,,,, !VITAL
6, european.mem,,,, 1993-09-28,,,, !READONLY,, european.mem,,,, 577,,,,, !VITAL
1, goodies\foxdata\foxdata.inf,,, !COPY,,,,,, REMOVE,,,,, 0,,,,,
1, genxtab.fxp,,, !COPY,,,,,, REMOVE,,,,, 0,,,,,
1, transprt.fxp,,, !COPY,,,,,, REMOVE,,,,, 0,,,,,
1, genmenu.fxp,,, !COPY,,,,,, REMOVE,,,,, 0,,,,,
1, genscrn.fxp,,, !COPY,,,,,, REMOVE,,,,, 0,,,,,
Could not Create Directory Error Message
The maximum number of characters that may be used to access a file by its direct path is 66. This includes the drive and root directory specification. This limitation is found in all versions of MS-DOS and is due, in part, to a limitation of the MS-DOS function INT 21h sub-function 47h (Get Current Directory).
As a result of this, if you attempt to install FoxPro for Windows into an extensive path, you may receive the error "Could not create directory" The only solution for this is to re-install FoxPro to a smaller initial path.
Engineering Prototype Registration
If you notice that your copy of FoxPro is registered to "Microsoft Corporation" and is marked as an Engineering Prototype, do not be alarmed. This is not a BETA copy. The cause of this message is dependent on your version of FoxPro 2.5 for Windows.
If you are using FoxPro for Windows version 2.5a, it is that you installed 2.5a over your existing copy of FoxPro 2.5. The solution to this problem is to install 2.5a into a clean sub-directory of its own.
If you are using FoxPro for Windows version 2.5b, your installation did not complete successfully. The only solution to this is to completely re-install FoxPro.
Locating FOXUSER.DBF
FoxPro 2.5x does not make any modifications to the MS-DOS path in your AUTOEXEC.BAT file. FoxPro for Windows still uses the MS-DOS path to find the FOXUSER.DBF resource file. This can cause some confusion when FoxPro for MS-DOS is installed on the same computer because FoxPro for Windows may use the FoxPro for MS-DOS FOXUSER file. 
The best solution for this is to specify in your CONFIG.FPW a resource file to be used, with the following syntax:
resource=<path and file name of resource file>
Additional Information
Additional information concerning the installation of FoxPro for Windows can be found by looking at the following articles:

Q107396	Q95661	Q97054	
Q99537	Q97157	Q96170	
Q98684	Q96288