IBM Support

Release notes for IBM Sterling Transformation Extender, Pack for Financial Payments Plus, V10.2.1.0

Release Notes


Abstract

These release notes contain the information required to install and configure the IBM Sterling Transformation Extender, Pack for Financial Payments Plus, version V10.2.1.0

Content

Pack for Financial Payments Plus V10.2.1.0 release notes.

© Copyright IBM Corporation 2005, 2022. All Rights Reserved.
© Copyright HCL Technologies Ltd, 2017, 2022. All Rights Reserved.

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

=====================================================================
ABOUT THIS RELEASE
=====================================================================
Where to find the software to download

To download the software for this version of the IBM Sterling Transformation Extender Pack for Financial Payments Plus, go to Passport Advantage. This location will direct you to the Passport Advantage (PA) and Passport Advantage Express (PAE) overview page. Passport Advantage (PA) and Passport Advantage Express (PAE) are comprehensive IBM programs by which Clients may order Eligible Products. Customers can search PA and PAE for the following part numbers to download files for windows install and Red Hat OpenShift which include the project files used with the Design Server and certified containers.

Part numbers for Financial Payments Plus 10.2.1.0, search:

  • Windows install - M08CDML
  • Red Hat 'OpenShift' - M08CFEN
=====================================================================
DOCUMENTATION NOTES
=====================================================================

View the latest product documentation
See the online documentation for the latest documentation for this product.
Financial Payments Plus latest 10.2.1 documentation is available in the 10.1.2 online documentation, see What's new in Packs V10.2.1 for more details.

Translated documentation

The online documentation is provided in these languages:

  • English (United States)
  • French

Viewing translated documentation

To display translated content in the online documentation:

  1. Open the online documentation. A typical URL to the documentation is shown below:
    https://www.ibm.com/docs/en/ste
  2. Edit the URL to include the desired language code immediately after "/ibm.com/docs":
    https://www.ibm.com/docs/<language code>/ste
  3. As an example, enter language code "/fr" to display French content.
  4. Remove the "/<language code>" to return to the English display. 
 

=====================================================================
INSTALLATION
====================================================================
Installation prerequisites

One of the following versions of the base product must be installed:

  • 10.1.2.0
  • 10.1.1.1
  • 10.1.0.2
  • 10.0.3.1
  • 10.0.0.0

Note: All design server projects are recommended to install 10.1.2 design server.
To enable MT validation, install the latest Pack for Financial Payments.
This product is supported on the same platforms as the prerequisite products.

Deploying the pack to other operating systems

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

Installation directories

The pack components will not require any installation program. They can be extracted from the following ZIP files on a targeted directory: 
<TX_install_dir>/packs/financial_payments_plus_vn.n.n.n

Where <TX_install_dir> is the installation location of the IBM Sterling Transformation Extender base product, and n.n.n.n is the version of the pack.

Installing the pack on Windows systems
Follow these steps to install the pack on Windows systems:

  • Obtain the image from Passport Advantage.
  • The pack will not require any installation program.
Using with Design Studio, the following ZIP files will be available per supported TX version:
  • finpayplus_10.2.1.0_v1012.zip
  • finpayplus_10.2.1.0_v1011.zip
  • finpayplus_10.2.1.0_v1010.zip
  • finpayplus_10.2.1.0_v1003.zip
  • finpayplus_10.2.1.0_v1000.zip
Using with Design Studio, the following ZIP files will be available per supported TX-RS version:
  • finpayplus_10.2.1.0_v1011_rs.zip
  • finpayplus_10.2.1.0_v1010_rs.zip
  • finpayplus_10.2.1.0_v1003_rs.zip
  • finpayplus_10.2.1.0_v1000_rs.zip

To install:

  1. Select zip based on preferred TX version.
  2. Right-click to select Extract All, and then Select a Destination and Extract Files on Files will be extracted to this folder:
  3. Click Browser and navigate under <TX install dir>
  4. Select the packs folder (create folder if needed).
  5. Click Extract.
  6. Verify folder was created, that is
    <TX_install_dir>/packs/financial_payments_plus_v10.2.1.0
  7. Read the license files.

