IBM FileNet P8 Content Platform Engine 5.5.6.0-P8CPE-IF003 Interim Fix Readme
© Copyright IBM Corporation 2021.

Readme file for: IBM® FileNet® P8 Content Platform Engine
Update name: 5.5.6.0-P8CPE
Fix ID: 5.5.6.0-P8CPE-IF003
Publication date: 14 January 2022
Last modified date: 14 January 2022

Contents

About this interim fix

Download location

Prerequisites

New in this Interim Fix

Known problems, restrictions and solutions

Installation

Preparing the server for installation

Installing this Interim Fix

Server

Server Install

Configuring the server after installation

Client

Installing the client updates

Tools

Installing the tools Java updates

Installing the tools FileNet Deployment Manager updates

Installing the Process Designer and Process Engine Tools updates

Installing .Net API updates

Fix list (APARs)

Notices

Trademarks

Document change history

About this interim fix

This interim fix updates the Content Platform Engine, FileNet Deployment Manager, Process Designer, Content Engine Bulk Import (CEBI), and Content Platform Engine client files.

Important: If you are using this interim fix as a part of a new installation of the Content Platform Engine, install the interim fix files as directed here but stop before "Configuring the server after installation". Instead follow the instructions in the Knowledge Center topic "Installing and configuring Content Platform Engine" Installing Content Platform Engine to complete your new installation.

Important: If you are using this interim fix to upgrade from a release prior to 5.5.6, install the interim fix files as directed here but stop before "Configuring the server after installation". Instead continue with the upgrade process as described in the Knowledge Center topic "Upgrading and configuring Content Platform Engine" Upgrading Content Platform Engine.

Download location

Click the following link to access the files for this interim fix server update: Fix Central for Interim Fix 5.5.6.0-P8CPE-IF003. You need an IBM login and password to access this download location.

To verify that FileNet Content Manager files were not altered, see the signature verification technical note 6416109.

Prerequisites

This interim fix requires:

• 5.5.6.0-P8CPE

New in Interim Fix 5.5.6.0-P8CPE-IF003

The following changes are introduced in this 5.5.6.0-P8CPE-IF003 Interim Fix:

• IBM JRE 8.0.6.35 (October 2021)
• Oracle Outside In Technology (OIT) to v8.5.5 BP#6 p33394086 (October 2021)
• Update to Apache XMLBeans v3.1.0

New in Interim Fix 5.5.6.0-P8CPE-IF002

The following changes are introduced in this 5.5.6.0-P8CPE-IF002 Interim Fix:

• IBM JRE 8.0.6.26 (March 2021)
• Update to Apache commons-io v2.8.0
• Removal of Apache commons-math library
• Eclipse v4.6.3 p20210428 (April 2021)
• Apache PDFBox v2.0.24 (June 2021)
• Content Platform Engine (CPE) .NET API
• Enabling Windows System.Net tracing to troubleshoot Content Engine .NET API authentication or network failure. See technical note 6451793.
• CPE .NET API now directly selects the highest TLS version available without changing Windows registry settings. See technical note 6451683.
• Added CPE .NET API connection URL option for specifying the certificate used for mutual authentication. See technical note 6451795.

New in Interim Fix 5.5.6.0-P8CPE-IF001

The following new currency is added in this 5.5.6.0-P8CPE-IF001 Interim Fix:

• RHEL 8.x zLinux support
• SLES 15.x zLinux support

Please use the links in the previous section About this interim fix for more details on how to upgrade to either of these releases.

The following changes are introduced in this 5.5.6.0-P8CPE-IF001 Interim Fix:

• Update Oracle Outside In Technology (OIT) to v8.5.5 p32446523 March 2021
Add Oracle Outside In Technology (OIT) zLinux 64-bit library support
• IBM JRE 8.0.6.20 (December 2020)
• Updated FileNet Deployment Manager (FDM) to Eclipse v4.6.3 p20201215
• Update to Apache HttpClient v4.5.13

Known problems, restrictions and solutions

Following are some known problems and restrictions that are related to this interim fix:

