Release notes for WebSphere Transformation Extender EDI Packs V2.8

Content

IBM WebSphere Transformation Extender Pack for EDI Packs
version 2.8 release notes

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

=====================================================================
CONTENTS
=====================================================================

1. About this release
2. Installation and configuration information
3. Known limitations, problems and workarounds
4. New and changed behavior
5. Resolved Authorized Program Analysis Reports (APARs)
6. Contacting customer support
7. Notices and trademarks

=====================================================================
1. ABOUT THIS RELEASE
=====================================================================

This release is a full version of the product.

Where to find the software to download

To download the software for this release of the product, go to Passport Advantage Online.

After you install the software for this release, go to WebSphere Transformation Extender Support downloads to download and install any Interim Fix releases. For details about the Interim Fix, go to the IBM WebSphere Transformation Extender Support Web site.

What's new in this release

The following are new in WebSphere Transformation Extender Pack for EDI version 2.8:

• WebSphere Transformation Extender Pack for X12 - Support has been added for the latest X12 Standard: ansi6030.mtt
• WebSphere Transformation Extender Pack for EDIFACT - Support has been added for the latest EDIFACT Standards:
• edifd10a.mtt
• edifd10b.mtt
• Compliance check:
• New option sends output to cards, instead of using the file, queue, or wire adapters.
• New option to NOT create the text error log for rejected data.
• Sterling B2B Integrator EDI services - Examples for using WebSphere Transformation Extender maps with Sterling B2B Integrator have been added. The examples require version 8.4 of the base WebSphere Transformation Extender product. X12 de-envelope and envelope examples, and EDIFACT de-envelope and envelope examples are provided. Instructions for running these examples are included in the WebSphere Transformation Extender Pack for EDI documentation, in the PDF and in the information center.

Documentation notes

Documentation for this product is provided in Portable Document Format (PDF) and in an IBM Eclipse help system called an information center. Instructions for accessing both the PDF documentation and the information center are provided below. For more information about WebSphere Transformation Extender product documentation, see the Documentation release notes.

PDF

PDF documentation installs with the product. After the installation is complete, you can access the documentation from the Windows Start menu.

Information center

Documentation for this product is also available in the WebSphere Transformation Extender information center which installs with the product and is accessed through the WebSphere Transformation Extender Design Studio Help menu and from the Windows Start menu. An on-line version of the information center is also available.


Translated documentation

Based upon country requests, documents delivered in this product have been translated from the original English (United States) version into various native languages. The documentation in both PDF and Eclipse help formats is displayed, depending upon the country or regional/language settings of your computer at the time of product installation.

Both PDF and Eclipse help documentation is provided in this release in the following languages:

Pack for EDI - PDF and Eclipse Help documentation	Pack for EDIFACT - PDF and Eclipse Help documentation	Pack for X12 - PDF and Eclipse Help documentation
- German	- German	- German
- French	- French	- French
- Brazilian Portuguese	- Brazilian Portuguese	- Brazilian Portuguese
- Simplified Chinese		- Simplified Chinese

WebSphere Transformation products display in English (United States) if the IBM representative of a country did not choose to translate them.

Inquiries about translating documents into specific languages should be directed to an IBM representative of the respective country.


=====================================================================
2. INSTALLATION AND CONFIGURATION INFORMATION
====================================================================

Installation prerequisites

The Packs for EDI Version 2.8 are compatible with 8.2, 8.3 and 8.4 versions of the base WebSphere Transformation Extender product. Before installing an EDI Pack, make certain that the required core version is installed. The EDI packs require one of the following:

• 8.4.0.0 - and later
• 8.3.0.4 - and later
• 8.2.0.5 - and later

Installing the pack

Follow these steps to install the pack on Windows systems:

1. Obtain the product media, or image, from the Support Downloads page.
2. Run the setup.exe command. If you are installing the pack from the ESD site, run the part_number.exe command.
3. Follow the instructions in the installation program.

Uninstalling the pack

