Upgrading to DataFlex 3.2: Difference between revisions
Formatting
m (Tidy) |
(Formatting) |
||
| Line 188: | Line 188: | ||
== Troubleshooting DataFlex 3.2 == | == Troubleshooting DataFlex 3.2 == | ||
The DFPATH Environment Variable | '''The DFPATH Environment Variable''' | ||
This is the most important environment variable from a DataFlex viewpoint. DataFlex uses this variable to find everything it needs: | This is the most important environment variable from a DataFlex viewpoint. DataFlex uses this variable to find everything it needs: | ||
termlist.cfg & *.dfr for registration information | *termlist.cfg & *.dfr for registration information | ||
filelist.cfg | *filelist.cfg | ||
data files: *.dat, *.fd, *.k*, *.tag, *.hdr, *.vld | *data files: *.dat, *.fd, *.k*, *.tag, *.hdr, *.vld | ||
compiled DataFlex programs: *.flx | *compiled DataFlex programs: *.flx | ||
source code for DataFlex programs: *.src, *.frm, *.inc, *.pkg, ... | *source code for DataFlex programs: *.src, *.frm, *.inc, *.pkg, ... | ||
If there are multiple copies of any of the above files along the directories listed in DFPATH, DataFlex will use the first copy that it finds. | If there are multiple copies of any of the above files along the directories listed in DFPATH, DataFlex will use the first copy that it finds. | ||
The DFENV Environment Variable | '''The DFENV Environment Variable''' | ||
The DFENV environment variable was added in DataFlex 3.2 to work around DOS and Windows operating system limitations, such as command line length and environment space. | The DFENV environment variable was added in DataFlex 3.2 to work around DOS and Windows operating system limitations, such as command line length and environment space. | ||
| Line 205: | Line 206: | ||
DFENV points to a file called dfenv.cfg. The variables set in this file will override any variables of the same name in your environment. If dfenv.cfg contains a DFPATH environment variable, and your current environment also has DFPATH set, the one in DFENV will be used (provided the DFENV environment variable is set). To see your current environment variables, type "set" and press <Enter> at the command prompt. | DFENV points to a file called dfenv.cfg. The variables set in this file will override any variables of the same name in your environment. If dfenv.cfg contains a DFPATH environment variable, and your current environment also has DFPATH set, the one in DFENV will be used (provided the DFENV environment variable is set). To see your current environment variables, type "set" and press <Enter> at the command prompt. | ||
Other Environment Variables | '''Other Environment Variables''' | ||
HOME is an environment variable set in many networking environments, and it may interfere with DataFlex 3.2 running properly if it points to a directory containing another version of DataFlex or parts thereof (watch for files like termlist.cfg and *.dfr - frequent culprits). Specifically, the DataFlex runtime looks for a copy of termlist.cfg first in the directory specified by HOME. Perhaps the best method to avoid problems with HOME is to never store a termlist.cfg file in the directory HOME points to. | '''HOME''' is an environment variable set in many networking environments, and it may interfere with DataFlex 3.2 running properly if it points to a directory containing another version of DataFlex or parts thereof (watch for files like termlist.cfg and *.dfr - frequent culprits). Specifically, the DataFlex runtime looks for a copy of termlist.cfg first in the directory specified by HOME. Perhaps the best method to avoid problems with HOME is to never store a termlist.cfg file in the directory HOME points to. | ||
DFPROG is an older environment variable used in versions of DataFlex prior to 3.2. You can ignore it or eliminate it from your DataFlex 3.2 environment. | '''DFPROG''' is an older environment variable used in versions of DataFlex prior to 3.2. You can ignore it or eliminate it from your DataFlex 3.2 environment. | ||
PATH is the environment variable that the operating system uses to find executable files (programs) such as; dfrun.exe, dfcomp.exe, etc.. The directory where the DataFlex executables are located must be part of the PATH environment variable. In the case of DataFlex 2.3b, that directory is c:\df23 and for DataFlex 3.2 that directory is c:\df32\bin (/usr/local/df32/bin on Linux/Unix). | '''PATH''' is the environment variable that the operating system uses to find executable files (programs) such as; dfrun.exe, dfcomp.exe, etc.. The directory where the DataFlex executables are located must be part of the PATH environment variable. In the case of DataFlex 2.3b, that directory is c:\df23 and for DataFlex 3.2 that directory is c:\df32\bin (/usr/local/df32/bin on Linux/Unix). | ||
If you experience problems running DataFlex 3.2; just to play it safe, eliminate any additional environment variables until you get DataFlex running. If those environment variables are needed for other applications, you can add them back, once you get DataFlex running properly. | If you experience problems running DataFlex 3.2; just to play it safe, eliminate any additional environment variables until you get DataFlex running. If those environment variables are needed for other applications, you can add them back, once you get DataFlex running properly. | ||