• This interim fix does not have an uninstall option.
• You can safely install this interim fix even if you have virus protection software running in the background.
• The Content Search Server must be upgraded to 5.5.6.0-P8CSS-IF003 before the Content Platform Engine server is upgraded to 5.5.6.0-P8CPE-IF003
  Upgrade the Content Search Services (CSS) servers at the same time as upgrading the Content Platform Engine (CPE) servers or alternatively upgrade the CSS servers first.
  Do not upgrade the CPE servers before upgrading the CSS servers. This may result in the logging of errors about a CSS client and server version mismatch.
• In some Content Search Services (CSS) environments, the Content Platform Engine may have non-optimized Content Based Retrieval (CBR) indexing workload and indexing degradation. See technote 6151797 for information about how to apply a correction.
• For details about Java Certificate expirations, see technote Effect of Java certificate expirations on IBM FileNet Content Manager client applications.
• Content Search Services (CSS) unable to index and search Excel spreadsheets for date fields despite setting "export LANG" to non-US locale. For details on the future fix, see APAR PJ44426.

Installation

Tip When copying files from Windows to Linux, make sure the copy program used does not modify CR/LF

Installation of this interim fix consists of the following tasks:

• Preparing the server for installation
• Installing this interim fix
• Server
• Server Install
• Configuring the server after installation
• Client
• Installing the client updates
• Tools
• Installing the tools Java updates
• Installing the Deployment Manager tool updates
• Installing the Process Designer and Process Engine Tools updates
• Installing .Net API updates

Preparing the server for installation

In environments where there is more than one Content Platform Engine server running in the P8 domain, the Content Platform Engine nodes can be set up in either a managed or non-managed configuration.

When you deploy Content Platform Engine in a "managed" application server environment, this Content Platform Engine interim fix is installed and configured on the administration server. The Configuration Manager uses the administration tools of the application server to deploy the Content Platform Engine EAR file to the managed servers. This is known as a "managed" deployment.

When you deploy Content Platform Engine in a "non-managed" application server environment, install and configure this Content Platform Engine interim fix on any Content Platform Engine server in the environment. After configuring the Content Platform Engine EAR file on this first server, you will be directed to copy the EAR file to each of the other servers and deploy the EAR file on all of the servers.

Complete the following tasks to prepare the Content Platform Engine server for this interim fix.

1. Log on to the Content Platform Engine server as the user who is designated as the "cpe_install_user" user.
2. Download this interim fix and extract its contents to a temporary location. For information, see Download location.
3. Optionally stop the FileNetEngine and any client applications.
   • As updating to this interim fix from an existing 5.5.6.0-P8CPE deployment is a minor version update, if this is a managed deployment, it is not required for the Content Platform Engine to be stopped prior to deploying the interim fix.
   • If the deployment is in a "non-managed" application server environment, the recommendation is to first remove the FileNetEngine application from the application server instances and clear any application server caches. Removing the existing version ensures a clean deployment of the upgraded version of the Content Platform Engine EAR file. This includes the scenario where a single instance of WebSphere Application Server (standard) or WebLogic are running as an all-in-one deployment with their administration console and application server hosted by a single JVM instance.
     To remove and clear the FileNetEngine application, complete the tasks as documented in the FileNet Content Manager Knowledge Center:
     • Removing the deployed FileNetEngine application
     • Clearing the web application server cache

Installing this Interim Fix

Complete the following tasks to install this interim fix.

Important: The Content Platform Engine (CPE) EAR file naming convention is "Engine-xx.ear" where "xx" represents the Content Platform Engine application server type (ws, wl122).
For WebLogic customers, Engine-wl122.ear is for users of WebLogic 12.2 and later.

1. Navigate to the temporary directory where you extracted the contents of this interim fix.
2. Server Install

   Backup existing files as listed below.
   Then copy the updated versions of the files that were extracted from the fix (see prior step) into the same directory as the existing copy that you just backed up. (This action overwrites the existing copy.)

   UNIX

   installation_location/ContentEngine/lib/Engine-xx.ear
   installation_location/ContentEngine/lib/Jace.jar
   installation_location/ContentEngine/lib/pe.jar
   

   Windows

   installation_location\ContentEngine\lib\Engine-xx.ear
   installation_location\ContentEngine\lib\Jace.jar
   installation_location\ContentEngine\lib\pe.jar
   

3. Server Install delete

   Delete the below files and directories (if they are present)

   UNIX

   installation_location/ContentEngine/lib/httpClient-4.5.12.jar
   

   Windows

   installation_location\ContentEngine\lib\httpClient-4.5.12.jar
   

