Configure the COM Bridge

This topic describes how to configure the JiGlue COM Bridge on a development system. Configuring the JiGlue COM Bridge consists of the following basic steps:

The remainder of this topic provides procedures on how to perform each of these steps.

Configure JDK, CLASSPATH, and Register the jiglue.dll

To use the JiGlue COM Bridge, if you have not already done so, you must first install the appropriate Java SDK on your development system (the JDK version varies depending upon your OS). For information on which JDK to use and how to configure a JDK on a development system for Panagon eProcess, see the Configure the Java SDK topic. Once you have installed the JDK, you must specify the location of the pw.jar file (contains the eProcess APIs), and register the jiglue.dll file on your system.

If you are planning to develop COM applications on your Web WorkFlo server, you have typically already installed your JDK, configured your CLASSPATH, and the jiglue.dll was registered during eProcess installation; skip to the Deploy the Client Application procedure.

If you are planning to develop an application on a system that is neither your workflow server or Web WorkFlo server, use the following procedure:

  1. If you have not already done so, install the appropriate Java SDK on your development system. In order to use the JiGlue COM Bridge, you should install the JDK in the default directory (on Windows, the default installation directory is <drive>...\jdk1.3.1; on Solaris <drive>:/j2sdk1.4.0 (for JDK 1.4.0), etc.). For information on installing the JDK and configuring your system for eProcess development, see the Configure the Java SDK topic.
  2. Create a local directory (in any location) called \process. You will use this directory to hold the eProcess Developer files, including pw.jar and the JiGlue files.
  3. Copy the jiglue.dll, jiglue.tlb, and pw.jar files to the \process directory. In order for JiGlue to work correctly, all three of these files must be in the same directory (as they are as shipped on the Panagon eProcess Toolkit CD). Refer to the Panagon eProcess Toolkit topic for information on these files and where to find them.
  4. If you have not already done so on this system, configure the CLASSPATH to specify the pw.jar location (typically either by creating a batch file to include pw.jar in the CLASSPATH, or if you are developing using an IDE (such as Visual Cafe, JBuilder, Forte, etc.), by adding pw.jar to your global or project setting). For details, see the Configure the Java SDK topic.

    Note The jiglue.dll parses the CLASSPATH for the location of the pw.jar file. If JiGlue does not find pw.jar in the CLASSPATH:

  5. Open a command prompt, and cd to the \process subdirectory.
  6. Register jiglue.dll by entering the following at the command prompt:

    regsvr32.exe jiglue.dll

    Tip You can unregister the library by entering the following command:

    regsvr32.exe /u jiglue.dll

Deploy the Client Application

If you are developing on the Web WorkFlo server, you do not need to register the jiglue.dll and you do not need to install the JRE. Both steps were done during installation.

If you are developing a new ASP-based application or extending the current ASP application, the appropriate JiGlue COM Bridge configuration already exists on the eProcess Web WorkFlo server. However, if you are developing stand-alone workflow applications (which are sometimes referred to as work performers) and you plan to deploy them on client systems, your installer must perform the following steps:

  1. Install or check for an existing installation of the JRE (currently for the client, JRE 1.4.0). Both JRE\bin and JRE\bin\client must be in the system path.
  2. Create a new directory to contain the process components.
  3. Copy the jiglue.dll, jiglue.tlb, and pw.jar files to the new directory (all three of these files must be in the same directory).
  4. Register the jiglue.dll (see Step 6 above).