FGLRESOURCEPATH
Defines a list of paths for program resource files.
FGLRESOURCEPATH definition
The FGLRESOURCEPATH environment variable is used to define the search paths for program resource files:
- Form definition files (.42f),
- Message files (.iem),
- Action defaults files (.4ad),
- Presentation styles files (.4st),
- Start menu files (.4sm),
- Toolbar files (.4tb),
- Topmenu files (.4tm),
- Localized strings files (.42s).
When the specified resource file is not an absolute path, the runtime system searches in directories in the following order:
- The current working directory.
- A path defined in the FGLRESOURCEPATH (or DBPATH) environment variable.
- The $FGLDIR/lib directory.
- The directory where the program file resides (the .42m module containing
MAIN
or the .42r program file).
The path separator is platform specific ( ":" on UNIX™ platforms and ";" on Windows® platforms).
FGLRESOURCEPATH versus DBPATH
For compatibility with Informix® 4GL, DBPATH is used by default to search for resource files such as form files and XML files used by the program.
However, DBPATH is also used by the Informix database software to locate databases: Informix Dynamic Server uses DBPATH to let you specify fallback servers if INFORMIXSERVER is not available, and former Informix Standard Engine needs DBPATH to find .dbs database files.
This can be a problem when connecting from a machine where path format is not the same as on the remote database server: It is not possible to mix UNIX and DOS path formats in DBPATH.
To work around this Informix limitation, FGLRESOURCEPATH can be used instead of DBPATH to specify the directories of program resource files. You are then free to define DBPATH as Informix requires.