4. Configuration Manager cleanup
• To ensure the Configuration Manager (CM) will use the latest copied files, remove the contents of the Eclipse workspace that will be present if a previous version of configuration manager was run on the machine where the interim fix is being installed.

UNIX

user_home_directory/configmgr_workspace

Windows

user_home_directory\configmgr_workspace
• The directory configmgr_workspace might also appear with the version number of the Content Platform Engine release appended.
  

  UNIX

  user_home_directory/configmgr_workspace_5.5.6

  Windows

  user_home_directory\configmgr_workspace_5.5.6

Configuring the server after installation

Complete the tasks in this section to configure the server set-up information and to deploy Content Platform Engine. Following are an overview of the steps.

Important: If you are using this interim fix as a part of a new installation of the Content Platform Engine or upgrade from a pre-5.5.6 version of the Content Platform Engine, stop here. Return to the instructions in the Knowledge Center topic to complete the process for your new installation of a 5.5.6.0-P8CPE version or your upgrade from a pre-5.5.6 CPE version.

Gathering Content Platform Engine information

Before you can deploy Content Platform Engine, you must gather information that is needed for the application server configuration profile and for startup and deployment of the Content Platform Engine EAR file.

Use the Installation and Upgrade Planning Worksheet to help identify all the required information about your Content Platform Engine installation. Refer to the following link for more details:
See Knowledge Center Using the installation and upgrade worksheet.

Completing Configuration Manager tasks

Complete the tasks in this section to configure the server set-up information and to deploy Content Platform Engine.

Completing Configuration Manager update tasks interactively

Completing Configuration Manager tasks Command-line: Add and execute deployupdate

Completing Configuration Manager tasks interactively

Starting the Configuration Manager

1. Log on to the Content Platform Engine server as the "config_mgr_user" user.
2. Start Configuration Manager by completing the procedure that is appropriate for the operating system.

   UNIX

   Run the following command from the command line: ce_install_path/tools/configure/configmgr.

   Windows

   Select Start > All Programs > IBM FileNet P8 Platform > FileNet Configuration Manager or run the following command: ce_install_path\tools\configure\configmgr.exe.

(Windows only and non-managed deployments) Deploy Application

To uninstall, see Knowledge Center topic Removing Content Platform Engine and to deploy see Knowledge Center topic Deploying Content Platform Engine instances.

(Non-Windows managed deployments only) Deploy Update

To redeploy/update an existing 5.5.6.0-P8CPE FileNetEngine application, add and run the "Deploy Update" task.

Note: If you elected to "Remove the deployed FileNetEngine application" when preparing for the update, you will need to use "Deploy Application" instead of "Deploy Update".

Important: Do NOT select "Deploy Update" for new installs or upgrades from a version previous to 5.5.6.0-P8CPE.

See Knowledge Center topic Planning and preparing for FileNet P8 updates for deploy update WebSphere Application Edition Management (AEM) details.

1. Open the existing 5.5.6.0 Configuration Manager profile or create a new 5.5.6.0 Configuration Manager profile.
2. Choose Add New Task > Deploy Update task.
3. Provide the property values for your deployment. For details on the fields, hover your mouse over the "?" icon to view the property description.
4. Save your changes then select Run Task.

   Running the deploy task might take several minutes. The task status messages are displayed in the Console pane below the deploy application properties.

