FindFile()

Description

FindFile() is used to find files in local, or system directories in an OS and application environment-independent manner.

Call Signature

string FindFile ( string file_class, string filename )

Return Value

string

The path to the executable that is found will be returned. An empty string "" is returned if not found.

Arguments

string file_class:

The grouping to which the file belongs. Currently the "etc", "hlp", and "pro" groupings exist and serve purposes analogous to the PCI directories so named.

string filename:

The base name for the file being searched for. In some cases, an extension may be automatically supplied if needed.

Remarks

This intrinsic is used to find files on the application directory tree, such as /PCI for EASI.

The default FindFile() behavior is the default searching patterns suitable in a PCI or EASI environment.

• etc: The local directory, $USERHOME, $PCIGROUPGROUP/etc, $PCIHOME/etc and $PCIMASTER are searched until the file is found. The etc class is suitable for many types of relatively small files including icons, configuration files, license files, and preference files.
• pro and hlp: FindFile() will utilize the local, group and system-wide search paths that apply based on the contents of the local parameter file, and the environment variable PCIHOME, and PCIMASTER.