Fix Pack Notes for
WebSphere Business Integration Server Express and Server Express Plus version 4.4.0.1 and 4.4.0.2

The patch notes contain the following sections: 
 

COMPLETED CHANGE REQUESTS

UPGRADE INSTRUCTIONS

ADDITIONAL DISCUSSION

UNINSTALL INSTRUCTIONS

 

Forward

The WebSphere Business Integration Server Express (Plus) 4.4.0.2 PTF contains fixes for all Server Express components which run on i5/OS V5R3 or OS/400 V5R2. This includes: the InterChange Server Express (Plus), Adapters, the Adapter Framework and Web-based Tools. When applying the PTF, it will determine which Server Express components are installed on the i5/OS system, and appropriately update the files and objects as needed. In the case that a Server Express component is installed to the i5/OS system after loading the 4.4.0.2 PTF, you will need to reapply the PTF as shown in the Additional Discussion.

Due to the length of this document, please use the Quick Links or print the document for your reference.

 

Important: The WebSphere Business Integration Server Express 4.4.0.2 fix pack should be applied to any Window’s PCs running the Server Express toolset as well as applying the 4.4.0.2 PTF to i5/OS. This will ensure the tools and all other components are at the same fix pack level.

 

Quick links by component:

Component

CRs Fixed

Files Installed

 

4.4.0.1

4.4.0.2

4.4.0.1

4.4.0.2

InterChange Server

InterChange Server CRs

InterChange Server CRs

InterChange Server Files

InterChange Server Files

Web-based Tools

 

Web-based Tool Crs

 

Web-based Tool Files

Adapter Framework

 

AF CRs

 

AF Files

JDBC/Oracle adapter

 

JDBC/Oracle CRs

 

JDBC/Oracle Files

JText adapter

 

JText CRs

 

JText Files

mySAP.com adapter

 

mySAP.com CRs

 

mySAP.com Files

TCPIP adatper

 

TCPIP CRs

 

TCPIP Files

JDEdwards OneWorld adapter

 

JDEdwards OneWorld CRs

 

JDEdwards OneWorld Files

JMS adapter

 

JMS CRs

 

JMS Files

WebSphere MQ adapter

 

WebSphere MQ CRs

 

WebSphere MQ Files

WebServices adapter

 

WebServices CRs

 

WebServices Files

iSeries adapter

 

iSeries CRs

 

iSeries Files

XML Data Handler

 

XML DataHandler CRs

 

XML DataHandler Files

Domino adapter

 

Domino CRs

 

Domino Files

 

 

COMPLETED CHANGE REQUESTS

 

This patch contains fixes for the following CRs based on customer reported and internally discovered issues.

 

4.4.0.2 InterChange Server Fixes:    Back to quick links

CR Number

As of Version

Problem

30899 / 44183

4.4.0.2

InterChange Server - Maps Runtime:
Map Designer puts verb=null / Participants data of composity identity relationship can't save.

66830

4.4.0.2

InterChange Server - Collaboration Runtime:

LLBP collaboration is unable to resubmit event because of full resource.

71221

4.4.0.2

InterChange Server:

InterChange Server 4.2.2.3 gets stuck or in hung situation. Memory leaks in the name service.

71436

4.4.0.2

InterChange Server:

Some memory leaks observed when Persistent Monitoring is used.

71720

4.4.0.2

InterChange Server - Security:
RBAC corrupted when using delete repository in System Manager.

72140

4.4.0.2

InterChange Server:
MsgId:46018-flow controlled resource is full.

72142

4.4.0.2

InterChange Server - Collaboration Runtime:

Behavior of event sequencing with child.

72420

4.4.0.2

InterChange Server - Connector Controller:

Only one adapter can be started via MQ triggering in WebSphere Business Integration Server Express.

72791

4.4.0.2

InterChange Server - Monitoring Service
Failed Event fails resubmission due to overcommitted memory check.

72853

4.4.0.2

InterChange Server - Collaboration Runtime:
Server throws hundreds of nullpointer exceptions in WIPTransaction context.

73161

4.4.0.2

InterChange Server:
WebSphere Business Integration Server Express doesn't automatically encrypt a plain text password.

73729

4.4.0.2

InterChange Server:
Tools get into a hung state once in a while.

71358

4.4.0.2

InterChange Server:

A slow memory leak in the PersistentMonitoring classes which over time will exhaust the ICS heap and crash the server.

72184

4.4.0.2

