Table of Contents

Search

  1. Preface
  2. Libraries for Industry Standards
  3. Using Libraries
  4. Descriptions of the Libraries
  5. Generate Library Objects

Libraries Guide

Libraries Guide

Message Splitter

Message Splitter

A dedicated Script named MTnnn_splitter.tgp splits MT messages 940, 942 and 950 when they are longer then the maximum message length. The Script is available in the restricted Serializer project.
The SWIFT UHB defines the logic used to split the messages. By default, the message is not partitioned. To split a message, set the value of the variable
SplitLargeMessage
to
true
in MTnnn_splitter.tgp.
The output is split into separate output files by the following method:
  • The output XML contain a list of message parts, the file names, and the file path. By default, the
    Results
    folder contains the output files. To change the output path, set the value of
    vOutputPath
    .
  • The output file names are determined by the value of the message field 20, a sequence part number, and a flag that identifies whether the file contains the last part. For example, a message that is split into five parts will have the following file names:
    12345TraRF123456_1_N.txt
    12345TraRF123456_2_N.txt
    12345TraRF123456_3_N.txt
    12345TraRF123456_4_N.txt
    12345TraRF123456_5_Y.txt
    To change the logic for file names, change the rules in the splitter group section
    createUniqueFileName
    .
  • Field 103, the Message User Reference field, is updated by default. If the value is set, it is the same for all message parts. To change the setting, enable the MUR logic in the group section
    calculateMessageUserReference
    , or create proprietary logic.
If the variable
SplitLargeMessage
is set to
true
, but the message length is within the maximum length limit, the Script splits the message with the splitter logic defined in this section.
To transform the MT940, MT942, or MT950 messages with the Developer tool, ensure that the
SWIFT_Lookups
folder is in the folder named
C:\Users\<user>\AppData\Local\Temp\2\DTTemp
. If needed, copy the folder from the ServiceDB to the folder
C:\Users\<user>\AppData\Local\Temp\2\DTTemp
. If you run the service from outside the ServiceDB, you need to ensure that the
SWIFT_Lookups
folder is in the same path as the project.
If message MT940 generates validation error code C24 during the split procedure, then the splitter fails. The C24 error code has the following description:
C24 error code
If field 86 is present in any occurrence of the repetitive sequence, it must be preceded by a field 61. In addition, if field 86 is present, it must be present on the same page or message of the statement as the related field 61.

0 COMMENTS

We’d like to hear from you!