Setting up the class path configuration file

You create a class path configuration file to specify the class path definition. A class path definition contains a list of file paths for the dependent JAR files for each user class of the Java Integration stage. After you update the class path configuration file, you do not need to restart the InfoSphere® Information Server engine tier, ISF agents, or WebSphere Application Server. The Java Integration stage identifies the changes that were made to the file the next time that the file is used.

Procedure

  1. Create a classpath configuration file with read permission enabled for all the users, and name it JavaStage.config.
  2. Open the file in a text editor, and specify the class path definition in the following format:
    classpath:user_class_name = classpath_definition
  3. Save the JavaStage.config file on the InfoSphere Information Server engine tier computer in the IS_HOME/Server/DSEngine directory, where IS_HOME is the InfoSphere Information Server installation directory. For example, you can save the file to the C:\IBM\InformationServer directory on a Windows computer or the /opt/IBM/InformationServer directory on a Linux or UNIX computer.

    If the engine tier of your InfoSphere Information Server installation is on multiple computers, configure the DSEngine directory as a shared network directory so that the JavaStage.config file is available from the same location on all the computers.

Example

Assume that you want to set up the class path configuration file for the com.abc.xyz.XYZProcessor user class. The JAR files that are in the C:\Program Files\XYZ directory are specified for the XYZ_HOME environment variable.

Assume that you need the following .jar files out of the 10 files in the C:\Program Files\XYZ\lib\ directory:
  • C:\Program Files\XYZ\lib\aaa.jar
  • C:\Program Files\XYZ\lib\bbb.jar
The C:\Program Files\XYZ\lib\common\ directory contains the following .jar files, and you need all of them:
  • C:\Program Files\XYZ\lib\common\c1.jar
  • C:\Program Files\XYZ\lib\common\c2.jar
  • C:\Program Files\XYZ\lib\common\c3.jar
  • C:\Program Files\XYZ\lib\common\c4.jar
  • C:\Program Files\XYZ\lib\common\c5.jar
To set up the class path configuration file, create the JavaStage.config file in the IS_HOME/Server/DSEngine directory of the InfoSphere Information Server engine tier computer and specify the following line:
classpath:com.abc.xyz.XYZProcessor = ${XYZ_HOME}\lib\aaa.jar;${XYZ_HOME}\lib\bbb.jar;${XYZ_HOME}\lib\common\*