InterChange Server:

Failed events cannot be resubmitted when JVM memory is overcommitted.

72905

4.4.0.2

Fix pack (PTF) installer:

Reapply of the fix pack PTF after upgrade from Express to Express Plus not deleting all Express entries from product VPD.

72955

4.4.0.2

InterChange Server, Adapter and ODA jobs:

The InterChange Server, Adapter and ODA jobs on the iSeries system are not handling the ENDJOB command properly. They wait 2 minutes before actually terminating and also invoke the graceful path even when issued with an *IMMED option.

73283

4.4.0.2

Fix pack (PTF) installer:

PTF cannot be applied on a system with QFRCCVNRST greater than 3.

70687

4.4.0.2

create_instance.sh:
Creating instance with invalid port range values outputs invalid text.

73953

4.4.0.2

InterChange Server, Adapter and ODA jobs:

InterChange Server, Adapter and ODA jobs use the system QCCSID and QLANGID values for jobs rather than the job description’s user profile values when started using submit_xxxx.sh script.

67704

4.4.0.2

InterChange Server:

InterChange Server may hang during business rule deployment.

 


4.4.0.1 InterChange Server Fixes:                Back to quick links

 

CR Number

As of Version

Problem

61126

4.4.0.1

InterChange Server:

WBIA framework failed to handle non-printable characters when deliveryTransport=JMS

70535

4.4.0.1

InterChange Server:
Collaboration Job Scheduler fails when the scheduled period is in hours.

71526

4.4.0.1

Server Performance:

On i5/OS, use clearwarnings method on connections to improve DB performance

 

 

4.4.0.2 Web-based Tools Fixes:                    Back to quick links

 

CR Number

As of Version

Problem

73351

4.4.0.2

Web-Based tools:

Inprogress and queued events not displayed for synchronous collab.

71047

4.4.0.2

Web-based tools:

The Web-based tool’s WAS server is not auto-starting with the WAS 6.0 sub-system.

67737

4.4.0.2

Web-based tools:

Graph cannot be displayed properly on iSeries using the Dashboard.

 

4.4.0.2 Adapter Framework Fixes:               Back to quick links

CR Number

As of Version

Problem

61907

2.6.0.3

Unexpected exception for CwConnector.dll

62206

2.6.0.3

Siebel COM Connector is failing once in a while

60690

2.6.0.3

4.2.2.4 ICS breaks interfaces that the Siebel COM connector uses

71559

2.6.0.3

Duplicate ObjectEventID

71311

2.6.0.3

Siebel adapter hangs if it gets a Siebel-specific application error

71515

2.6.0.3

After pressing 'q' to exit the Siebel adapter, we get a fatal error

71399

2.6.0.3

Agent should stop polling events once the current MQ depth exceeds 90 percent of maximum depth

72342

2.6.0.3

Customer gets a Call Stack error while starting the Siebel adapter

66866

2.6.0.3

MQ source does not stop polling when ICS is killed

70839

2.6.0.3

ADK fix for WBI Server Express 4.4 - iSeries controlled end of adapter

60381

2.6.0.3

cwservice command has  2 times -t option

71857

2.6.0.3

P.E.  Synchronous scenarios do not work in 4.3.0.1

70953

2.6.0.3

Error message in case of different BO schema and XML sequence

70841

2.6.0.3

HTTP Adapter: Out of memory

70797

2.6.0.3

Invalid JMS type message needs to be clearer

66754

2.6.0.3

Meaning of MsgID: 165

66616

2.6.0.3

SAP adapter can't restart when there is an RFC_ERROR_SYSTEM_FAILURE error

70895

2.6.0.3

Message needs to be more meaningful

66664

2.6.0.3

Flooding IDLControllerProxy fatal error : CORBA ORB connection error

07633

2.6.0.3

DataHandler base class provides a mechanism for displaying the version

35953

2.6.0.3

Provide printStackTrace functionality in base datahandler class

25927

2.6.0.3

Set property when using Xerces 2

33724

2.6.0.3

Support for running an adapter as a service in stand-alone mode

37142

2.6.0.3

Exit when the adapter message file is missing

28564

2.6.0.3

Print the Adapter Framework version

 

4.4.0.2 JDBC/OracleApps Adapter Fixes:               Back to quick links

CR Number

As of Version

Problem

71314

2.6.3

Extra where clause and is null support:

The is null support doesnt work when we have more than one attribute in extrawhereclause, using retrieve verbASI. This issue has been resolved by composing proper query using multiple attributes in verb asi.

