Sample payment conversion user exit

This sample user exit is used to convert transactions that are in the ISO 200022 format to the ISF format.

The following sections provide an overview on how to compile and configure the sample user exit.

To compile this sample user exit, you need the following files:
  • UserPaymentConversionSample.java
  • base_java_utilities.jar

Getting the user exit files from the container

Complete the following steps to get the user exit files from the artifacts container.
  1. The files for user exits are provided in the FTM artifacts pod and must be downloaded from the pod. For more information about getting files from the artifacts container for your offering, see Getting the files from the artifacts container for your FTM offering.
  2. Extract the user exit files on a workstation that has the Java™ compiler.

Compiling

To compile the user exit, complete the following steps.
Note: The following example of compiling the user exit must be customized based on the Java class name, Java package name, and location of the dependency JAR files that you are using.
  1. The UserPaymentConversionSample class is in the com.ibm.fxh.user.payment.conversion.samples Java package, so create the following directory structure: C:\com\ibm\fxh\user\payment\conversion\samples.
  2. Copy the following files into the C:\com\ibm\fxh\user\payment\conversion\samples directory.
    • UserPaymentConversionSample.java
    • base_java_utilities.jar
  3. Compile the Java class by using the following commands. Use the IBM® Java 17 SDK to compile.
    cd C:\com\ibm\fxh\user\payment\conversion\samples
javac UserPaymentConversionSample.java -classpath base_java_utilities.jar

Packaging

After the code is compiled, package the class file into a JAR file that is used to deploy into the Transaction Server user interface runtime.

The following example of creating a JAR file must be customized based on your selected file names.
cd \
jar cvf C:\com\ibm\fxh\user\payment\conversion\samples\UserPaymentConversionSample.jar com\ibm\fxh\user\payment\conversion\samples\UserPaymentConversionSample.class

Installing

For more information about installing this user exit, see User exits for the FTM components.

Configuring

To use the user exit, configure it in the user interface.

  1. Browse to the Transaction Server general properties page.
  2. Click Edit.
  3. Enter the value com.ibm.fxh.user.payment.conversion.samples.UserPaymentConversionSample for the ISO20022 to ISF User Exit property.
  4. Save your changes and restart the Control Center.