Follow these steps to uninstall the pack from Windows systems:

1. Click Control Panel > Add/Remove Programs.
2. Select the pack that you want to remove.
3. Click Change/Remove and follow the prompts.

NOTE: The Repair or Remove options are no longer available in the installation program. You must uninstall the packs using the procedure detailed above.



=====================================================================
3. KNOWN LIMITATIONS, PROBLEMS, AND WORKAROUNDS
=====================================================================

EDIFACT version 1 - 3 using syntax level B delimiters

EDIFACT versions prior to version 4 used different non-printable default delimiters for syntax level B (Syntax Id = UNOB), or higher. The EDIFACT type trees do not support these alternate delimiters. If you need to process data that uses these, create modified versions of the EDIFACT type trees that use these alternate delimiters, instead of the default delimiters used by version 4 and by syntax level A in the older standards.

To create modified type trees, follow these instructions:

1. Copy the type tree from the pack to create a separate tree to be used for syntax UNOB interchanges. For example, copy edifd08b.mtt to edifd08b-unob.mtt.
2. Edit the new type tree, to update the following categories. For each change, propagate the change to the item's subtree:
   
   Composite Control EDIFACT EDI
   - Change: Group Subclass ->Format->Component Syntax->Delimiter->Default to <US>
   
   Envelope Control EDIFACT EDI
   - Change: Group Subclass->Format->Component Syntax->Delimiter->Default to <GS>
   - Change: Type Syntax ->Terminator->Default to <FS>
   
   Composite Vxxxx EDIFACT EDI (NOTE: this category must be updated to be Format Explicit, to match its subtypes.)
   - Change: Group Subclass->Format->Component Syntax->Delimiter->Default to <US>
   
   Segment Vxxxx EDIFACT EDI
   - Change: Group Subclass->Format->Component Syntax->Delimiter->Default to <GS>
   - Change: Type Syntax->Terminator->Default to <FS>
   
3. Analyze and save the new type tree, and use the updated tree in your map, or maps.

Type trees warnings

The following type trees have warnings when analyzed:

• ccx12.mtt (Pack for X12)
• ccedf.mtt (Pack for EDIFACT)

Pack for EDIFACT support for batch messages

The Pack for EDIFACT supports batch messages, but it does not support interactive messages.

Support for Trading Manager

This version of WebSphere Transformation Extender Pack for EDI supports WebSphere Transformation Extender Trading Manager 8.2.1.6.


=====================================================================
4. NEW AND CHANGED BEHAVIOR
=====================================================================

Record breaks between segments on output

In this version of the Pack for EDIFACT, the type trees are now updated so that only the apostrophe is used to terminate the segments, and release characters are inserted before any apostrophes that appear in the data. However, the output of EDIFACT segments are no longer separated by a carriage-return/line feed. If the application(s) that are receiving the EDIFACT output require segments to be separated by carriage-return/line feed characters, you can update the type trees so they have the same behavior as in previous product versions. As before, this might generate invalid output if the element values contain the apostrophe character.


=====================================================================
5. RESOLVED AUTHORIZED PROGRAM ANALYSIS REPORTS (APARs)
=====================================================================

For a list of the APARs that are resolved in this version of the product, see the WebSphere Transformation Extender Pack for EDI version 2.8 Fix List.


=====================================================================
6. CONTACTING CUSTOMER SUPPORT
=====================================================================

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


=====================================================================
7. NOTICES AND TRADEMARKS
=====================================================================

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
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:

IBM World Trade Asia Corporation Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, 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
577 Airport Blvd., Suite 800
Burlingame, CA 94010
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, a nd 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.

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

Programming interface information
Programming interface information, if provided, is intended to help you create application software using this program.

General-use programming interfaces allow you to write application software that obtain the services of this program's tools.

However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.

Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.

Trademarks and service marks
IBM, the IBM logo and ibm.com are 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.

• 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.
• 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.
• Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
• Oracle-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.

This product includes software developed by the Eclipse Project
(http://www.eclipse.org/)