IBM Support

Release Notes for IBM Sterling B2B Integrator, Version 5.2.1

Release notes


The release notes contain information about enhancements and known issues in IBM® Sterling B2B Integrator, Version 5.2.1. Additionally, preinstallation and upgrading information are also provided.


IBM® Sterling B2B Integrator, Version 5.2.1 Release Notes

© Copyright IBM Corporation 2006, 2012. All Rights Reserved.


  1. About this release
  2. What's new
  3. Disk space requirements and System requirements
  4. Pre-installation recommendations
  5. Upgrading to Sterling B2B Integrator 5.2.1
  6. Known issues
  7. Contacting customer support
  8. Notices and trademarks


Sterling B2B Integrator, Version 5.2.1 is available. For detailed information about this release, including enhancements and known issues, see the following sections.


The enhancements and known issues described in this document apply to Sterling B2B Integrator Version 5, Release 2, Modification 1 (Version 5.2.1).

Sterling B2B Integrator, Version 5.2.1 contains the following enhancements:

Sterling Standards Library Enhancement to Support SWIFTNet 7.0
This release includes a new SWIFTNet7 Adapter to support SWIFTNet version 7.0. The SWIFTNet Server Adapter only supports the SWIFTNet version 6.1 features and does not support the new SWIFTNet 7.0 features. The new SWIFTNet7 Adapter, along with its corresponding services and business processes, must be configured separately. It does not work with the existing set of SWIFTNet 6.1 business processes.

Enhancement to Support SAP JCo 3.x
The SAP Suite Adapter for JCo 3.x is based on the SAP Java Connector (JCo) 3.x library. The SAP Suite adapter for JCo 3.x offers the following features:
  • Allows integration with an SAP system through the following interfaces:
    • Asynchronous ALE and file based IDoc and RFC
    • Synchronous sRFC and BAP
  • Supports status messages for translation success and failure for ALE and file based IDocs.
  • Is backward compatible with the existing SAP Suite Adapter for JCo 2.x at a business process level.
  • Allows running the little-a part of the SAP Suite Adapter for JCo 3.x in an external JVM using the general External JVM feature of Sterling Integrator.

Remember: SAP JCo 3.x is not compatible with earlier versions of the SAP JCo 2.x libraries. The SAP Suite adapter for JCo 2.x will not function correctly if configured with the JCo 3.x libraries. However, if both the SAP Suite adapter for JCo 2.x and the SAP Suite adapter for JCo 3.x are configured correctly with the appropriate JCo library versions, then they can exist on the same system and will function correctly.

The External JVM feature provided by SAP Suite 2.x is not supported for the SAP Suite adapter for JCo 3.x. Instead, you should run the little-a part of the SAP Suite Adapter for JCo 3.x in an external JVM (a general feature of the adapter container node). However, the External JVM feature continues to be supported for the SAP Suite adapter for JCo 2.x.

The SapTidCleaner Service is a supplementary service for the SAP Suite Adapter for JCo 3.x. The SapTidCleaner Service removes the old TID entries from the SAP TID table for all adapter instances. This service is automatically invoked by a scheduled business process, Schedule_SAPTidCleaner. You must ensure that both the predefined service instances, Schedule_SAPTidCleaner and SapTidCleanerInstance, are enabled.

Enhancement to Document Encryption
The supported values for the symmetric algorithm for encrypting documents now just include the default value of AES. This helps ensure that documents are being securely encrypted. Also, the property for setting this value (ENC_ALG) has been moved from the file to the file.

For information about disk space requirements and hardware and software compatibility, see the System Requirements document under the Getting Started topic in the Sterling B2B Integrator 5.2 Eclipse Info Center.

  • You must perform a complete backup of the Sterling B2B Integrator file system and database before applying any feature pack. It is not possible to uninstall a feature pack.
  • The E-invoicing features available with Sterling Integrator Release 5.0, Build 5007 or later are not yet available in the Sterling B2B Integrator, Release 5.2.1. These enhancements will be available in a future release. Therefore, if you are using Sterling e-Invoicing with Sterling Integrator Release 5.0, Build 5007 or later, do not upgrade to Sterling B2B Integrator, Release 5.2.1. If you do, the e-Invoicing archive database upgrade will fail. If you are using Sterling e-Invoicing with Sterling Integrator Release 5.0, Build 5007 or later, you must wait to upgrade your installation with Sterling B2B Integrator, Release 5.2.2, which will allow you to successfully upgrade your e-Invoicing archive database tables and you can continue to use the e-Invoicing enhancements introduced originally in Sterling Integrator Release 5.0, Build 5007.


Sterling Integrator customers who want to upgrade to Sterling B2B Integrator, Release 5.2.1 can use the migration method (import/export) or the traditional, in-place upgrade method.

You should be aware of the advantages and disadvantages of these different upgrade methods before deciding which method is best for your business:

In-place upgrade moves your transactional data and run-time assets to the new version.

Migration upgrade (import/export) moves only your run-time assets to the new installation. If you have never used the migration upgrade method and need assistance creating and executing a plan based on this methodology, contact your IBM Sales Account Representative or IBM Professional Services.

The following in-place upgrade guides are provided for this release:
  • UNIX/Linux Non-Cluster Environment Upgrade Guide
  • UNIX/Linux Cluster Environment Upgrade Guide
  • Windows Non-Cluster Environment Upgrade Guide
  • Windows Cluster Environment Upgrade Guide
  • iSeries Environment Upgrade Guide

Note: For Sterling B2B Integrator, Release 5.2.0, only the migration upgrade was available.

For information about known issues and workarounds in Sterling B2B Integrator, Version 5.2.1, see .

Contact Customer Support at 1-800-IBM-SERV, or go to the IBM Support Portal.

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

North Castle Drive

Armonk, NY 10504-1785


For license inquiries regarding double-byte character set (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.

1623-14, Shimotsuruma, Yamato-shi

Kanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:


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


555 Bailey Avenue

San Jose, CA 95141-1003


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.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

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.


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.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

© IBM 2012. Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2012.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.


IBM, the IBM logo, and® 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

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce.

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.

ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.

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.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

Linear Tape-Open, LTO, the LTO Logo, Ultrium and the Ultrium Logo are trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.

Connect Control Center®, Connect:Direct®, Connect:Enterprise®, Gentran®, Gentran®:Basic®, Gentran:Control®, Gentran:Director®, Gentran:Plus®, Gentran:Realtime®, Gentran:Server®, Gentran:Viewpoint®, Sterling Commerce™, Sterling Information Broker®, and Sterling Integrator® are trademarks or registered trademarks of Sterling Commerce™, Inc., an IBM Company.

Other company, product, and service names may be trademarks or service marks of others.

Document information

More support for: Sterling B2B Integrator

Software version: 5.2.1

Operating system(s): AIX, HP-UX, IBM i, Linux, Platform Independent, Solaris, Windows

Reference #: 7034262

Modified date: 14 November 2012

Translate this page: