Patch Notes for
Version  1.4.3 of the WBIA API

(for ICS 4.0.1,4.1.0,4.1.1,ADK 2.0.0,2.1.0, 2.2.0)

The patch note contains the following sections:


CONNECTOR REVISIONS

UPGRADE INSTRUCTIONS

CONNECTOR REVISIONS

This patch contains the following revisions since the last maintenance release:
 


Available as of Version CR Number/APAR# Feature Description
      1.4.3   24238/JR18724 Using getdoubleValue(int i) or getdoubleValue(String str) from CWConnectorBusObj Class to retrieve a double from an attribute. If the value is a real double like 100,23, the method call is successfull.
If the value in the attribute is 100,00 or 100 you will receive a java.lang.ClassCastException: java.lang.Long.
 		 The parse method call on NumberFormat was implicitly cast to a Double.
 JDK 1.3.1 documentation lists that parse:
Returns a Long if possible (e.g., within the range [Long.MIN_VALUE, Long.MAX_VALUE] and with no decimals), otherwise a Double. 

However an object of type Long can never be implicitly cast to a Double (throws a ClassCastException).

The solution involves making the doubleValue call on Number.
 This operates also correctly if 100 or 100,00 is entered.
 
        1.4.2     23369/JR18530 There is a call to doVerbFor from getBO method in the event store. The APPRESPONSETIMEOUT status from this doVerbFor call was not getting propagated to pollForEvents and hence the connector was not terminating. Two new methods setTerminate() and getTerminate() have been added to CWConnectorEventStore. In the default implementation of getBO, the status from doVerbFor is checked. If this is APPRESPONSETIMEOUT, setTerminate method is called to set the terminate flag.
In the default pollForEvents, getTerminate is called on the event store after getBO method call. If this returns true, an APPRESPONSETIMEOUT is returned from pollForEvents which terminates the adapter.
        1.4.2      23239/JR18530 CWODAEnv.sh had a missing : between jars. The typo resulting in a missing : between the two jars MQ_LIB and CONN_LIB has been fixed.
1.4.1 22303/JR18097 The common scripts had dependencies on different variables for providing backward compatibility. All the backward compatibility dependencies are now consolidated and CWVERSION variable value is used to set all of them. If the version is not 1.4.0 or later, you must download the latest WBIA runtime.
Downloading the WBIA runtime
To download the latest version of the WBIA runtime:
  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 runtime, you should see the following files:
(Windows)
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
bin\CWODAEnv.bat
connectors\messages\
CwConnectorAgentMessages.txt
(Solaris and AIX)
 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.sh
     bin/CWODAEnv.sh
     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, 4.1.0, ADK version 2.0.x

In CWConnEnv.bat/sh, set the CWVERSION variable to 4.X.   set CWVERSION="4.X"

InterChange Server versions 4.1.x (except 4.1.0), ADK version 2.1.x
In CWConnEnv.bat/sh, set the CWVERSION variable to 4.1.X.  set CWVERSION="4.1.X"
Running an Object Discovery Agent (ODA) against ADK version 2.1.x

In bin\CWODAEnv.bat/sh, set the CWVERSION variable to 4.1.X.  set CWVERSION="4.1.X"
1.4.1 20549/JR18097 Exception message from the execution of initAndValidateAttributes was not propagated to the user. The same has been fixed.


UPGRADE INSTRUCTIONS
Add, replace, or remove the following files and directories as indicated (Note that these are rolled up in the patch you downloaded):

%APP% is Siebel.
 


For Connector Version Platform  Add / Replace / Remove File (Starting from %CROSSWORLDS%/$CROSSWORLDS)
 1.4.2   UNIX   Replace the file  /bin/CWODAEnv.sh
\lib\WBIA.jar
\lib\WBIA\3.0.0\WBIA.jar
\lib\WBIA\4.0.0\WBIA.jar
 \lib\WBIA\4.1.1\WBIA.jar
 1.4.1  WIN & UNIX  Replace the file  \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
  /bin/CWConnEnv.sh
  \bin\CWODAEnv.bat
  /bin/CWODAEnv.sh

Configure the following for the patch to work:
 


Connector 
Version		 Platform Add / Remove Property/Legal values (Case-Sensitive)
   -    -   -   -

January 07, 2002 2:32 PM

© 2001 CrossWorlds Software, Inc. Proprietary and Confidential. All Rights Reserved.