To uninstall:

  1. Delete the folder <TX_install_dir>/packs/financial_payments_plus_v10.2.1.0
Using with Design Server User Interface, the following ZIP file will contain all projects that can be imported:
  • IBM_financialpaymentsplus_10.2.1.0.zip

To install:

  1. Read the license files.
  2. Select and import project zip using Design Server UI.

To uninstall:

  1. Delete the project previously imported.
=====================================================================
USING THE PACK WITH THE IBM DESIGN SERVER
=====================================================================
  1. Login to the Design Server.
  2. Click the Import Project icon.
  3. In the Import Project dialog, drag the .zip file into the Project Zip File box.
  4. Click the Import button to import the project.
Note: IBM Design Server 10.1.2 version is recommended to import the project.
=====================================================================
PROJECT FILES
=====================================================================

The following projects are available either in: 

  •  IBM_financialpaymentsplus_10.2.1.0.zip when the file is unzipped or 
  • Installation directory 
    UIProjectImports <TX_install_dir>/packs/financial_payments_plus_v10.2.1.0/UIProjectImports

The project import files are provided as a convenience and should not be used with Windows based Design Studio implementations.
You must have administrative privileges to import the projects. 

Each of the projects is described briefly in the following section:

cbpr_translation.zip - CBPR+ MT-MX Translation Maps example
Contains the files, schemas, and maps required to run the “CBPR Plus MT-MX Translation Maps Example”. Based on CBPR+ Translation Rules 01 February 2022.

cbpr_validation.zip - CBPR+ enhanced MX validation example
Contains the files, schemas, maps, and flows required to run the “CBPR+ enhanced MX validation Example” using flow. Based on CBPR+ ISO20022 Portfolio Nov 2022 Release 2.1, date of publication 29 December 2021.

chaps_l4l.zip - CHAPS L4L enhanced MX validation example
Contains the files, schemas, maps, and flows required to run the “CHAPS L4L enhanced MX validation Example”. Based on Bank of England SWIFT MyStandard Readiness Portal, date of publication 22 July 2021.

chaps_enh.zip - CHAPS ENH enhanced MX validation example
Contains the files, schemas, maps, and flows required to run the “CHAPS ENH enhanced MX validation Example”. Based on Bank of England SWIFT MyStandard Readiness Portal, date of publication 22 March 2022.

eba_e1s1.zip - EBA EURO1/STEP1 enhanced MX validation example
Contains the files, schemas, maps, and flows required to run the “EBA EURO1/STEP1 enhanced MX validation Example”. Based on EBA Clearing EURO1/STEP1 SWIFT MyStandard Readiness Portal, date of publication 07 September 2022.

swift_uc.zip - SWIFT Universal Confirmation example
Contains the files, schemas, maps, and flows required to run the “SWIFT Universal Confirmation Example”. Based on Universal Confirmation SWIFT MyStandard Readiness Portal, date of publication 14 June 2021.

t2_clm.zip - TARGET2 CLM example
Contains the files, schemas, maps, and flows required to run the “TARGET2 CLM Example”. Based on TARGET2 CLM SWIFT MyStandard Readiness Portal, date of publication 01 April 2021.

t2_rtgs.zip – TARGET2 RTGS enhanced MX validation example
Contains the files, schemas, maps, and flows required to run the “TARGET2 RTGS enhanced MX validation Example”. Based on TARGET2 RTGS SWIFT MyStandard Readiness Portal, date of publication 01 April 2021.

t2_coco.zip – TARGET2 CoCo enhanced MX validation example
Contains the files, schemas, maps, and flows required to run the “TARGET2 CoCo enhanced MX validation Example”. Based on TARGET2 CoCo SWIFT MyStandard Readiness Portal, date of publication 01 April 2021.

=====================================================================
CONFIGURATION FOR RUNNING TRANSLATION
=====================================================================
The cbprJnodesConfigIBM.tar.gz file is available either in: IBM_financialpaymentsplus_10.2.1.0.zip or within UIProjectImports directory.

