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
- 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:
- Log into the PeopleSoft instance that will be communicating
with the WebSphere® Cast
Iron Appliance.
- 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.
- Choose Build | PeopleSoft APIs.
- 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.)
- In the Target Directory field,
enter this path: c:\temp
- Click OK to build the bindings
that you have selected.
If the operation is successful,
a "Done" message is displayed in the Build tab.
- 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.
- 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.
- If not already present, create a temporary directory (c:\temp).
- 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.)
- In the temp directory, create an additional directory hierarchy: c:\temp\out\
- To start the actual class files compilation, complete these
steps:
- Open a terminal window, and change to this directory: c:\temp
- 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%
- In the same directory (c:\temp), if only
one API is present, run this command:
javac -J-Xmx1024m
-d out PeopleSoft\Generated\CompIntfc\*.java
- If two PeopleSoft APIs are present, run this command:
javac
-J-Xmx1024m -d out PeopleSoft\Generated\CompIntfc\*.java PeopleSoft\Generated\PeopleSoft\*.java
- Bundling the class files into jar files
- Change to the output folder (c:\temp\out)
- Run this command: jar cvf PeopleSoft.jar PeopleSoft
This produces the custom PeopleSoft.jar file.
- 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\