71139

2.6.3

Using blank values in event keys to retrieve bos using is null clause. Using cxblank in event keys to generate is null clause in retrieve query while polling:

The poll of an event with some keys as null is not composing the query with is null. Changes have been made to adapter to provide the value CxBlank in the key value , so that the adapter builds the is null clause correctly. The usage of cxblank in the event object keys is fixed and the adapter now builds the is null phrase properly on poll.

71391

2.6.3

Cursor leak, max cursors exceeding the set limit:

The fix involved closing the resultset, when an empty resultset was returned from a stored procedure call.

72378

2.6.3

Using blank values in keys of BO to retrieve using is null clause:

When processing an incoming BO,  with some keys as null is not composing the query with is null. Changes have been made to adapter to provide the value CxBlank in the key value , so that the adapter builds the is null clause correctly.

72988

2.6.3

When processing output parameters returned from the execution of a Function in the database, they are not retrieved in the correct order:

An incorrect index value was being used to retrieve output parameters of type String. This has now been fixed.

67474

2.6.3

When executing fetchConnection on Connection Pool, the method does not exit, if CloseDBConnection=true:

If the maximum number of DB connections was reached, the thread exits fetchConnection only when a connection is released and the thread is notified. If  CloseDBConnection=false, notify was being called. But it was not called when  CloseDBConnection=true. This has been fixed.

67496

2.6.3

JDBC Adapter was not allowing the insertion of data of size > 32k for input parameters of Stored Procedures:

There was no special handling done for input parameters to stored procedures that were of type CLOB. This has now been fixed.

45825

2.6.3

There are 2 pause statements in the startup script for Windows:

This has been corrected. The extra one has been removed.

61153

2.6.3

RetrieveSP not executed for Child BOs when UseDefaultsForPolling set to true:

There was a bug in the SP ASI Retriever that did not parse SP ASI if the value of that attribute was set to CxBlank, which happens when UseDefaultsForPolling was set to true. This is has been corrected.

66540

2.6.3

JDBC Adapter logs Error when setting TimingStats to default:

The TimingStats property was missing from template file. It has now been added.

67621

2.6.3

JDBC Adapter failed to handle CLOB with length between 4000 and 4096:

The check for size of CLOB was incorrect. That has been corrected.

70596

2.6.3

Remove references to data direct drivers in JDBC start scripts:

Required changes are done.

71729

2.6.3

JDBC ODA 2.6.2 does not work with BO Designer of AF 2.4:

The 2.4 framework is not BIDI enabled. The 2.6.2 JDBC ODA has BIDI enabled features and hence fails on 2.4.

Fix made to the ODA to check for the BIDI enablement in the ODK and make calls appropriately, to ensure backward compatibility.

72255

2.6.3

JDBC Connector does not retrieve rows with empty CLOB columns:

When CLOB was null, a NullPointerException was thrown. Proper check for null value has been introduced.

73152

2.6.3

Retieving N cardinality BOs with Progress DB fails:

The ProgressDB throws an exception if a close is issued on an already closed resultset. Corrected to ensure close is called only once.

73466

2.6.3

RetrieveSP appears to be called but is not returning resultset:

The AfterRetrieveSP SPs were getting called before the output parameters for RetrieveSP were completely processed. This has been fixed.

73476

2.6.3

Support for long int in stored procedures is missing:

The DriverSupportForLong property was not being used when processing parameters of stored procedures. This has been fixed.

 

4.4.0.2 JText Adapter Fixes:             Back to quick links

CR Number

As of Version

Problem

71620

5.6.2

When the Event or Output directories have an extra blank on the MO, the JText adapter would not recognize the directory. The problem has been rectified. The directories would be recognized now for leading and trailing spaces.

55201

5.6.2

If event datahandler was not included during request processing, output file would not get written to the output  directory.  Output datahandler property alone suffices during request processing. This issue has been resolved.  Now  it is not necessary to include event datahandler while request processing.

55373

5.6.2

The parseNextToken functionality of ConnectorUtil would fail if the first character of the EndBODelim is present in the content of the event file.This problem has been fixed in CwDataHandler patch version 2.6.1.

71561

5.6.2

JText adapter would access an event file and throw a file-lock warning for its own lock. The same has been rectified and the adapter now throws a warning when the file is locked by external non-adapter processes.

72218

5.6.2