The UIProjectImports directory is in the following location:
install_dir/packs/financial_payments_plus_vn.n.n.n/UIProjectImports
Where install_dir is the installed location of the base product, and n.n.n.n is the current version of the pack.

The following artifacts needs to be copied based on the environment setup:

  • jnodes0.jar
Copy the following jars from <TX_install_dir>/jars
  • jackson-core-n.n.n.jar
  • jackson-annotations-n.n.n.jar
  • jackson-databind-n.n.n.jar

or visit https://repo1.maven.org/maven2/com/fasterxml/jackson/core/ for download.

Recommended version 2.13.3 or higher.

Configuration files for non Docker environments:

  • Copy jars to <TX_install_dir>/extjars

Configuration files for Docker environments:

  • Docker cp jnodes0.jar tx-server:/opt/ibm/wsdtx/libs/
  • Restart design server, i.e., docker restart tx-server
 =====================================================================
CONFIGURATION FOR MT VALIDATION
=====================================================================

If you need the MT validation messages, do as follows:

For non Docker environments:

  • Install the latest version of the pack for Financial Payments.

For Docker environments:

  • Extract the swiftMTjvcConfig.tar.gz file available from the Pack of Financial Payments.

=====================================================================
A. CONFIGURATION FILES FOR LINUX
=====================================================================
Using the Pack for Financial Payments, the swiftMTjvcConfig.tar.gz file is available either in:
 IBM_financialpayments_10.2.1.0.zip or within UIProjectImports directory.

The UIProjectImports directory is in the following location:
install_dir/packs/financial_payments_vn.n.n.n/UIProjectImports

Where install_dir is the installed location of the base product, and n.n.n.n is the current version of the pack.

Use these steps to run this file:

Extract the swiftMTjvcConfig.tar.gz file:

Before you import the cbpr_translation.zip file, follow these steps.
Perform the steps in the same directory location as the Design Server is installed:

  1. Create a temp directory called packs.
    Example: /home/user/packs
  2. FTP (in binary mode) the swiftMTjvcConfig.tar.gz to the pack's directory defined in step 1.
  3. Untar the swiftMTjvcConfig.tar.gz file.
    Example:
    $ tar -zxf swiftMTjvcConfig.tar.gz
  4. Run the jvcsetup.sh script.
    Example:
    $ ./jvcsetup.sh
     The script copies the following to the ITX server:
    jvcwrap.jar
    jvalccyy.jar
    packs/swift folder and sub-folders, includes the jvalccyy.prop and XML metadata.
  5. OPTIONAL: Run the cleanjvc.sh script.
    Example:
    $ ./cleanjvc.sh
    The script removes the following to the ITX server:
    jvcwrap.jar
    jvalccyy.jar
    packs/swift folder and sub-folders, includes the jvalccyy.prop and XML metadata.
  6. After importing the cbpr_translation.zip project, the jvalccyy.prop file must be uploaded (added) to the project using the Files tab. Set the Folder to:
    tools/mt_validation/data/../maps
  7. Restart Design Server: docker restart tx-server.
    NOTE: To reflect any jvalccyy.prop updates onto the cbpr_translation.zip project, delete the previously uploaded (added) jvalccyy.prop file, then repeat steps 6 and 7.
=====================================================================
B. CONFIGURATION FILES FOR WINDOWS
=====================================================================

Using the Pack for Financial Payments, the swiftMTjvcConfigIBM_x.x.x_win.zip file is available either in:
IBM_financialpayments_10.2.1.0.zip or within UIProjectImports directory.
Where x.x.x is the TX version from V10.1.0 and up.

The UIProjectImports directory is in the following location:
install_dir/packs/financial_payments_vn.n.n.n/UIProjectImports
Where install_dir is the installed location of the base product, and n.n.n.n is the current version of the pack.

Use these steps to run this file:

