Release notes for IBM Transformation Extender Pack for Supply Chain EDI, V9.0.2

Content

IBM Transformation Extender Pack for EDI, V.9.0.2 release notes

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

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

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

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

Where to find the software to download

To download the software for this version of the WebSphere Transformation Extender Pack for EDI, go to Passport Advantage® Online.


What's new in this release

Support is added for the following standards:

• X12 7030
• EDIFACT 15A, 15B, and 16A

A new example is added to the pack in support of the new EDIFACT VERMAS message. The examples\vermas directory contains the following files:

File	Description
vermas_d16a.txt vermas_d16a_2.txt	Files of EDIFACT VERMAS D16A (Verified Gross Mass document)
edifd16a_VERMAS.mtt	Type tree representing the VERMAS D16a message
Test_Validation_VERMAS.mms	A validation map that confirms the proper structure of the EDIFACT D16A VERMAS message

To use these files: The type tree for both the input card and the output card in the edifd16a_VERMAS map is edifd16a_VERMAS.mtt. The map will pass successfully using the valid VERMAS files provided. Additional VERMAS files can be tested for validity using the included map.

Documentation notes

See the online documentation for the latest documentation for this product. The installed information center and PDF documentation are deprecated.

For detailed information about WebSphere Transformation Extender product documentation, see the Documentation release notes.


Translated documentation

Documentation for this release is provided in English (United States) only.



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

Installation prerequisites

Before you install this version of the pack, you must install IBM Transformation Extender (ITX) V8.4.0.5, 8.4.1.4, or 9.0.0.1 or IBM Transformation Extender Advanced V9.0.0.4.

Deployment to other operating systems

See the individual component documentation for information on deploying to other operating systems.

Installing the pack

The pack components are installed to the following directory, depending on the selected standard(s):

Installation directories

The pack components are installed to the following directories:

• IBM Transformation Extender - itx_install_dir\packs\Supplychain_EDI_v9.0.2
• IBM Transformation Extender Advanced - itxa_install_dir\Supplychain_EDI_v9.0.2

Installing the pack on Windows systems

To install the IBM Transformation Extender Pack for Supply Chain EDI, perform the following procedures:

1. Obtain the image from Passport Advantage Online.
2. Run the .exe command for the application and accept the license agreement.
3. At the prompt, select either a "Complete" or a 'Selected' installation.
   
   The "Complete" installation installs the X12, EDIFACT, and TRADACOMS components to all installed versions of ITX (versions 8.4.0.5, 8.4.1.4 and 9.0.0.1), with no ability to choose individual core ITX versions or individual pack components.
   
   The "Selected" installation displays a screen for each of the available versions of ITX. Each of these screens allows you to choose which pack components you want to install.
4. If you are performing a "Selected" installation, choose the components for each of your core ITX versions. After each version selection, select Next.
   
   The "Start Copying Files"' screen displays all of the available versions of ITX, and also shows which components are selected for installation.
5. Click Next to initiate the installation.
   
   When the installation completes, you are prompted to view the readme file.

Modifying and uninstalling the pack components

If additional pack components are needed after the install completes, or if removal of select components is desired, you can modify your installation. You can also remove all components.

1. Begin the installation process again.
   
2. When prompted, choose to modify your installation, remove on or more selected components, or remove all components:

• To modify your current installation, select Modify.
  
  When selected, this choice displays the same dialog as the initial installation. Refer to the "Installing the pack" section.
• To remove an installed component for a specific core version of ITX, select Modify and deselect (uncheck the box for) the component name(s) and version(s) that you want to remove.
  
  The component is removed for the ITX core version that is selected

1.
• To remove all components from all versions of ITX, select Remove all components.
  
  Use this option only if you want to remove all components for all versions of the pack. You are prompted with a warning that all pack components for all versions will be removed.

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.

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

Possible M202 warning when building source maps

Building some of the source maps might trigger M202 warnings similar to the following:
M202    WARNING:
    Map: FormatContrl   Output: TestIndicator Element Good UNB Envelope
    Control EnvelopedContrl
   Parm 2 of EITHER doesn't match required type.
These warnings can be ignored.


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.

WebSphere Transformation Extender Trading Manager support

This version of IBM Transformation Extender Pack for EDI is supported on WebSphere Transformation Extender Trading Manager, V. 8.2.1.10.



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

For information on the resolved APAR for this release, see APAR PI61582.



=====================================================================
5. CONTACTING CUSTOMER SUPPORT
=====================================================================

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


=====================================================================
6. 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 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.
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
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, 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.

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.

Privacy Policy Considerations
IBM Software products, including software as a service solutions, ("Software Offerings") may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering’s use of cookies is set forth below.

This Software Offering does not use cookies or other technologies to collect personally identifiable information.

If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent.

For more information about the use of various technologies, including cookies, for these purposes, see the IBM Privacy Policy, the IBM Online Privacy Statement section entitled "Cookies, Web Beacons and Other Technologies," and the IBM Software Products and Software-as-a-Service Privacy Statement.

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.

• Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
• Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
• Microsoft and Windows 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.

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