JText adapter would crash and restart when zero-byte files with no extension is encountered. The issue has been fixed. If the event extension is .in(for eg.), then the files with no extension will not be polled irrespective of their size. The zero byte files with .in extension will be polled and archived as .damage.

72220

5.6.2

JText adapter would poll successfully for a while, then make poll rounds, but not pickup event files. The issue was found both with mapped drives and the local drives. The adapter no more gets into such a loop. The issue has been fixed. JText connector would reach to the 100% CPU mode and freeze during       polling on HP-UX.The above fix has rectified this issue as well.

48648

5.6.2

While polling/request processing in the FTP mode if the is being fetched from a machine which is in Japanese locale, the timestamp of the file would get appended to the name of the file. This has now been resolved in commons-net-1.1.0.jar package.

70670

5.6.2

If the file permission of the event folder being polled by the adapter is read-only, the adapter would pick-up the file for event processing, but would fail to delete it subsequently. In this scenario, a warning message would not get logged. This has now been rectified.

71211

5.6.2

When the adapter is trying to poll an event file being accessed by another program, it would fail to archive the file and go into an infinite loop causing 100% utilization of CPU. Checking for third-party lock and generating a warning message have rectified the problem.

70672

5.6.2

Whenever the adapter tries to access an event file even as it is being written to the event directory by a third-party application, the adapter would throw a ‘FileNotFound’ exception. The problem has been resolved by check for lock on event files.

67840

 

Updated CWDataHandler.jar file needed for Server Express to properly parse all values of EndBODelimiter meta-object attribute.

 

4.4.0.2 mySAP.com Adapter Fixes:              Back to quick links

CR Number

As of Version

Problem

73110

6.0.3

ALE Module:

Trace message was displayed incorrectly because the message ID was wrong.  It is displayed correctly with this fix pack.

72339

6.0.3

RFC Server Module:

SAP MQ queue configuration was required to start the RFC Server module.  With this fix pack they are not longer required when starting this module.

72078

6.0.3

All Modules:

mySAP ERP04 is now supported by the adapter.

71641

6.0.3

ODA:

The maximum length displayed in BAPI and RFC Server objects were incorrect for FLOAT data types.  With this fix pack the field maximum length is displayed properly.

71277

6.0.3

All Modules:

The log message utility now sends back the severity of the message to the broker.

71450

6.0.3

ODA, BAPI Module:

The ODA updates the verb ASI with the actual BAPI name for namespace BAPIs instead of replacing the "/" with an underscore. The adapter writes an error message if the BAPI name in the verb ASI cannot be found.

71306

6.0.3

ALE Module:

For malformed IDocs, the adapter was not creating an MQ message in the ALE error queue. With this fix, the adapter will send the failed IDocs to the ALE error queue.

71156

6.0.3

Extension Module:

The adapter now does not go into an endless loop when trying to process a field from SAP that does not exist in a child BO. This error was happening when the adapter was trying to set the BO values with the RFC data from SAP.

66792

6.0.3

ALE Module:

Adapter throws OutOfMemory error during event recovery in ALE module. This error happens when there are many events sitting in the ALE event queue. A new connector specific property "MaxInMemoryBufferSize" has been added to limit the the size of the in memory buffer used for performance optimization. For more details on configuring this property refer to the Technote "Memory utilization for the IBM WebSphere Business Integration Adapter for mySAP.com v6.0.0 (ALE module)". With this fix adapter manages the memory properly.

70697

6.0.3

Extension Module:

When an event fails in a poll cycle the remaining events stayed in the event table with status ‘R’. With this fix the remaining polled events will be processed.

48259

6.0.3

Extension Module:

A new configuration property called TrimSpaces has been created for users that want to remove white space at the beginning and end of the attribute values received from SAP Extension Module.  To use this new property, set TrimSpaces to “yes”.  Otherwise, the default behavior of trimming the trailing spaces will remain.

 

4.4.0.2 TCPIP Adapter Fixes:                       Back to quick links

CR Number

As of Version

Problem

71407

1.0.4

Event Handler:

Whenever an Error/Exception scenario happens during Event/Request processing, an Error Handler code is invoked by the adapter. The Error Handler is configurable and customised code can be written.

71299

1.0.4

Synchronous Request Processing Performance:

Performance has been improved during Synchronous Request Processing. Connection Pooling to connect to remote TCPIP server has been provided.Connection pooling can be switched off by setting CFG property ConnectionPoolingOn to false.

70741

