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.
