When the Listener is instantiated, the IBM® System Dashboard for Enterprise
Content Management attempts to locate
the PchConfig.properties configuration file and
if it is found, the contents of the file are processed. If the PchConfig.properties configuration
file cannot be located, default values are assigned to the configuration
parameters.
Locating the file for use with the C++ Listener
The
process for locating the file on a Windows platform for use with the
C++ Listener API is as follows:
- The listener first determines if the filenet.pchconfig environment
variable is defined. If the variable is defined and its value is not
the empty string, then the value of the variable is considered to
be the complete path to the location of the configuration file.
- If the filenet.pchconfig environment variable
is not defined, or its value is the empty string, then the IBM System Dashboard for Enterprise Content Management searches for the configuration
file in the current directory.
- If the configuration file is not located in the current directory,
then if the HOME environment variable is defined,
the configuration file is searched for in that directory.
- If the configuration file is not located in the directory specified
by the HOME environment variable, and if the PATH environment
variable is defined, then each semicolon-separated directory is searched
for the file.
Locating the file for use with the Java Listener
The
process for locating the file on a Java-enabled platform for use with
the Java Listener API is as follows:
- The Listener first determines if the filenet.pchconfig Java
system property is defined. If the property is defined and its value
is not the empty string, then the value of the property is considered
to be the complete path to the location of the configuration file.
- If the filenet.pchconfig property is not defined,
or its value is the empty string, then the Listener searches for the
configuration file in the directories specified by the user.home, user.dir,
and java.home Java system properties, in that order.
- If the configuration file is not located in any of those directories,
then the directories specified in the CLASSPATH variable
are searched.