JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Java CAPS SWIFT Message Library User's Guide     Java CAPS Documentation
search filter icon
search icon

Document Information

SWIFT Message Library

Overview of SWIFT Message Libraries

Library Versions and Access

Installing the SWIFT Message Library

Increasing the Heap Size

To Increase the Heap Size for GlassFish

To Increase the Heap Size for NetBeans

Using the SWIFT Message Library

SWIFT Message Type OTDs

SWIFT Message Structure

Message Library and Collaboration Locations in NetBeans

SWIFT Message Type Reference

Category 1 Messages

Category 2 Messages

Category 3 Messages

Category 4 Messages

Category 5 Messages

Category 6 Messages

Category 7 Messages

Category 8 Messages

Category 9 Messages

Validation Collaborations

SWIFT Generic Library

SWIFT Message Library JAR Files

Using Message Validation Features

Basic Validation Features

Validation Components

Validation Methods

Validation Collaboration Definitions

Validation Operation

Basic validation steps

Library Methods

Message Validation Rules

Message Format Validation Rules (MFVR)

MFVR Validation Methods

MFVR Errors

In Collaboration Validation Methods

validate()

Description

Syntax

Parameters

Return Values

Throws

validateMFVR()

Description

Syntax

Parameters

Return Values

Throws

validateMPR()

Description

Syntax

Parameters

Return Values

Throws

Calling the Validation Methods in your Collaboration

SWIFT Projects

Importing a Sample Project

To Import a Sample Project

SWIFT Projects and NetBeans

About the SWIFT MX Validation Sample

Sample Project

Descriptions of components

Running the MX Sample Project

SWIFT Correlation Repository Sample

Prerequisites

Installation steps

Preparing an SCR flow

Designing an SCR flow

Linking the Domain Name and Direction to a Color

Using the SCR for Monitoring Flows

Using the Viewer for Monitoring Transactions

Using the SCR as Gatekeeper

Using the Viewer to Repair Messages

Updating BICDirService

Source of Information

Update Operation

BICDirService Method Operation

Lookup Method Definitions

Validation Method Definitions

BICDir Exceptions

Error message framework

Error Message General Form

Updating BICPlusIBAN

To Update BICPlusBAN Information

BICPlusIBAN Validation Method Definitions

Error Message Information

Error Messages

Setting the Debug Level

Message Examples

Parse Debug Level Message Example

Using SWIFT FIN-Based Funds OTDs

SWIFT Message Library Funds Features

Using SWIFT Message Library Java Classes

Relation to OTD Message Types

SWIFT Message Library Javadoc

OTD Library Java Classes

Message Validation Rules

Validation Collaborations are provided for specific SWIFT Message types and their corresponding OTDs in the library. For a complete list of validation Collaborations, see Validation Collaborations.

Message Format Validation Rules (MFVR)

The MFVR support for the SWIFT Message Library is a set of functions collectively known as the message format validation rules methods. These functions accurately test the semantic validity of a given subset of the SWIFT messages. Validation is performed according to standards provided in SWIFT’s publication, the Message Format Validation Rules Guide (current version).

There is one validation method for each MFVR message type and its corresponding OTD. Each method is called on a particular OTD and is used to validate the data of a given instance of that message type. Because business practices vary greatly between organizations, these functions can be modified as needed.

For examples of how the MFVR validation process works, you can import the sample validation Projects. For details, see SWIFT Projects.

SWIFT’s MFVR validation rules are known as semantic verification rules (SVRs) or semantic rules, as opposed to the syntactic rules, which verify the syntax of the fields only. Syntactic verification is built into each OTD.

SWIFT defines a total of 299 SVRs that are validated by the FIN network engine. SWIFT Alliance Access or IBM’s Merva products do not implement these rules, mainly because there is no functional model, and the implementation work is mostly manual. Each message type has to be validated against a subset of these rules.

In addition this set of 299 SVRs, SWIFT has defined a new series of rules to help enable straight-through processing (STP) in the securities industry. The OTD methods that validate for MFVR compliance also validate for compliance with STP rules.

MFVR Validation Methods

The MFVR methods adhere to SWIFT’s current Message Format Validation Rules Guide, including those in any updates section in the back of the manual. The methods implement all of the “special functions” as defined in the guide, which are required by the validation rules.

The SVR methods also implement the semantic validation functions used in the validation functions, as defined by the current Message Format Validation Rules Guide.

Using this semantic validation, Java CAPS can verify the contents of each message before it is sent into the FIN network, saving time and usage fees.

MFVR Errors

MFVR errors result from the application of the Semantic Validation Rules. Multiple errors are possible, and they are given in the order in which they occurred and with the sequences, fields, or subfields used to determine them.

For example, an MFVR failure on a 535 Collaboration OTD appears as follows:

MFVR MT535 Error
SVR Rule 103 - Error code: D031001 = Since field :94a:: is present 
in Sequence B, then   fields :93B::AGGR and :94a::SAFE are not 
allowed in any occurrence of Subsequence B1a.mt_535.Mt_535.Data[1].
SubSafekeepingAccount mt_535.Mt_535.Data[1].SubSafekeepingAccount[0].
SubSeqB1[0].SubSeqB1a.Balance
        
SVR Rule 104 - Error code: D04-1001 = Since field :93B::
AGGR is present in Subsequence B1a,then 
:field 94a::SAFE must be present in the same Subsequence B1a.
mt_535.Mt_535.Data[1].SubSafekeepingAccount[0].SubSeqB1[0].
SubSeqB1a.Balance

For more information on error messages, see Error Message Information.