1.0.4

BO_Verb Support in Static MO:

Support for BO_Verb attribute has to be provided for the TCPIP Adapter during Request/Outbound Processing.

48205

1.0.4

Base64 Encoding:

Support for Base64 Encoding of Incoming Data and Base64 Decoding of Outgoing Data. This can be done through configuration properties.

 

4.4.0.2 JDEdwards OneWorld Adapter Fixes:                     Back to quick links

CR Number

As of Version

Problem

59966

2.0.2

Support for Framework 2.6.0:

There were changes in framework from 2.4.0 to 2.6.0

60854

2.0.2

Support for version 8.94 Tools

61659

2.0.2

The archive time was not being set:

The archive table does not get archive time populated.

 

4.4.0.2 JMS Adapter Fixes:  Back to quick links

CR Number

As of Version

Problem

72292

2.8.1

Adapter will accept (optional)id/password to connect to JMS Provider. If id/password is
provided, same will be used for authentication, else adapter will assume the system defaults.

72274

2.8.1

If a connection already has client ID associated with it and attempt is made to set client ID again, an exception is thrown. Checks are implemented to avoid this situation.

71128

2.8.1

Fixed a problem in the WebSphere MQ adapter so that the adapter does not trim spaces from the correlationID in the MQMD header as this was causing incorrect correlation id problem in case of binary.

67384

2.8.1

As per documentation, adapter should trace a message at trace level 1 when it detects event in the Input Destination and not for empty Input Destination. The code is fixed for the same.

67516

2.8.1

During adapter processing, it was observed that it accepts only CRUD, Exists and RetrieveByContent as verbs. This CR fixes the issue by allowing other custom verbs.

78700

2.8.1

If the JNDI provider becomes unavailable during adapter run, adapter encountered
exceptions but did not terminate and restart (based on retries setting). The fix ensures
adapter terminate and restart as appropriate.

 

4.4.0.2 WebSphere MQ Adapter Fixes:                   Back to quick links

CR Number

As of Version

Problem

71909

2.8.1

If Supported  Business Objects list does not contain a BO that is defined in the static MO, NullPointerException was thrown during adapter startup. This problem is fixed in this CR.

62138

2.8.1

In addition to previously supported Client mode (default), the adapter now provides support for Bindings mode.

71128

2.8.1

Fixed a problem in the WebSphere MQ adapter so that the adapter does not trim spaces from the correlationID in the MQMD header as this was causing incorrect correlation id problem in case of binary.

67384

2.8.1

As per documentation, adapter should trace a message at trace level 1 when it detects event in the Input Destination and not for empty Input Destination. The code is fixed for the same.

71465

2.8.1

Support for the newer version of IBM WebSphere MQ Series 6.0

67516

2.8.1

During adapter processing, it was observed that it accepts only CRUD, Exists and RetrieveByContent as verbs. This CR fixes the issue by allowing other custom verbs.

 

4.4.0.2 WebServices Adapter Fixes:                        Back to quick links

CR Number

As of Version

Problem

67572

3.4.3

Fatal error in parsing SOAP messages and XSD content in WSDL files due to incompatible version of XML/XSD parser in the classpath. Fixed by removing "%INSTALLEDDIR%"\connectors\WebServices\dependencies\j2ee.jar

67583

3.4.3

During synchronous request processing, HTTP error responses with empty payloads are ignored by the adapter. Fixed. All error responses with empty payloads will result in failure of the originating request.

71832

3.4.3

SOAP/HTTP(S) listeners fail redirected HTTP(S) requests. Problem background:

