Release notes for IBM Transformation Extender Pack for Financial Payments V9.0.1

Content

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

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

1. About this release
   Where to find the software to download
   Documentation notes
2. Installation and configuration
3. Known issues and workarounds
4. New features, updates, and changed behavior
5. Resolved Authorized Program Analysis Reports (APARs)
6. Contacting customer support
7. Notices and trademarks

=====================================================================
1. ABOUT THIS RELEASE
=====================================================================
This release of the ITX Pack for Financial Payments includes the resources for the SWIFT, SEPA, and NACHA standards.

Where to find the software to download

To download this version of the ITX Pack for Financial Payments, go to Passport Advantage Online.

Documentation notes

• Use these release notes in conjunction with the online documentation that is provided for the ITX Pack for Financial Payments.
• Based upon country requests, the online product documentation has been translated from the original English (United States) version into various languages.
• See the English documentation for the latest information.
• Inquiries about translating documents into specific languages should be directed to an IBM representative of the respective country.

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

Installation prerequisites

Before you install the pack, you must install IBM Transformation Extender (ITX) V8.4.0.5, 8.4.1.4, or 9.0.0.1.

IMPORTANT: If you participated in the Early Release Program, you must uninstall the Early Release version of the pack before installing this supported release version. Failure to uninstall the Early Release version of the pack results in duplicate menu entries under Control Panel > Programs > Programs and Features, and can cause unexpected behavior when trying to uninstall the subsequent versions of the pack components.

Removing the Early Release pack

Remove the Early Release version of this pack in either of two ways:

• Run the Early Release install program and check Select this option to remove the installation, or
• from the Windows Control Panel, select Programs > Programs and Features. Select the pack and click Uninstall.

Deployment to other operating systems

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

Installation directories

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

• itx_install_dir\packs\financial_payments_v.9.0.1\nacha
• itx_install_dir\packs\financial_payments_v.9.0.1\sepa
• itx_install_dir\packs\financial_payments_v.9.0.1\swift

Installing the pack on Windows systems

To install the IBM Transformation Extender Pack for Financial Payments, 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 NACHA, SEPA, and SWIFT components to all installed versions of ITX (versions 8.4, 8.4.1 and 9.0.0), 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
• 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.

=====================================================================
3. KNOWN ISSUES AND WORKAROUNDS
=====================================================================

Building some of the source maps might trigger M202 warnings similar to the following:

M202    WARNING:
    Map: sepvalid   Output: FileType [4]:outputcard
    Parm 1 of EITHER doesn't match required type.

These warnings can be ignored.

Documentation known issues

The topic "MT-MX translation maps example" is not part of the MT Launcher Validation Framework and should appear after the topic for that feature.

Documentation known issues for translated document versions only

Consult the English version of the documentation for corrected versions of these topics:

• "How to specify a jvalnnn.prop file location." In that topic, the filename jvalnnnprop should be jvalnnn.prop and the correct pathname is the following: 
  [JVM Options]option1=-DDTX_SWIFT_CONFIG_DIR=C:/IBM/IBM Transformation Extender n.n.n/packs/financial_payments_v9.0.1/swift/mt/jvc/maps
  The four options are now also numbered to show that they are sequential and equivalent.
• In the SWIFT topic "How to set up the IBM Transformation Extender project," the example directory path in step 5 should include a swift subdirectory. The correct directory path is C:\install_dir\packs\financial_payments_vn.n.n\swift.

=====================================================================
4. NEW FEATURES, UPDATES, AND CHANGED BEHAVIOR
=====================================================================

NACHA

The NACHA component provides support for clients that need to validate, create, or transform ACH messages. This release includes updates to the ACH type trees, and maps that are necessary to support recent amendments to the current 2016 NACHA Operating Rules.

This version of the NACHA component includes these new and updated ITX-based artifacts:

• Updates to ACH type trees to support the amendments to the 2016 NACHA Operating Rules
• New ACH validation example maps
• New example to convert ACH messages to ISO 20022 XML messages
• Updates to the legacy examples to use the latest version of the 2016 ACH type tree

SEPA

The SEPA component of the pack includes the SEPA validation framework map updates for the following updates:

• SDD Core Rulebook version 9.1 and associated implementation guidelines that take effect on 20 November 2016
• SDD B2B Rulebook version 7.1 and associated implementation guidelines that take effect on 20 November 2016
• SCT Rulebook version 8.1 remains in effect until November 2017. There are no updates to the Credit Transfer implementation guidelines
• EBA STEP2 updates dated November 23, 2015

SWIFT

Updates have been made to the following SWIFT components to support the SR 2016 version of SWIFT to take effect on 20 November 2016.

• SWIFT Type trees
• LMF Maps and Trees
• Java Validation Component (JVC)
• MX Validation Framework

In addition, the following enhancements have been made:

• New configuration options in the JVC improve control of the location of the jvalnnn.prop configuration file, and make FileActMode and MessageLength validation configurable. Refer to the online documentation for details.
• A new version of the MT950 Split example demonstrates an efficient method to split SWIFT messages. Refer to the example readme file for details.

Documentation

In addition to documentation updates in support of new and revised features, these revisions have been made:

• The LMF tables are now delivered as Excel files and installed with the product. They are located at itx_install_dir\packs\financial_payments_vn.n.n\swift\mt\lmf\mapping_tables
• This statement has been added to several topics to emphasize the need for an up-to-date currencycodedecimals lookup file:
  Note: The currencycodedecimals.xml file that is included with the product is an example only.  You are responsible for providing your own currencycodedecimals.xml file, which is generated from data that you download from SWIFT or ISO. See the Common map components topic for details.
• Product names for v9.0 and later are updated to "IBM Transformation Extender" or "ITX" from the former name, "WebSphere Transformation Extender," which applies to v8.4.0 and 8.4.1.
  
  In some cases, legacy versions prior to 9.0 might be referenced in the documentation as "IBM Transformation Extender." The product name for legacy versions 8.4.0 and 8.4.1 is still WebSphere Transformation Extender.
  

Deprecated functions, components and platforms

There are no deprecated items that are specific to the ITX Pack for Financial Payments V9.0.1.


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

PI49920	Text field validation for tags 50F and 59F in Pack for SWIFT 4.3.4
PI49521	MT942 RULE C3 DID NOT PROPERLY CATCH ALL SCENARIOS
PI49432	JVC CODE WAS NOT CHECKING FOR BLANKS IN LINE 3/ OF MT101 FIELD 59F
PI61843	Parse error occurred at MT940 Tag61 field 7/8

=====================================================================
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 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/).