webMethods ebXML Module 6.0.1 March 2003 Copyright (C) 1996-2003, webMethods, Inc. All Rights Reserved. _______________________________________________________________ Welcome to the webMethods ebXML Module 6.0.1. This file provides important information for using the webMethods ebXML Module 6.0.1. The webMethods ebXML Module is dependent on the webMethods Trading Networks, Integration Server, and Developer components of the webMethods Integration Platform. Please refer to the Readme and Release Notes documents in the directory in which you installed these components in addition to this readme. For information about webMethods Integration Platform 6.0.1 enhancements, see the webMethods Integration Platform 6.0.1 Release Notes. For information about the status of previous webMethods releases, see the General Support Statement. You can download these documents from the webMethods Advantage Web site. The webMethods Integration Platform Installation Guide contains important information you must read before you install webMethods Integration Platform 6.0.1. The guide also contains instructions you must follow to perform and complete the installation. The webMethods Integration Platform Upgrade Guide contains important information you must read before you upgrade webMethods Integration Platform 6.0.1. The guide also contains instructions you must follow to perform and complete the upgrade. Contents: 1.0 Getting Started 2.0 Documentation 2.1 Documentation Corrections and Additions 3.0 Known Problems and Limitations 4.0 Usage Notes 5.0 Globalization 6.0 Deprecated Components 7.0 Fixes and Enhancements 7.1 Fixes in ebXML Module 6.0.1 7.2 Added Services in ebXML Module 6.0.1 7.3 Removed Services in ebXML Module 6.0.1 7.4 Changes in ebXML Module 6.0.1 8.0 Copyright Information 8.1 webMethods 8.2 Other Products 9.0 Contacting Us 1.0 Getting Started webMethods ebXML Module Version 6.0.1 is an implementation of the ebXML Messaging Specification Version 1.0 and 2.0. The Module includes a full complement of services developers can use to implement this specification including: - Sending and receiving content packaged in an ebXML envelope using HTTP and SMTP protocols - Support for SOAP extensions as specified - Support for ebXML Message Handling Services (MSH) - Support for Reliable Messaging, Error Handling - Support for XML Signature and SMIME v2.0 For more information about ebXML specifications, please visit the official ebXML web site at http://www.ebxml.org. The webMethods ebXML Module User's Guide Version 6.0.1 describes the available services and their usage in more detail. The webMethods ebXML Module Sample Guide Version 6.0.1 describes a rich set of samples in greater detail. These two documents describe most of what you will need to implement ebXML messages with another trading partner. 2.0 Documentation Documentation for the webMethods ebXML Module 6.0.1 is located in the \packages\WmebXML and \packages\WmebXMLSample directories where you installed the Integration Server. The following manuals are provided as PDF files: - webMethods ebXML Module Sample Guide Version 6.0.1 - webMethods ebXML Module User's Guide Version 6.0.1 To view the documentation supplied with this version of webMethods ebXML Module Version 6.0.1, you must have Adobe Acrobat Reader 4.0 or later. You can download and install Acrobat Reader 4.0 from: http://www.adobe.com/support/downloads/main.html 2.1 Documentation Corrections and Additions None. 3.0 Known Problems and Limitations This product has the following known limitations at release time: - The Manifest element does not support XLINK process, so Manifest validation is not done. - This release does not support JVIEW. - When using IBM JVM 1.2 or later, you must remove the following jars to support XML Signature: [server]/jvm/lib/ext/xerces.jar [server]/jvm/lib/ext/xml4j.jar - If you plan to use XML Signature related features, you must purchase the XML Signature library from IAIK (IXSIL version 1.1), and replace WmebXML/code/jars/static/entxml.jar with this library. An evaluation copy of IAIK XML Signature library can be downloaded from http://jcewww.iaik.at/products/ixsil/index.php. webMethods will provide you with a similar library in the near future. If you do not plan to use XML Signature related features, you must set the wm.ebxml.signature property in the WmebXML/config/config.cnf configuration file as follows: wm.ebxml.signature=false - No interoperability testing has been done with any third party software. 4.0 Usage Notes If you plan to process large documents (larger than 5MB), refer to the "Trading Networks Large Doc Handling Guide Version 6.0.1". Additionally, when message size is large than 8MB, the ebXML Module will process only one message at a time to prevent out-of-memory errors. You can adjust the threshold size by setting the "wm.ebxml.sizeLimit" property in the WmebXML/config/config.cnf configuration file. 5.0 Globalization The webMethods ebXML Module Version 6.0.1 has not been tested for conformance with the internationalization standards of webMethods. This internal certification is planned for a future release. Using this version of the ebXML Module with non-standard character encodings (discussed below) and operation in locales other than U.S. English should be reliable because the standard ebXML headers do not require significant amounts of non-ASCII data. However, care should taken when deploying this product in non-English locales. - The components on which the ebXML module is dependent (webMethods for Trading Networks, webMethods Integration Server, and webMethods Developer) have been certified and tested for international support. Users should refer to the Globalization section of those products' readme.txt files for information about the limitations of those products before using the ebXML module in an international environment. - The default character encoding for ebXML envelopes, as defined by the emXML and XML 1.0 standards, is Unicode UTF-8. Although the underlying webMethods Integration Platform components that process the envelope support XML character encoding declarations correctly, this has not been tested in conjunction with the emXML Module. Attempts to process ebXML envelopes that use other character encodings may not work correctly. As a result, emXML envelopes in character encodings other than UTF-8 are not supported. - Each ebXML payload is handled as separate multi-part MIME content and is not processed directly by the ebXML Module. Instead it is passed as a byte stream to or from your service or application along with the MIME headers associated with it. Support for character encodings rests, therefore, entirely with your process model, application or Integration Server service. The MIME Content-Type will determine how each payload block should be processed. When working with textual data, setting the character encoding (charset) is an important way to ensure that the content is properly processed by the receiver. Please refer to the Integration Server and Developer user's guides and readme files for more information about working with character encodings in the webMethods Integration Platform. 6.0 Deprecated Components None. 7.0 Fixes and Enhancements 7.1 Fixes in ebXML Module 6.0.1 None. 7.2 Added and Changed Services in ebXML Module 6.0.1 Many new services have been added to webMethods ebXML Module 6.0.1 and many existing services have been modified to support new features. Almost all existing services remain backward compatible. Please refer to the webMethods ebXML Built-In Services Reference Guide for information on the ebXML services. 7.3 Removed Services in ebXML Module 6.0.1 None. 7.4 Changes in ebXML Module 6.0.1 Two major enhancements have been made in ebXML Module 6.0.1: - Full support for ebMS 2.0 - Introduction of Trading Partner Profile (TPA) 8.0 Copyright Information 8.1 webMethods webMethods Administrator, webMethods Broker, webMethods Developer, webMethods Installer, webMethods Integration Server, webMethods Mainframe, webMethods Manager, webMethods Modeler, webMethods Monitor, webMethods Trading Networks, webMethods Workflow, and the webMethods logo are trademarks of webMethods, Inc. "webMethods" is a registered trademark of webMethods, Inc. All other marks are the property of their respective owners. Copyright (c) 2003 by webMethods, Inc. All rights reserved, including the right of reproduction in whole or in part in any form. 8.2 Other Products Portions of this software contain encryption software from RSA Data Security, Inc. Portions of this software are copyrighted by DataDirect Technologies, 1991-2002. Portions of this software are based upon third party copyrighted materials from Informix. Portions of this software are copyrighted by JClass Chart Copyright (c) 2002 by Sitraka Inc. 260 King Street E, Toronto, Ontario, M5A 4L5 Canada. All rights reserved. Licensed material - Property of Entrust Technologies, LLC. (c) 2001 Entrust Technologies (Switzerland) LLC. All rights reserved. Entrust is a trademark of Entrust Technologies Inc. in certain countries. Entrust is a registered trademark of Entrust Technologies Inc. in the United States and certain other countries. In Canada, Entrust is a registered trademark of Entrust Technologies Limited. All Entrust product names are trademarks of Entrust Technologies. All other company and product names are trademarks of their respective owners. This information is subject to change as Entrust Technologies reserves the right to, without notice, make changes to its products as progress in engineering or manufacturing methods or circumstances may warrant. Cryptographic products are subject to export and import restrictions. You are required to obtain the appropriate government licenses prior to shipping this product. All other product and company names may be trademarks or registered trademarks of their respective owners. Published in Switzerland 9.0 Contacting Us You can reach webMethods Technical Services for support via: Advantage: http://advantage.webMethods.com E-mail: support@webMethods.com US Phone: 1-888-222-8215 Europe/EMEA Phone: +800-963-84-637 or +31-356462770 Asia/Pacific Phone: +612-8913-1198 or +656-389-3222