These release notes cover release information for version 2.4.0 of the IBM(R) WebSphere(R) Business Integration Mainframe Adapter Suite (MAS). The suite includes eight adapters that provide business process automation for the following mainframe applications:
ADABAS
CICS/TS
DB2(R)
IDMS DB
IMS/DB
IMS/TM
NATURAL
VSAM
The mainframe server agent must be installed for the MAS driver to function. Read the documentation provided for the mainframe server agent regarding installation. Also refer to the Mainframe Adapter Suite User Guide for configuring the driver for different data sources.
The release notes contain the following sections:
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.
Beginning in this release, adapter agent installation is
decoupled from the Adapter Framework installation. Each adapter is
available as a separate product with its own installation program.
Refer to the Adapter Framework release notes for installation
information specific to this release, and refer to the System
Installation Guide for UNIX or for Windows for general installation
information.
Refer to the
Mainframe Adapter Suite User Guide for detailed
information about the adapter and the new features.
Between release 2.3.0 and 2.4.0, the following CRs, based on customer-reported cases, were fixed.
Tracking number |
Description |
13779 | A new verb, DeltaUpdate, is supported on the adapter. If this verb is specified on the parent, users can specify individual verbs on the children .The adapter will do operations on each child based on the verb set on that child.Fixed in 2.3.4. |
22193 | In previous versions, when attempting a delete operation, if the business object was not found, a message was logged to that effect in the log file. This behavior has been modified to return a failure notification if the business object does not exist in the database. The business object is sent to the Fault Queue. Fixed in 2.3.2. |
22924 | To support Trusted authentication, userID and password are no longer mandatory properties. |
25034 | Previously, if the connector received a return status as CONNECTOR_NOT_ACTIVE on gotApplEvent call, the adapter would archive the event with a status 0. In this release, the adapter does not archive events with a status of 0 but instead retains them in the event table so that they are processed when the adapter is restarted. Fixed in 2.3.1. |
25163 | The DB2 on OS400 database does not support variable length strings, so ObjectName and ObjectVerb fields retrieved from the event table needed to be trimmed to remove the extra spaces before the events could be processed. Fixed in 2.3.3. |
26156 | When retrieving child business objects using stored procedure, in certain cases, the result set was closed before the data was retrieved, indicating that the result set handle was invalid when an attempt was made to retrieve the data from the result set. Fixed in 2.3.3. |
26296 | The code used to generate the printable query for tracing referred to key values, and since only foreign keys were present it errored. Fixed in 2.3.2. |
26551 | In adapter patch 2.2.8, you had the option of using output parameters to populate attributes in an N-cardinality business object. In adapter version 2.3.0, returning a result set as an output parameter was introduced. There was a conflict in handling both the options simultaneously in adapter patch 2.3.1. Fixed in 2.3.2. |
26870 | When UseDefaultsForRetrieve was set to true, the default values were not being set on the business object for the verb RetrieveByContent. Fixed in 2.3.3. |
28415 | The start scripts supported launching of JAR files beginning with CW only. They have been modified to launch jar files beginning with BIA_ as well. Fixed in 2.3.3. |
28620 | The ASI retriever called the get attribute name instead of GetAttributeType() and this caused an error if the object attribute name and its type had different names for a single cardinality child. Fixed in 2.3.3. |
29539 | On delete and retrieve operations, if one of keys is CxIgnore it will be ignored and not considered for the where clause.Fixed in 2.3.4. |
Hardware and software requirements are included in the product documentation. See Installation, migration, upgrade, and configuration information for links to those guides.
Whether you are installing the software from the CD or downloading it from the Passport Advantage Web site and installing it from a local directory, refer to the appropriate guide for your Integration broker:
These guides also include general migration, upgrade, and configuration information.
For hardware and software requirements and
configuration information specific to this adapter, refer to the
Mainframe Adapter Suite User Guide.
The following folders must be added to the
PATH environment variable so that the drivers are
recognized:
Solaris, AIX(R), HP-UX
Make sure that you run this version of the adapter with WebSphere Business Integration Adapters run-time version 1.6.0 or later.
The WebSphere Business Integration Adapters API .jar files and the associated scripts (CWConnEnv.bat and CWODAEnv.bat for Windows(R); CWConnEnv.sh and CWODAEnv.sh for UNIX platforms) are installed by the WebSphere Business Integration Adapters API. Before installing the adapter, make sure that the WebSphere Business Integration Adapters run time is installed. If the version is not 1.6.0 or later, you must download the latest API. This section provides instructions for verifying the API version, downloading the latest version, and enabling the adapter to run on various versions of InterChange Server and Adapter Development Kit (ADK).
To check the run-time version, 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.6.0
Implementation-version indicates the installed version of the API. If the version is not 1.6.0 or later, you must download the latest run time.
To download the latest version of the run time:
After you download and install 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
lib\WBIA\4.2.0\WBIA.jar
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt
To enable an adapter to work with various versions of ADK or InterChange Server, follow the appropriate procedure below:
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"
Windows: In CWConnEnv.bat, set the CWVERSION variable to
4.2:
set CWVERSION="4.2"
UNIX: In CWConnEnv.sh, set the CWVERSION variable to 4.2:
set CWVERSION="4.2"
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"
Windows: In bin\CWODAEnv.bat, set the CWVERSION variable to
4.2:
set CWVERSION="4.2"
UNIX: In bin/CWODAEnv.sh, set the CWVERSION variable to
4.2:
set CWVERSION="4.2"
The following problem has been found in this release:
Tracking number |
Description |
29985 | On DB2, the adapter fails after executing a stored procedure with an input parameter of type Integer. The error returned is "CallableStatement get*** method did not match the type used in registerOutParameter. SQLSTATE=22005] ]." |
30523 | When processing a RetrieveSP, if one of the input parameters has a value of CxIgnore, the adapter does not set the values on the remaining input parameters, so the stored procedure is called with null values on the remaining input parameters. |
31633 | In a UNIX environment, a connector_manager_adapter script is generated by the installer program. The script references adapterEnv.sh, which was introduced with version 2.4.0 of Adapter Framework. If you are running an older version of Adapter Framework, adapterEnv is not available. To run this version of the adapter with a pre-2.4.0 version of the framework, change the reference from adapterEnv.sh to CWSharedEnv.sh in the connector_manager_adapter script. |
Product documentation is not included as part of the product package, either by CD or by electronic product distribution. The documentation for this product can be found in the following InfoCenters:
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbicollaborations/infocenter (for collaborations)
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
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.