5. If the FileNetEngine application server was shutdown, or the application server does not restart it in a timely fashion, manually restart the FileNetEngine application after confirming the new files were distributed by the application server to all nodes or managed servers.
6. Open the Content Engine (CE) ping page (http://server:port/FileNet/Engine) and verify that the value in the Startup Message key for Content Platform Engine is the same as the Content Platform Engine build number from the version.txt file, which is located in the temporary directory where you extracted the contents of this interim fix.

Update of the FileNetEngine application is now complete. Continue with the next section, Installing the client updates.

Completing Configuration Manager Tasks Command-line

(Non-Windows managed deployments only) Add and execute deployupdate

Complete the following procedure to specify setup information and deploy an update to an existing Content Platform Engine

Note: If you elected to "Remove the deployed FileNetEngine application" when preparing for the update, you will need to use "Deploy Application" instead of "Deploy Update". Which for the command line utility means specifying "-task deployapplication" instead of "-task deployupdate" in the steps below.

Important: Do NOT use deployupdate for new installs or for upgrades from a version previous to 5.5.6.0-P8CPE.

(Windows only and non-managed deployments) Deploy Application

To uninstall, see Knowledge Center topic Removing Content Platform Engine and to deploy see Knowledge Center topic Deploying Content Platform Engine instances.

(Non-Windows managed deployments only) Deploy Update

To redeploy/update an existing 5.5.6.0-P8CPE FileNetEngine application, add and run the "Deploy Update" task.

Important: Do NOT select "Deploy Update" for new installs or upgrades from a version previous to 5.5.6.0-P8CPE.

See Knowledge Center topic Planning and preparing for FileNet P8 updates for deploy update WebSphere Application Edition Management (AEM) details.

1. Log on to the Content Platform Engine server as the user who is designated as the config_mgr_user user
2. Change the current directory to ce_install_path/tools/configure, where ce_install_path is the path where you installed Content Platform Engine. For example, ce_install_path might be /opt/FileNet/ContentEngine
3. Generate the deployupdate.xml task file for an existing CPE 5.5.6 configuration manager profile or as part of a new CPE 5.5.6 configuration manager profile using this command

configmgr_cl generateconfig -appserver WebSphere/WebLogic -deploy standard/cluster/netdeploy -task deployupdate -profile myprofile

4. Supply the needed values in the deployupdate.xml task file. If this is a new configuration manager profile, also complete the applicationserver.xml file.
5. Use the command-line to execute the deployupdate task. Enter the command on one line without line breaks

   configmgr_cl execute -task deployupdate -taskfile deployupdate.xml -profile myprofile

6. If the application server was shutdown, or the application server does not restart in a timely fashion, manually restart the FileNetEngine application after confirming the new files were distributed by the application server to all nodes or managed servers.
7. Open the Content Engine (CE) ping page (http://server:port/FileNet/Engine) and verify that the value in the Startup Message key for Content Platform Engine is the same as the Content Platform Engine build number from the version.txt file, which is located in the temporary directory where you extracted the contents of this interim fix.

Completing Configuration Manager tasks

In a non-managed application server environment, repeat the EAR deployment for all servers.

Client Installation

Installing the client updates

The following Content Platform Engine client API files are included in this interim fix. These files must be installed as needed on the Content Platform Engine clients and customized application installation locations.

• Jace.jar
• pe.jar

Complete the following procedure to update Content Platform Engine with the updated JAR files.

1. Backup existing files as listed below.
   Then copy the updated versions of the files that were extracted from the fix (see prior step) into the same directory as the existing copy that you just backed up. (This action overwrites the existing copy.).
   The below client files are located in the interim fix cpetools\peclient directory.

   UNIX
   installation_location/ContentEngine/lib/Jace.jar (copy from zip root directory)
   installation_location/ContentEngine/lib/pe.jar (copy from zip root directory)
   

   Windows
   installation_location\ContentEngine\lib\Jace.jar (copy from zip root directory)
   installation_location\ContentEngine\lib\pe.jar (copy from zip root directory)
   

2. On some systems (for example, systems using custom applications), the Jace.jar, pe.jar files might also exist in other directories or be otherwise bundled with the custom application (for example, with the J2EE WAR or EAR file). If you have any custom applications, search for the files and replace other instances with the new version supplied in this interim fix.

Note: You use the Content Platform Engine client installer to install the new jars that will come from the updated Content Platform Engine server via the download service. It's important that the Content Platform Engine server be already updated by this interim fix and be running prior to running the client installer. By following the client installation instructions below, the updated files will be installed on all clients that are supported by the client installer. The files are also provided separately for clients not supported by the client installer.

You can install the client update either interactively or silently. This section consists of the following steps:

• Installing the Content Platform Engine client update on Content Platform Engine-related Java EE applications interactively
• Installing the Content Platform Engine client updates silently

Installing the Content Platform Engine client update on Content Platform Engine-related Java EE applications interactively

After you have updated the Content Platform Engine servers complete the following tasks for all of the Content Platform Engine-related Java EE applications, and any custom Content Platform Engine-related Java EE applications.

1. Back up the existing Content Platform Engine client directories.
2. Download the appropriate client update file from the latest generally available release and extract its contents to a temporary location.

The following table lists the names of the compressed fix client update files by operating system type:

Name of compressed Content Platform Engine client update file by operating system type

Operating system type	Name of compressed Content Platform Engine client update file
AIX	5.5.6.0-P8CPE-CLIENT-AIX.tar.gz
Linux	5.5.6.0-P8CPE-CLIENT-LINUX.tar.gz
Windows	5.5.6.0-P8CPE-CLIENT-WIN.zip
zLinux	5.5.6.0-P8CPE-CLIENT-ZLINUX.tar.gz

3. Complete the following instructions as appropriate for the client installation:

Tip If the client installation program is unable to detect the existing installation of the FileNet P8 application you are updating, you must manually ensure that the update occurs. Check the item in the "Select FileNet P8 Applications" dialog box and complete the client installation by entering (or browsing to) the location where that application is installed.

• Other applications:

  If you have a custom application which uses the Content Platform Engine client files then follow the below instructions:

  1. Log on as a user with permissions to install software.
  2. Stop all custom applications that use the Content Platform Engine client.
  3. Run the Content Platform Engine client updater that is appropriate for your operating system.
  4. Click the "Other Applications" option.
  5. Choose the installation directory. Based on the location you specify, the installation program creates a sub-directory called "lib" and populates it with the jar files for P8 applications.
  6. Replace the existing jar files in your directory structure with these new client file versions.
4. Review the Content Platform Engine client log files for installation errors.

   Installation errors are recorded in the ceclient_install_log_5.5.6.0.txt file, which is in the ceclient_install_path directory.

5. Restart the applications that use the Content Platform Engine client.

The installation and configuration of the client upgrade for this interim fix is complete.

Installing the Content Platform Engine client updates silently

Complete the following procedure to install the Content Platform Engine client updates silently.

1. Log on as a user with permissions to install software.
2. Stop all custom applications that use the Content Platform Engine client.
3. Back up the existing Content Platform Engine client directories.
4. Download the appropriate client update file from the latest generally available fix pack and extract its contents to a temporary location.

The following table lists the names of the compressed fix client update files by operating system type:

Name of compressed Content Platform Engine client update file by operating system type

Operating system type	Name of compressed Content Platform Engine client update file
AIX	5.5.6.0-P8CPE-CLIENT-AIX.tar.gz
Linux	5.5.6.0-P8CPE-CLIENT-LINUX.tar.gz
Windows	5.5.6.0-P8CPE-CLIENT-WIN.zip
zLinux	5.5.6.0-P8CPE-CLIENT-ZLINUX.tar.gz

5. Open the ceclient_silent_install.txt file and edit the file as appropriate for your configuration, including the following fields and other fields that apply to your system.
   • LICENSE_ACCEPTED - Read the license and select "true" to accept the license agreement and to complete the installation
   • UPDATE_application - Select which client applications to update
   • application_FOLDER - Set the directory path of each application
   • APP_SERVER_servertype - Select which server type to update

6. Install this fix by running the following command that is appropriate for your operating system.

   Silent installation start commands by operating system for the Content Platform Engine client update

   Operating system	Command to install the Content Platform Engine server update
   AIX	5.5.6.0-P8CPE-CLIENT-AIX.BIN -i silent -f ceclient_silent_install.txt
   Linux	5.5.6.0-P8CPE-CLIENT-LINUX.BIN -i silent -f ceclient_silent_install.txt
   Windows	5.5.6.0-P8CPE-CLIENT-WIN.EXE -i silent -f ceclient_silent_install.txt TIP You can monitor completion of this interim fix server update installation on Windows-based systems by using the Windows Task Manager.
   zLinux	5.5.6.0-P8CPE-CLIENT-ZLINUX.BIN -i silent -f ceclient_silent_install.txt

   
   
7. Review the Content Platform Engine client log files for installation errors.

   Installation errors are recorded in the ceclient_install_log_5.5.6.0.txt file, which is in the ceclient_install_path directory.

8. Restart the custom applications that use the Content Platform Engine client.

The installation and configuration of the client upgrade for this interim fix is complete.

Content Platform Engine (CPE) Tools Installation

Installing the server tools Java updates

This interim fix updates the server tools private Java files used by Configuration Manager User Interface (CMUI), the Content Engine (CE) and Process Engine (PE) tools, and the un-installer.

Complete the following procedure to update server tools IBM Java to v8.0.6.35 October 2021.

If the JRE version is older (lower number) than IBM Java JRE 8.0 SR6 FP35, then continue on to the next step. If Java 8.0 SR6 FP35 is already installed, then no further action is required, since 8.0 SR6 FP35 should only be installed once.

1. Exit all FileNet server tools .
2. Rename current Java cpe_installation_location/FileNet/ContentEngine/_cejvm directory to Javaxxx as a backup, where xxx is the old Java version.
3. Create a new, empty cpe_installation_location/FileNet/ContentEngine/_cejvm Java directory.
4. Extract the contents of ibm-java-jre-platform.zip (.tgz, .tar.gz) into a temporary directory
5. Move the contents of the temporary/jre/lib/ directory to the cpe_installation_location/FileNet/ContentEngine/_cejvm/lib/ directory
6. Move the contents of the temporary/jre/bin/ directory to the cpe_installation_location/FileNet/ContentEngine/_cejvm/bin/ directory
7. Move the contents of the temporary/doc/ directory to the cpe_installation_location/FileNet/ContentEngine/_cejvm/doc/ directory
8. Move the temporary/copyright, license_en.txt, notices.txt, readme.txt files to the cpe_installation_location/FileNet/ContentEngine/_cejvm/ directory
9. Verify that the directory structure of the old _cejvm directory is the same one as the newly created one.
10. Verify that the new Java Runtime Environment is Java 8.0 SR6 FP35 :

    $ java -version

Installing the tools FileNet Deployment Manager updates

For customers that have installed the FileNet Deployment Manager (FDM) tool, this interim fix updates the FileNet Deployment Manager files.

Complete the following procedure to update Deployment Manager.

1. After downloading the fix and extracting its contents to a temporary location (in step 2 under Preparing the server for installation ), all FileNet Deployment Manager files should be in the temporary deploy location.

   Linux
   Unzip fdm-linux.zip

   Windows
   Unzip fdm-windows.zip

2. Backup existing files as listed below.
   Then copy the updated versions of the files that were extracted from the fix (see prior step) into the same directory as the existing copy that you just backed up. (This action overwrites the existing copy.)

   Linux
   Copy the fdm-linux.zip extracted files in the deploy directory to installation_location/deploy/

   Windows
   Copy the fdm-linux.zip extracted files in the deploy directory to installation_location\deploy\

3. If you have previously executed Deployment Manager from this installation directory, the old files have been cached. To remove the old cache from your system, go to:

   Linux

   FDM_installation_directory/deploy

   Run the following command: DeploymentManager -clean

   Windows

   FDM_installation_directory\deploy

   Run the following command: DeploymentManager.exe -clean

Installing the Process Designer and Process Engine Tools updates

Note: With 5.5.6.0-P8CPE (GA) and higher versions, the Process Engine (PE) Process Designer (PD) tools are installed separately from Passport Advantage.

For customers that have installed the Process Engine (PE) Process Designer (PD) Tools, this interim fix updates the Process Designer and Process Engine Tools Jace.jar file.

Complete the following procedure to update Process Designer and Process Engine Tools.

1. After downloading the fix and extracting its contents to a temporary location (in step 2 under Preparing the server for installation ), the updated Jace.jar file should be in the temporary location.
2. Backup existing files as listed below.
   Then copy the updated versions of the files that were extracted from the fix (see prior step) into the same directory as the existing copy that you just backed up. (This action overwrites the existing copy.)

   Linux
   installation_location/ContentEngine/lib/Jace.jar
   

   Windows
   installation_location\ContentEngine\lib\Jace.jar
   

Installing .Net API updates

This interim fix updates the .Net API FileNet.Api.dll and FileNetApiSetup.msi files.

Complete the following procedure to update .Net API client installed on a Windows machine.

1. Log on as a user with permissions to install software.
2. After downloading the fix and extracting its contents to a temporary location (in step 2 under Preparing the server for installation ), the updated FileNetApiSetup.msi file should be in the temporary location.
3. Launch FileNetApiSetup.msi and complete the IBM FileNet Content Engine .NET API Setup Wizard.

Fix list (APARs)

The following table lists the product fixes for this interim fix.

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
J74/G4
555 Bailey Avenue
San Jose, CA 95141
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademarks

IBM, the IBM logo and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Other product and service names might be trademarks of IBM or other companies.

Document change history