These release notes cover release information for IBM(R) WebSphere(R) Business Integration Server Express, Version 4.3.1, for OS/400(R). They contain the following sections:
Overview | Known problems and workarounds |
Hardware and software requirements | Documentation |
Installation and configuration information |
Note: Important information about this product may be available in Technical Support Flashes issued after these release notes were published. The Flashes can be found on the WebSphere Business Integration support Web site, http://www.ibm.com/software/integration/wbiserverexpress/support. Select the component area of interest and search the flashes section.
IBM WebSphere Business Integration Server Express and IBM WebSphere Business Integration Server Express Plus comprise the following components:
In addition to existing support on Windows(R) 2000, this release adds support for InterChange Server Express on the following operating systems:
Hardware and software requirements are included in the product documentation. See Installation and configuration information for links to those guides.
Whether you are installing the software from the CD or downloading it from Passport Advantage and installing it from a local directory, refer to WebSphere Business Integration Server Express Installation Guide for OS/400.
Note: If you are installing the technology adapters and application adapters on the same machine, install the technology adapters first, through Server Express Plus, then install each application adapter through the Adapter Capacity Pack installer.
The following problems have been found in this release:
Component name | Tracking number | Description | ||||||||||||||||||
Activity Editor | 42343 | In Activity Editor, you can select from a list of global variables in the
Library Window to use in a custom activity. Global variables can be as
simple as a Java variable (for example, of type String) or they can be
as sophisticated as a business object variable (for example, of type BusObj).
When a global variable is used in an activity, its assignment happens only
at the end of the activity, so you should avoid using separate variables
that have the same root variables in one activity. Instead, you can do two sub-activities in different actions. If you must use variables with the same root, try to re-use the single root variable instead. |
||||||||||||||||||
Adapters | 43586 | The AgentTraceLevel property for a connector running over the JMS delivery transport and using a local connector configuration (specified through the -c command line option) can only be dynamically updated once through System Manager during the connector's lifetime. Subsequent attempts to dynamically update this property will fail. A message resembling the following will be shown in the logs: [Type: Warning] [MsgID: 14211] [Mesg: Dynamic update is not allowed for AgentTraceLevel. In the configuration file, value was already set for the connector agent and previously set value will be used.] The AgentTraceLevel property for a connector running over the JMS delivery transport and using a local connector configuration should not be dynamically updated via System Manager. If the property needs to be modified, you must update the connector configuration file and restart the connector agent. Otherwise, the error just described will be encountered and a mismatch between the connector controller setting and the connector agent setting may occur. |
||||||||||||||||||
Adapter for JText | 46499 | If more than one file matches the event mask in MVS PDS, and FTPRenameExt is specified, the connector archives only one file and is not able to rename and archive the second file. To work around this, specify both FTPArchiveDir and FTPRenameExt as blank, so that the MVS event file is deleted without being renamed. | ||||||||||||||||||
Adapter for JText | 43454 | When the JText adapter is polled with the EventExt attribute of the JText configuration meta-object MO_JTextConnector_Default set to blank, the polling fails and the adapter terminates. | ||||||||||||||||||
Adapter for JText | 35571 | A provision to specify 'EOF' as a value to the EndBODelimiter in the binary
processing mode is required. To work around this, for all files with no other EndBODelimiter than the EOF itself, use a Hex editor to include a couple of bytes (for example, FF02) as the delimiter, and specify the bytes as the EndBODelimiter. |
||||||||||||||||||
Adapter for JText | 34834 | Secure FTP support is required by JText. The password field, visible to the JText system administrator now, would not be visible to anyone with Secure FTP. | ||||||||||||||||||
Adapter for JDBC | 43503 | When you use the ODA to generate a business object from a DB2 database
server running on Linux, the Business Object Designer will hang. This occurs
because the DB2 JDBC Applet Server does not start.
To work around this, log into the DB2 server, and run the following command: db2jstrt LISTENPORT. |
||||||||||||||||||
Adapter for JDBC and Adapter for Oracle Applications | 43246 | The start script for the OracleAppsODA includes the xworacle.jar file in the DRIVERPATH, which does not list all tables in the Oracle database as expected. If you want to list all the tables in the database, you can work around this problem by using the native JDBC driver-classes12.zip file provided by Oracle. Set the driver path appropriately in the start scripts according to the instructions in the adapter user guide. | ||||||||||||||||||
Adapter for JMS and Adapter for WebSphere MQ | 37094 | While processing an in-doubt message (from InProgressQueue) that originated from one of multiple configured input queues, the adapter retrieves the conversion properties based on the first input queue in the connector-specific properties. | ||||||||||||||||||
Adapter for JMS and Adapter for WebSphere MQ | 34323 | The samples for the JMS and WebSphere MQ adapters are designed to provide
configuration and use of the adapters in a WebSphere InterChange Server
Express environment. The instructions for using these samples are provided
in technotes that describe how you can use the samples to send and receive
business objects in a WebSphere Business Integration Server Express environment.
The technote for the JMS adapter can be found at the following location: http://www-1.ibm.com/support/docview.wss?rs=0&q1=JMS+adapter&uid=swg21174512&loc=en_US&cs=utf-8&cc=us&lang=en The technote for the WebSphere MQ adapter is available at the following location: http://www-1.ibm.com/support/docview.wss?rs=0&q1=WebSphereMQ+adapter&uid=swg21174510&loc=en_US&cs=utf-8&cc=us&lang=en |
||||||||||||||||||
Adapter for JMS and Adapter for WebSphere MQ | 33728 | During event processing, when multiple conversion properties match either
the InputFormat or InputQueue, or both, of an input message, the adapter
tries to incorrectly use the last matched business object attribute in
the static meta-object as a map for the input message. In such cases, the
adapter should pass the message content to the data handler to allow the
data handler to determine the business object name.
To work around this, configure unique InputFormat and InputQueue keys for each of the BusinessObjectType_verb attributes in the static meta-object. |
||||||||||||||||||
Adapter for JMS | 36128 | The adapter fails to initialize when the InputQueue property is not configured. | ||||||||||||||||||
Adapter for JMS | 36438 | Conversion property names in the application-specific information of the configuration meta-object and the dynamic meta-object names are case sensitive. | ||||||||||||||||||
Adapter for WebSphere Commerce | 42516 | When WebSphere Commerce, Business Edition, version 5.5 with Fix Pack 4 (or earlier version) is used on the commerce server, the store user cannot be created properly with the WebSphere Commerce adapter. The store user cannot log onto the store because of improper authority. A WebSphere Commerce efix is required to fix this problem. The efix is JR20090 on WebSphere Commerce 5.5 with Fix Pack 4. | ||||||||||||||||||
Adapter for WebSphere MQ | 34969 | During synchronous event processing, a report message is not sent for data handler errors. | ||||||||||||||||||
Adapter Capacity Pack | 58762 | If you install an application adapter from the Adapter Capacity Pack to
an OS/400 system that has either the Server Express Plus InterChange Server
or the Web Tools (or both) installed, but does not have any technology
adapters installed, your application adapter might fail to start. To work around this, run the Launchpad and install a technology adapter (for example, e-Mail, JText, or JDBC). After the installation is complete, you will be able to start the application adapter. |
||||||||||||||||||
Adapter Capacity Pack | 58799 | If you install an application adapter from the Adapter Capacity Pack to an OS/400 system that does not have Server Express Plus installed, the application adapter might fail to start. (The adapter log will indicate a ClassNotFoundException.) To work around this problem, do one of the following: Enter the following command on the command line to copy the WBIA.jar file to the product library: CPY OBJ('/QIBM/ProdData/WBIServer43/AdapterCapacityPack/lib/WBIA.jar') TODIR('/QIBM/ProdData/WBIServer43/product/lib') OWNER(*KEEP).Note: Ensure that the file owner and authorities of the copied file match the original .jar file. Run Launchpad and install a technology adapter (for example, e-Mail, JText, or JDBC). After the installation is complete, you will be able to start the application adapter. |
||||||||||||||||||
Installer (Adapter Capacity Pack) | 44001 | When you do a remote or local capacity Pack installation for the Adapter for Metasolv and JD Edwards OneWorld on Windows 2000 and try to launch the adapter, it terminates with an error: The input line is too long. This is because of the command line length issues on Windows 2000. You will see the same problem with WebSphere Business Integration Adapters for Siebel and Oracle Applications when you do a remote CP install. A workaround to this issue is planned for a technote to be available after this release. | ||||||||||||||||||
Adapters and OS/400 user profile security | It might be necessary for security reasons to change the user profile that
the adapter agent processes run under for OS/400. For example, if the adapter
is JDBC or JText, the authorities to your database for JDBC or to the directories
and files for JText might be such that you do not want to grant the QWBISVR43
user profile authority to them. If this is the case, you will have to perform
the following actions to enable the Adapter to successfully run under a
user profile other than QWBISVR43:
|
|||||||||||||||||||
Documentation | The Data Handler Guide guide incorrectly refers to and provides documentation for the binary host data handler. The binary host data handler is not included in the product. | |||||||||||||||||||
Documentation | The guide for the MetaSolv Adapter should state that the Metasolv Adapter now supports Product Service Request (PSR) and Local Service Request (LSR) modules. | |||||||||||||||||||
Documentation | For all guides, the "New in this release" section should read
as follows:
In addition to existing support on Windows 2000, this release adds support for InterChange Server Express on the following operating systems:
|
|||||||||||||||||||
DB2(R) Enterprise on Windows | 35380 | DB2 Enterprise does not restart the database manager when Windows restarts.
Because the database manager is not running, two problems can occur if
Windows restarts during the installation of WebSphere Business Integration
Server Express or Express Plus:
You can address both of these problems by taking the following steps:
After you have performed these steps, you can create a repository and successfully start InterChange Server Express. |
||||||||||||||||||
DB2 Enterprise and DB2 Express uninstallers on Windows | 35380 | If either DB2 Enterprise or DB2 Express and WebSphere Business Integration
Server Express (or Express Plus) have been previously installed and uninstalled,
the repository creation fails during reinstallation of WebSphere Business
Integration Server Express or Express Plus. This occurs because the uninstallation
process for DB2 Enterprise and DB2 Express does not remove aliases for
databases from the directory C:\DB2\aliases_directory. Therefore, the alias for the InterChange Server Express repository called SMB_DB, which is created during the original installation of WebSphere Business Integration Server Express or Express Plus, remains after the uninstallation of DB2. Although the existence of this alias does not affect the reinstallation of DB2 Enterprise or DB2 Express, when WebSphere Business Integration Server Express or Express Plus is reinstalled, the repository creation fails because the system finds the old SMB_DB alias. To work around this, manually delete the SMB_DB database before uninstalling and reinstalling DB2 Enterprise or DB2 Express. Deleting the actual database eliminates its alias. |
||||||||||||||||||
Installer (All) | 46851 | Unresolved text from resource bundles may appear in the window during file
transfer. In particular, the following might display: $L(com.ibm.wbi.install.common.i18n.WBIProductResources,
businessIntegrationServerExpressPlusProduct.displayName). What should display is: WebSphere Business Integration Server Express Plus V4.3.1. |
||||||||||||||||||
Installer (All) | 43593 | The title text may be truncated on the message dialog boxes due to its length; however, the intended content of the message displays. | ||||||||||||||||||
Launchpad | Before installing the DB2 Express or WebSphere MQ components, you must
disable any real-time file-system protection features of installed antivirus
software.
If you have Norton AntiVirus software installed, you can disable its real-time file-system protection feature by stopping the Norton AntiVirus Client Windows service. For other antivirus products, refer to the product documentation for instructions on how to disable the real-time file-system protection feature. You can enable the antivirus software after the DB2 Express or WebSphere MQ components have been installed. |
|||||||||||||||||||
Launchpad | 58560 | The Toolset Express component is automatically installed when the Samples component is being installed, even if you clear the check box next to Administrative Tools and Development Tools. This happens because the Launchpad GUI does not refresh correctly to reset the check boxes. | ||||||||||||||||||
Launchpad | 35851 | The installation of DB2 Express or WebSphere MQ version 5.3.0.2 with CSD
6 might fail when installed through the electronic image, if the images
are downloaded to a location with spaces.
To work around this, extract the electronic images to a location that does not contain spaces. |
||||||||||||||||||
Launchpad | 37017 | When running the Launchpad from a CD, the Launchpad splash screen hangs
at the initial window. Some CD drives labeled DVD Multi Player & Compact
Disk Rewritable High Speed (the drive has to be both of these) may cause
the Express Plus CD to hang during installation, and the splash screen
will hang indefinitely. To work around this, if possible, configure the CD drive to remove the high speed capability during installation. If this is not possible, run the installation from the electronic software delivery (ESD) image. You can also try copying the contents of all the CDs to the hard drive. |
||||||||||||||||||
OS/400 V5R2 Required PTFs | The following PTFs are required to be loaded on your OS/400 V5R2 system:
|
|||||||||||||||||||
OS/400 V5R3 Required PTFs | The following PTFs are required to be loaded on your OS/400 V5R3 system:
|
|||||||||||||||||||
System Monitor | 43759 | If you are using Netscape 4.7x with double byte character languages, the characters may not display in Netscape. To configure Netscape to enable the double byte character set characters to display, follow these steps:
|
||||||||||||||||||
System Monitor | 43360 | If you create a view with more than 20 monitors from the Create and Configure Views page, you might encounter an exception when you select the view. Limit the number of monitors in a view to less than 20. | ||||||||||||||||||
System Monitor | 42481 | System Monitor supports running the Web Application Server and client in
the same locale. If the server and client are in different locales, text
will display in both languages. If it is not possible to run the server
in the same locale as the client, set the locale on the JVM to be the same
as the client locale by performing the following steps:
|
||||||||||||||||||
Server (Samples) | 43775 | There is an error in the \mqseries\RemoteServerSample.mqsc file. In the following expression, the highlighted text is incorrect: DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE + XMITQ(TO_AGENT) DESCR('Server to Agent') + CONNAME('172.16.15.96(1415)') The expression should read as follows (see highlighted text): DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE + XMITQ(XMITQ_TO_AGENT) DESCR('Server to Agent') + CONNAME('172.16.15.96(1415)') To work around this, modify the \mqseries\RemoteServerSample.mqsc file after installation. |
||||||||||||||||||
Tools - Activity Editor | 36145 | The color marking in the Java(TM) code editor within the Activity Editor cannot handle quotation marks within strings; however, this should not affect compilation. |
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 IBM WebSphere Business Integration Server Express InfoCenter.
The following documents can be found on that Web site:
Map Development Guide
Business Object Development Guide
Collaboration Development Guide
Data Handler Guide
Access Development Guide
WebSphere Business Integration Server Express Installation Guide for Windows
WebSphere Business Integration Server Express Installation Guide for Linux
WebSphere Business Integration Server Express Installation Guide for OS/400
Quick Start Guide
System Implementation Guide
System Administration Guide
Adapter for COM User Guide
Adapter for e-Mail User Guide
Adapter for Exchange User Guide
Adapter for iSeries User Guide
Adapter for JD Edwards OneWorld User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for JText User Guide
Adapter for Lotus Domino User Guide
Adapter for MetaSolv Applications User Guide
Adapter for mySAP.com (SAP R/3 V. 4.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for PeopleSoft User Guide
Adapter for Portal Infranet User Guide
Adapter for Siebel eBusiness Applications User Guide
Adapter for SWIFT User Guide
Adapter for Telcordia User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide
Adapter for XML User Guide
Collaborations for Customer Relationship Management
Collaborations for Procurement
Collaborations for Financials and Human Resources
Collaborations for Order Management