Before you use the IBM WebSphere Business Integration Adapter
for PeopleSoft, verify that your system has the required software.
Also, you must perform operations such as creating the connector's
user account, mapping an environment variable, and generating
PeopleSoft APIs. This section describes:
To access a designated Component Interface and its underlying
PeopleSoft business logic, the connector requires two layers of
PeopleSoft API classes. Before you use the connector, install the
following:
- Important:
- For installation prerequisites specific to your integration
broker, see the For more information on installing the connector
component, refer to the Implementation Guide for the WebSphere
MQ Integrator Broker, or, the WebSphere InterChange Server
System Installation Guide for Windows, or for Unix.
This section describes required operations that must be
performed before you use the connector:
- Map the CLASSPATH environment variable to the
following directories:
$ProductDir/connectors/PeopleSoft/dependencies
%ProductDir%\connectors\PeopleSoft\dependencies
Also ensure that psjoa.jar is defined in the
CLASSPATH.
- Create a user account in PeopleSoft for the connector. For more
information, see Creating a user account in
PeopleSoft.
- Configure the PeopleSoft user account so that it does not time
out. For more information, see "Configuring
time-out for the user account".
- Only when ICS is the integration broker: Delete any previously
installed versions of the connector. Also, delete all previous
customizations made in PeopleSoft for the connector. For example,
delete all connector-related Menus, Pages, Records, Message
Definitions Components, and Component Interfaces. Also, delete the
connector's event and archive tables. Typically, these objects are
stored in a connector-specific project that you can open in
Application Designer.
- Note:
- If you install a WebSphere Business Integration Adapter on the
same machine as a previous installation of the connector for ICS,
the ICS connector will not run unless you manually switch the IBM
WebSphere system environment variable to point to the desired
product path.
- Generate Component Interface APIs. For more information, see
"Generating APIs".
Before installing the connector, you must create a user account
in the PeopleSoft application. The account:
- Can have any valid PeopleSoft user name and password.
- Must have privileges to retrieve, insert, update, and delete
data from the appropriate Pages, Components, and Component
Interfaces in the PeopleSoft system. For example, for the connector
to process customer data, the connector user account must have
privileges to work with relevant Customer components.
- Uses General PeopleSoft Security. For more information, see the
Security section of Administrator Tools in PeopleBooks.
- Must be configured so that the session never times out. For
more information, see Configuring time-out
for the user account.
Because the connector uses the Component Interfaces (and the
Component Processor on the Application Server) to insert and
extract business objects from the PeopleSoft database server, the
Application Server must be running. If the user account times out,
the Component Processor closes, and the connector logs an error
message every time it attempts to access the PeopleSoft system
(that is, at every poll, at every create, at every retrieve, and at
every update).
To configure the user account to never time out, do the
following:
- In the PeopleSoft application, select PeopleTools from
the Go menu option.
- Select Maintain Security from the PeopleTools
menu option.
- Select Permission Lists from the Use menu
option.
- Select Sign-On Times from the Permission
Lists menu option
- From the list of permissions, select the one affiliated with
the connector's user account.
- On the General tab, select Never Time-Out,
and select Can Start Application Server, if not already
selected.
