Community articleSetting Up the prefs.config File
Added by IBM contributorIBM on July 26, 2013
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

The prefs.config file controls the configuration of the API. When you distribute an application that uses the API, you must also distribute a configuration file for that application. This file ensures that the API is configured properly to work with your application.
You can install the configuration file in any of the following locations:
   c:\Documents and Settings\<username>\Application Data\PureEdge\
      <application> <version>\Prefs\prefs.config
   c:\Documents and Settings\All Users\Application Data\PureEdge\
      <application> <version>\Prefs\prefs.config
   c:\Documents and Settings\<username>\Application Data\PureEdge\
      API <version>\Prefs\prefs.config
   c:\Documents and Settings\All Users\Application Data\PureEdge\
      API <version>\Prefs\prefs.config

These locations are listed in order of precedence, from highest to lowest. When loading the configuration information, the API first checks the lowest precedence location, then works its way to the highest. The configuration settings are loaded from each location, but settings in a higher precedence location override those in a lower precedence location.
In these paths, the <application> and <version> are determined by the parameters of the IFSInitialize function. You must call this function from your application to initialize the API, and as part of that you must supply a name and version for your application. Use the same name and version in your path.
For example, if you called the IFSInitialize function with a name of "CustomApp" and a version of "1.0", you would install the configuration file in the following location for All Users:
   c:\Documents and Settings\All Users\Application Data\PureEdge\
      CustomApp 1.0\Prefs\prefs.config

For more information about the IFSInitialize function, refer to the IBM Forms Server API – C API User's Manual.

Related reference