Release Notes for Version 2.2.0 of the IBM WebSphere Business Integration Adapter for PeopleSoft (for PeopleSoft 8.x)

These release notes cover release information for version 2.2.0 of the IBM WebSphere Business Integration Adapter for PeopleSoft (for PeopleSoft 8.x). They contain the following sections:
New in this release WebSphere Business Integration Adapters API and run time
Product fix history Known problems and workarounds
Hardware and software requirements Documentation updates
Installation, migration, upgrade, and configuration information

Note: Important information about this product may be available in Technical Support Flashes issued after these release notes were published. These can be found on the WebSphere Business Integration support Web site, http://www.ibm.com/websphere/integration/wbiserver/support. Select the component area of interest and search the flashes section.

New in this release

This section lists the new features and improvements made in this release.

Refer to the Adapter for PeopleSoft User Guide for detailed information about the adapter and the new features.

Product fix history

Between releases 2.1.0 and 2.2.0, the following CRs, based on customer-reported cases, were fixed.
CR number Description
18942 Transactions fail with message number 90014. This has been fixed.
22902 Deletion of children was not done properly when KeepRelationship was set to false. This has been fixed. 

Hardware and software requirements

Hardware and software requirements are included in the product documentation. See Installation, migration, upgrade, and configuration information for links to those guides.

Installation, migration, upgrade, and configuration information

Whether you are installing the software from the CD or downloading it from Passport Advantage and installing it from a local directory, refer to the appropriate guide:

These guides also include migration, upgrade, and configuration information.

For hardware and software requirements and configuration information specific to this adapter, refer to the Adapter for PeopleSoft User Guide.

WebSphere Business Integration Adapters API and run time

Make sure that you run adapters with WebSphere Business Integration Adapters (WBIA) run-time version 1.5.0 or later.

Verifying the version of WBIA run time

To check the version of WBIA run time, locate the manifest file (ProductDir\lib\WBIA.jar) and open it in a suitable Java JAR editor. Look for the following lines:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0
Implementation version indicates the current version of WBIA API.

If the version is not 1.5.0 or later, you must download the latest WBIA run time.

Downloading the WBIA run time

To download the latest version of the WBIA run time:

  1. Go to http://www.ibm.com.
  2. Click the Support and downloads tab.
  3. Under the Downloads heading, click All downloads & drivers.
  4. In the Enter search terms field, type "wbia api" and click Submit.

After you download and install the the run time, you should see the following files:

lib\WBIA.jar
lib\WBIA\3.0.0\WBIA.jar
lib\WBIA\4.0.0\WBIA.jar
lib\WBIA\4.1.1\WBIA.jar
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt

Enabling adapters for earlier versions of Adapter Development Kit and InterChange Server

To enable an adapter to work with various versions of ADK or InterChange Server, follow the appropriate procedure below:

InterChange Server versions 4.0.1 and 4.1.0, ADK versions 2.0.x

Windows: In CWConnEnv.bat, set the CWVERSION variable to 4.X.

set CWVERSION="4.X"

UNIX: In CWConnEnv.sh, set the CWVERSION variable to 4.X.

set CWVERSION="4.X"
InterChange Server versions 4.1.x (except 4.1.0), ADK versions 2.1.x

Windows: In CWConnEnv.bat, set the CWVERSION variable to 4.1.X.

set CWVERSION="4.1.X"

UNIX: In CWConnEnv.sh, set the CWVERSION variable to 4.1.X.

set CWVERSION="4.1.X"
Running an Object Discovery Agent (ODA) against InterChange Server versions 4.0.1 and 4.1.x, ADK versions 2.0.x and 2.1.x

Windows: In bin\CWODAEnv.bat, set the CWVERSION variable to 4.1.X.

set CWVERSION="4.1.X"

UNIX: In bin/CWODAEnv.sh, set the CWVERSION variable to 4.1.X.

set CWVERSION="4.1.X"

Known problems and workarounds

The following problems have been found in this release:

CR number Problem
10616 If you are not using the event notification portion of the connector, the absence of the cweventci class causes the connector to return an error. As designed, the connector should give a warning message but should not terminate if the cweventci class is missing. If the connector terminates, something else might be causing it to terminate. 
The user-defined function cw_archive_events() is not working as part of the event-component interface, and a case has been logged with PeopleSoft. This function sets a component variable, &ARCHFLG, to Y for the given component if the archiving connector property is set to true. When this flag is Y, the SavePostChg() PeopleCode event archives the event by copying the exact event information from CW_EVENT_TBL into CW_ARCHIVE_TBL, then deleting the event from the event table. Until this problem is resolved, this flag must be set manually. If the implementation requirements are to archive every event, verify that &ARCHFLG is set to Y in the SavePostChg() PeopleCode of CW_EVENT_BC. Every event that is processed will be archived. If no events are to be archived, set this value to N.
There are several known session object problems within the PeopleTools Java API. Sometimes errors cause the session to invalidate and this interferes with subsequent processing. Workarounds have been implemented in the connector to retrieve outstanding PSMessages and then reconnect to the application with another valid session for most scenarios. If this happens, contact your IBM technical support representative.  PeopleTools 8.19 as well as 8.42 will include fixes for this problem.
Some of the delivered component interfaces in the PeopleSoft application do not function properly in the PeopleTools 8.1x Java API. Consequently, the PeopleSoft ODA, version 1.0.0, cannot generate business objects from them, even though they appear in the available list.  In such cases, the PeopleSoft ODA prints an error message to the log file, indicating which objects failed generation. The following HRMS component inters are known to have this problem:
  • JOBCODE
  • LOCATION
  • SIMPLEGRAPH
  • PRTL_SS_CI
DB2 does not support character references in the built-in GetNextNumber() function that the event notification function >cw_publish_events() calls. In these cases, the field CW_EVENT_NOT can be changed to a number type either by importing a patch project or by changing it directly.  This does not interfere with the functionality of the event notification. However, the insert statement in the adapter documentation refers to inserting a character "0" into the PS_FUNCLIB_CW table; this must be changed to a number in this situation.
There is a PeopleSoft Java API bug with level 3 objects in versions prior to 8.18. Patches are available through PeopleSoft's support for these earlier releases, and they have been incorporated in PeopleTools 8.18 and later.
PeopleTools 8.16 has problem with the initial connection through the Java API. A patch to at least 8.16.02 must be applied for the connector or ODA to make a connection.
The adapter can be run with PeopleSoft CRM 8.4, but because of some unresolved errors with the delivered component interfaces for this application, the adapter or ODA does not work until it has either been fixed or deleted. For information on resolving these errors, see Validating Component Interfaces for Consistency in the PeopleSoft Component Interface PeopleBooks

These errors include:

  • RB_CNTCT_SUBSCR_CI - Delete this CI.
  • RBF_PROD_GROUP_CI - Delete the properties in error and save the CI.
  • RBT_SERV_CHG_SS_CI - Delete the properties in error and save the CI.

Documentation updates

Product documentation is not included as part of the product package, either by CD or electronic product distribution. The documentation for this product can be found in the following InfoCenters:

To obtain the product documentation, visit the Web site and download the current documentation set for the release that you are using. Follow the instructions provided on the InfoCenter page to complete the installation.

Copyright IBM Corp. 1997, 2003