Compiling the required PeopleSoft jar files

The first of the two required jar files, which will be named "PeopleSoft.jar", must be manually built and compiled.

Important: Before starting the three-step process, create a network-accessible target directory on the PeopleSoft workstation. For example, c:\temp

Procedure

  1. Creating the PeopleSoft Java files
    You must first build a component interface API in the form of *.Java source code files. These are then compiled into the new Java classes.
    Note: Depending on your PeopleSoft instance, two sets of APIs may be built in a single build action. This is included in the following.

    Using a PeopleSoft client workstation, complete the following steps:

    1. Log into the PeopleSoft instance that will be communicating with the WebSphere® Cast Iron Appliance.
    2. Start Application Designer, then open a component interface definition. You can select any component interface definition, as the API that you are building will include all of them.
    3. Choose Build | PeopleSoft APIs.
    4. When the Build PeopleSoft API Bindings dialog box is displayed, click the Build check box in the Java Classes group options. (Deselect all other active check boxes.)
    5. In the Target Directory field, enter this path: c:\temp
    6. Click OK to build the bindings that you have selected.

      If the operation is successful, a "Done" message is displayed in the Build tab.

    7. Open a terminal window and change to c:\temp\PeopleSoft\Generated, and verify the number of API output directories. You should see \CompIntfc, but you may also see \PeopleSoft. If two are present, you must compile both.
  2. Compiling class files from the PS APIs

    • If your PeopleSoft workstation does not have Java installed, either install Java JDK 1.4, or use a separate workstation running Java JDK 1.4 (or later) to complete this procedure.
      1. If not already present, create a temporary directory (c:\temp).
      2. Make sure the following are present in this directory:
        • The PS API files (PeopleSoft\Generated\CompIntfc)
        • (If present, any additional PS API files [PeopleSoft\Generated\PeopleSoft])
        • The file "psjoa.jar" (<drive>:\PSFT\class\)--- (copying this file is optional; you can refer to this file in its original path, if convenient.)
      3. In the temp directory, create an additional directory hierarchy: c:\temp\out\
    • To start the actual class files compilation, complete these steps:
      1. Open a terminal window, and change to this directory: c:\temp
      2. Run the following command on the psjoa.jar file:

        set classpath=c:\temp\psjoa.jar;%CLASSPATH%

        Or

        (Or, run set classpath=<drive>:\PSFT\class\psjoa.jar;%CLASSPATH%

      3. In the same directory (c:\temp), if only one API is present, run this command:

        javac -J-Xmx1024m -d out PeopleSoft\Generated\CompIntfc\*.java

      4. If two PeopleSoft APIs are present, run this command:

        javac -J-Xmx1024m -d out PeopleSoft\Generated\CompIntfc\*.java PeopleSoft\Generated\PeopleSoft\*.java

  3. Bundling the class files into jar files
    1. Change to the output folder (c:\temp\out)
    2. Run this command: jar cvf PeopleSoft.jar PeopleSoft

      This produces the custom PeopleSoft.jar file.

    3. Copy the two jar files ("PeopleSoft.jar" and "psjoa.jar") to a directory on your PC workstation that is accessible by the WebSphere Cast Iron Studio installation.

      The file "psjoa.jar" can be found in c:\temp, or in this location on the PeopleSoft workstation: <drive>:\PSFT\class\