Extract the swiftMTjvcConfigIBM_x.x.x_win.zip file.
Before you import the cbpr_translation.zip file, follow these steps.
Perform the steps in the same directory location as the Design Server is installed:

  1. On the ITX install directory, run the script dtxcommon.bat.
    Example:
    C:\IBM\TransformationExtender_10.1.2>dtxcommon.bat
  2. Extract the swiftMTjvcConfigIBM_x.x.x_win.zip file to a temporary folder.
  3. Run the jvcsetup.bat script.
    Example:
    C:\tmp>jvcsetup.bat
    The script copies the following to the ITX server:
    jvcwrap.jar
    jvalccyy.jar
    packs/swift folder and sub-folders, includes the jvalccyy.prop and XML metadata.
  4. OPTIONAL: Run the cleanjvc.sh script. Example:
    C:\tmp>cleanjvc.bat
    The script removes the following to the ITX server:

    jvcwrap.jar
    jvalccyy.jar
    packs/swift folder and sub-folders, includes the jvalccyy.prop and XML metadata.

  5. After importing the cbpr_translation.zip project, the jvalccyy.prop file must be uploaded (added) to the project using the Files tab. Set the Folder to:
    tools/mt_validation/data/../maps
  6. Stop and start the Design Server.

    Example:
    <Design Server install dir>\stop.bat and <Design Server install dir>\start.bat
    NOTE: To reflect any jvalccyy.prop updates onto the cbpr_translation.zip project, delete the previously uploaded (added) jvalccyy.prop file, then repeat steps 5 and 6.

=====================================================================
KNOWN ISSUES AND WORKAROUNDS
=====================================================================
T2 CLM, CoCo, RTGS Business Application Header with <Sgntr> element failing XML schema validation.

Version UDFS V2.2 of the head.001.001.01.xsd published from MyStandards T2 CLM/RTGS/CoCo portals have the elelment /AppHdr/Sgntr defined with type.

SignatureEnvelope_CSLD

The head.001.001.01.xsd is missing reference to the external XML schema required by the namespace and to validate the /AppHdr/Sgntr element

Workaround:

<xs:schema xmlns="urn:iso:std:iso:20022:tech:xsd:head.001.001.01" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" targetNamespace="urn:iso:std:iso:20022:tech:xsd:head.001.001.01">
    <xs:import namespace="http://www.w3.org/2000/09/xmldsig#" schemaLocation="xmldsig-core-schema.xsd"/>

<xs:element name="AppHdr" type="BusinessApplicationHeaderV01"/>

Import of Design Server example projects take a long time

Workaround:

Update the following settings from tx-server-env.bat / tx-server.env
from
    set TX_LONG_WORKER_JVM_OPTIONS="-Xmx2g -
Dhttps.protocols=TLSv1.2,TLSv1.3 -Didk.tls.client.protocols=TLSv1.2,TLSv1.3"
    set TX_SHORT_WORKER_JVM_OPTIONS="Xmx2g -
Dhttps.protocols=TLSv1.2,TLSv1.3 -Djdk.tls.client.protocols=TLSv1.2,TLSv1.3"
to
    set TX_LONG_WORKER_JVM_OPTIONS="-Xmx4g -
Dhttps.protocols=TLSv1.2,TLSv1.3 -Djdk.tls.client.protocols=TLSv1.2,TLSv1.3"
    set TX_SHORT_WORKER_JVM_OPTIONS="=Xmx4g -
Dhttps.protocols=TLSv1.2,TLSv1.3 -Djdk.client.protocols=TLSv1.2,TLSv1.3"
  

M202 Warning

Building some of the source maps might trigger M202 warnings like the warning shown below. These messages can be ignored:

------------------------------------------------------------------------------
M202 WARNING:
    Map: f_rltdpties_dbt_pty   Output: choice:sequence:Pty:out
    Parm 1 of EITHER doesn't match required type.

------------------------------------------------------------------------------

=====================================================================
RESOLVED AUTHORIZED PROGRAM ANALYSIS REPORTS (APARS)
=====================================================================

For a list of APARs that are fixed in this version of the product, see the fix list.

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

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

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSE82XJ","label":"IBM Sterling Transformation Extender Pack for Financial Payments"},"ARM Category":[{"code":"a8m3p000000PC3rAAG","label":"Pack for Financial Payments Plus"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"10.2.1"}]

Document Information

Modified date:
23 January 2023

UID

ibm16827787

Page Feedback