According to HTTP 1.1 specifications (http://www.w3.org/Protocols/rfc2068/rfc2068), section 5.2, SOAP/HTTP(S) listener checks the correctness of host and port information specified in the request with host and port information of the listener itself. If there is a mismatch, the listener will stop processing the request and respond with a 400 (Bad Request) status code.

Issue:

When incoming requests are being routed by an enterprise gateway system in order to hide the end point, the host and port information of the request has to be changed before being sent to the SOAP/HTTP(S) listener (original request has host and port of the gateway). In some cases, such change is not supported by the gateway or is troublesome to implement in the gateway system.

Solution:

A new SOAP/HTTP(S) listener property has been introduced to solve the above issue. Please note that using this property to disable the validation of host and port information of the request, puts the SOAP/HTTP(S) listener out of compliance with HTTP 1.1 specification, section 5.2. Use of the new property should be restricted to the cases when an enterprise gateway system change is undesirable.

To use this feature, add the following property to the SOAP/HTTP(S) Listener Property:

Property Name

Possible Values

HostInfoValidation

FailRequest - if host/port info of the request does not match the host/port info of the listener, the error message will be logged and request will be failed with 400 (Bad Request) status.

LogError - if host/port info of the request does not match the host/port info of the listener, the error message will be logged and request execution will continue.

Ignore - there will be no validation performed on the host/port info of the request.

Note: If the property does not exist, the SOAP/HTTP(S) listener will DEFAULT property value to FailRequest

71572

3.4.3

Support Userid/Password authentication when establishing connection to JMS provider. Adapter for Web Services now supports two new properties under JNDI hierarchical property:
JMSProviderUserid
JMSProviderPassword
.

Note: Only if the value of JMSProviderUserid property is not empty, a new authentication method will be used.

71699

3.4.3

The SOAP Data Handler appends new line after element opening tag; inconsistency with new line appearing for nil elements. Nil elements will not contain new lines after the opening tags.

Non-nil elements will behave according to the property UseNewLine of SOAP Data Handler MO. Possible values are true/false.

Value of true would add new line after element opening tag; false would append the element content right after the tag. Default is true for backward compatibility

70984

3.4.3

WSDL ODA does not recognize complex types derived by extensions in case when no additional elements are added to the extended complex type.

62274

3.4.3

The SOAP Data Handler does not support n-cardinality SOAP Attributes on Simple Type Elements by using elem_value ASI.

29113

3.4.3

WSDL ODA and SOAP Data Handler do not support nillable elements. A new ASI "nillable=true" is now supported.
Nillable attributes are supported in Business Object to SOAP message transformations only.

44131

3.4.3

WSDL ODA fails to display error message when it contains NULL (0x0000) character.

61927

3.4.3

WSDL ODA fails to resolve Business Objects types when complex types are defined in the separate inline schemas.

 

4.4.0.2 iSeries Adapter Fixes:                       Back to quick links

CR Number

As of Version

Problem

33404

2.1.0.1

Globalize iSeries adapter and ODA

33937

2.1.0.1

Support non-RPG programs (COBOL,JAVA etc) in iSeries adapter.New verb ″CALLPGM″ has been added to support this function.

58801

2.1.0.1

ODA can now parse MBR files with record length as specified in SRCDTA and not restricted to 92 i.e. 80 chars source line

60060

2.1.0.1

iSeries ODA should support RPG Source Programs along with RPGLE

47261

2.1.0.1

Support for 2.6 ODK's new delimiter

73311

2.1.0.1

Padding problem while using DBCS string attributes in BO [fixed in 2.1.0.1TF]

 

4.4.0.2 XML DataHandler Fixes:                 Back to quick links

CR Number

As of Version

Problem

 

44470

2.7.2

XML ODA may fail to generate BOs when a schema file has a reference to an element or complex type in another schema file.  Fails with "Error in call core.setAgentProperties: schema for type XXXXX not found".

 

62002

2.7.2

XML ODA fails to generate BO definitions, resulting in a NullPointerException due to lack of nested AttributeGroup support.

 

62009

2.7.2

XML Data Handler doesn’t preserve whitespace in simple tags.

 

67394

2.7.2

XML Data Handler always performs escape processing (regardless of MO and ASI configuration) when converting from a BO to XML for BO attributes representing XML attributes.

 

71298

2.7.2

XML Data Handler fails to convert an XML stream to a Business Object with a NoSuchAttributeException.  

 

71953

2.7.2

XML Data Handler failed to process nested mixed type elements.

 

72301

2.7.2

XML Data Handler assumes the Byte Order Mark has been removed in an xml response.

 

1. Only the "getBO(InputStream serializedData, Object config)" method supports xml content containing a bom.

2.  If the aforementioned method is called and the inputStream contains a recognized BOM the method will automatically invoke the setEncoding() method of the BO handler.

3.  The standard polling method invoked by components (i.e. JText Adapter) is a “getBO(Reader, …)” method that assumes the bom has been removed.

 

72730

2.7.2

XML Data Handler unable to process complex BOs.  “Formatting failed. Reason :: There is no attribute at position ‘-1’ in business object definition ‘XXXXXXX’”

 

73328

2.7.2

XML Data Handler fails to process documents with a top level element value containing the character ‘-‘.

 

4.4.0.2 Domino Adapter Fixes:                     Back to quick links

CR Number

As of Version

Problem

73332

1.3.0 IF

Domino event handler module:

The domino event handler was causing jobs in the Domino sub-system to not end properly on iSeries OS/400. On Window’s, the same problem was observed as a crash of the Domino server.

72585

4.4.0.2

Domino adapter Business Objects:

DominoDocument Business Object missing from Sever Express 4.4 install

 

 

 

UPGRADE INSTRUCTIONS 

For i5/OS:

  1. If not already completed, install IBM Software Integration Assistant (5722IA1) Option 15 on the system in order to enable PTF support for WebSphere Business Integration Server Express 4.4. Please see the Integration Assistant support site at http://www-1.ibm.com/servers/eserver/support/iseries/tools/swassist/ for more information.
  2. If not already completed, Load and apply PTF SI18540 (Server Express 4.4.0.1), following the instructions in the PTF cover letter.
  3. Load and apply PTF SI20363 (Server Express 4.4.0.2), following the instructions in the PTF cover letter.
  4. Install the 4.4.0.2 Windows fix pack on any tools systems using the installation instructions for the Window’s installer.
  5. See the Additional Discussions for considerations if Server Express (Plus) components are installed after applying the PTF.

 

Below are lists of files that were updated/replaced in this patch:

 4.4.0.2 InterChange Server Files:

For Server Express/
Server Express Plus

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/Crossworlds.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/datamanager.jar

4.4.0.2

i5/OS

Replace

/QSYS.LIB/QWBISVR44.LIB/QWBISTRVM

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/adapter_util.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/bin/ITLM.lic

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/version.properties

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/ServerInstance.jar

4.4.0.1 InterChange Server Files:                 Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.1

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/Crossworlds.jar

4.4.0.1

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/amitmodule.jar

4.4.0.1

i5/OS

Replace

/QIBM/ProdData/WBIServer44//bin/ITLM.lic

4.4.0.1

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/version.properties

 

4.4.0.2 WebTool Files:                       Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/WBSM/CWDashboard.war

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/webtools_util.jar

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/WSBM/CWDashboard_fix.jacl

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/WSBM/CWDashboard_fix.sh

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/bin/CWDashboard_redeploy.sh

 

4.4.0.2 Adapter Framework Files:                Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/jmsmgr.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/lib/WBIA.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/messages/WBIAdapterRuntime.txt

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/wbiart/wbiart.jar

 

4.4.0.2 JDBC/OracleApps Adapter Files:                Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors /JDBC/dependencies/archive_table_oracle.sql

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors /JDBC/CWJDBC.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/ODA/ JDBC/JDBCODA.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OracleApps/dependencies/archive_table_oracle.sql

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OracleApps /CWOracleApps.jar

 

4.4.0.2 JText Adapter Files:              Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors /JText/Dependencies/commons-net-1.1.0.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors /JText/CWJText.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/DataHandlers/CWDataHandler.jar

 

4.4.0.2 mySAP.com Adapter Files:               Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/messages/SAPConnector.txt

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/SAP/dependencies/transports_40_45_46/40_45_46_Infrastructure.zip

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/SAP/dependencies/transports_47/47_Infrastructure.zip

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/SAP/ISAPlugin/com.ibm.esupport.client.SSMKUK_WBIAmySAP.zip

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/SAP/CWSAP.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/ODA/SAP/SAPODA.jar

 

4.4.0.2 TCPIP Adapter Files:                        Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/messages/BIA_TCPIPAdapter.txt

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/TCPIP/BIA_TCPIP.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/repository/TCPIP/sample/BIA_TCPIPAdapterRepository.zip

 

4.4.0.2 JDEdwards OneWorld Adapter Files:                      Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/messages/BIA_OneWorldAdapter.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OneWorld/dependencies/BIA_EVENT80.exe

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OneWorld/dependencies/BIA_EVENT8.90.exe

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OneWorld/dependencies/BIA_EVENT8.94.exe

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OneWorld/dependencies/Sources.8.0.zip

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OneWorld/dependencies/Sources.8.9.zip

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/connectors/OneWorld/BIA_OneWorld.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/AdapterCapacityPack/ODA/OneWorld/BIA_OneWorldODA.jar

 

4.4.0.2 JMS Adapter Files:               Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/messages/JMSConnector.txt

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/JMS /CWJMS.jar

 

4.4.0.2 WebSphere MQ Adapter Files:                    Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/messages/WebSphereMQConnector.txt

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/WebSphereMQ /CWWebSphereMQ.jar

 

4.4.0.2 WebServices Adapter Files:             Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/messages/WebServicesConnector.txt

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/WebServices/CWWebServices.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/DataHandlers/CwSOAPDataHandler.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/ODA/WSDL/WSDLODA.jar

           

4.4.0.2 iSeries Adapter Files:                        Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/connectors/iSeries/BIA_iSeries.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/ODA/iSeries/BIA_iSeriesODA.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_de_DE.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_en_US.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_es_ES.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_fr_FR.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_it_IT.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_ja_JP.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_ko_KR.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_pt_BR.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_zh_CN.txt

4.4.0.2

i5/OS

Add

/QIBM/ProdData/WBIServer44/product/ODA/messages/BIA_iSeriesODAAgent_zh_TW.txt

 

4.4.0.2 XML Data Handler Files:                 Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/DataHandlers/CwXMLDataHandler.jar

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/ODA/XML/XMLODA.jar

 

4.4.0.2 Domino Adapter Files:                      Back to quick links

For Server Express/
Server Express Plus Version

Platform

Add / Replace / Remove

File

4.4.0.2

i5/OS

Replace

/QSYS.LIB/QWBISVR44.LIB/LIBBIALD.PGM

4.4.0.2

i5/OS

Replace

/QSYS.LIB/QWBISVR44.LIB/LIBBIALD.FILE

4.4.0.2

i5/OS

Replace

/QIBM/ProdData/WBIServer44/product/repository/Domino/DominoDocument.xsd

 

 

 

ADDITIONAL DISCUSSIONS

  1. The installer will install patch files only for the components found on the system.
  2. As part of WBI Server Express/WBI Server Express Plus fix pack 4.4.0.1, a new business rule property ‘Long live detection’ is available for business rules with detection types ‘Not’, ‘Unless’ or ‘At Most’. By default, the property ‘Long live detection’ is set to ‘No’, meaning that business probe events that are relevant for calculating detection of the current business rule is kept in memory. When the property ‘Long live detection’ is set to ‘Yes’, business rule detection information will be stored in the database instead. As a general guideline, user should consider enabling ‘long live detection’ in business rules that has a longer effective time span (i.e. business rules that last for weeks or months, etc). By doing so, it will allow more optimized memory usage during business rule detections in runtime.
    For existing business rules with detection types ‘Not’, ‘Unless’ or ‘At Most’, the default setting for ‘long lived detection’ is ‘No’. Existing business rules will continue to work and do not require being upgraded. To enable ‘long lived detection’ in an existing business rule definition, simply open the business rule definition System Manager, modify its property value and redeploy to the ICS server.
  3. For i5/OS, the patch is delivered in PTF SI18540 (Server Express 4.4.0.1) and SI20363 (Server Express 4.4.0.2) for server related fixes. Windows based tools must be updated using the Windows patch installer on the tools' PC.
  4. IMPORTANT – If additional Server Express (Plus) components are installed after applying the fix pack PTF, the PTF must be reapplied to ensure the files are up to date. For example, suppose the InterChange Server and JText components are installed to the i5 system and the 4.4.0.2 PTF is applied. Furthermore assume sometime after applying the 4.4.0.2 PTF, the JDBC and SAP adapters are additionally installed to the i5 system. Since there was an additional install after the 4.4.0.2 PTF was already applied, the PTF will need to be reapplied.
  5. WebSphere Business Integration Server Express (Plus) 4.4.0.2 has been validated using WebSphere MQ CSD11, and CSD11 is now supported for the iSeries version of Server Express.
  6. When removing the SI20363 (Server Express 4.4.0.2) PTF from iSeries, Web-tools files will get removed, but the Web-tools applications will not be reverted to their previous version. That is, the web-tools application changes are permanent.
  7. To reapply the fix pack PTF enter the following two CL commands from an iSeries telnet session in the order listed:

CALL QIA1OPT15/QWBIPTF

CALL QIA1OPT15/QWBIPTF02

 

 

UNINSTALL INSTRUCTIONS

1.      Remove PTF SI20363 from the system to uninstall the 4.4.0.2 patch.

2.      Remove the PTF SI18540 from the system to uninstall the 4.4.0.1 patch.

3.      Use the instructions from the Windows Server Express fix pack to uninstall the patch on Windows.

© 2005 IBM Corporation.  Proprietary and Confidential.  All Rights Reserved.