Lite2 PDF
Lite2 PDF
User Guide
This guide describes how to use the Alliance Lite2 web interface to create, modify, verify, and authorise FIN and MX
messages. It also describes how to search for messages, create reports, and send and receive files. The guide is for
business users of the application.
07 December 2018
Alliance Lite2 Table of Contents
User Guide
Table of Contents
Preface............................................................................................................................................................... 5
2 SWIFT Training...................................................................................................................................... 11
3 Getting Started.......................................................................................................................................12
3.1 Get Access to Alliance Lite2.................................................................................................................. 12
3.2 Activate Token....................................................................................................................................... 12
3.3 Change Password..................................................................................................................................14
3.4 Log in to Alliance Lite2 ......................................................................................................................... 16
3.5 Log out of Alliance Lite2........................................................................................................................ 18
3.6 Troubleshooting..................................................................................................................................... 18
5 Message Preparation............................................................................................................................ 27
5.1 Message Editor......................................................................................................................................27
5.2 Messages and Message Instances....................................................................................................... 31
5.3 General Message Structure...................................................................................................................32
5.4 Management of Messages.................................................................................................................... 33
5.5 Message Queues.................................................................................................................................. 35
5.6 Message Information for FIN and APC Messages................................................................................ 36
5.7 Message Information for SWIFT MX Messages.................................................................................... 37
5.8 Business Identifier Code (BIC).............................................................................................................. 40
07 December 2018 2
Alliance Lite2 Table of Contents
User Guide
7 Message Creation..................................................................................................................................72
7.1 Create Messages.................................................................................................................................. 73
7.2 Create FIN Messages............................................................................................................................73
7.3 Create APC Messages.......................................................................................................................... 78
7.4 Create MX Messages............................................................................................................................ 78
7.5 Use Message Templates....................................................................................................................... 83
7.6 Fast Mode..............................................................................................................................................93
7.7 Validate a Message............................................................................................................................... 96
7.8 Route a Message.................................................................................................................................. 99
7.9 Send a Message to a Queue (Dispose to)............................................................................................ 99
7.10 File Message: Send.............................................................................................................................101
7.11 File Message: Get............................................................................................................................... 110
7.12 RMA Check Failure for File Messages................................................................................................ 114
07 December 2018 3
Alliance Lite2 Table of Contents
User Guide
13 Support.................................................................................................................................................176
07 December 2018 4
Alliance Lite2 Preface
User Guide
Preface
Purpose of the document
This guide describes how to use Alliance Lite2 to create, modify, verify, and authorise FIN and MX
messages. It also describes how to search for messages, create reports, and send and receive
files.
Audience
This guide is for business users of the application.
Significant changes
The following table lists all significant changes to the content of this document since the November
2017 edition.
The homepage for the new GUI is provided. The Alliance Lite2 GUI on page 19
The migration procedure of FIN and MX message Migration of FIN and MX Message Templates on
templates have changed. page 92
The Message Instance Search command has been Move Instances on page 161
removed and is covered by the Message Search
Reassign Instances on page 161
feature.
Change Priority of Instances on page 162
The search possibilities of messages has been Search by Source and Creation on page 152
updated.
Search for Message Instances on page 160
Related information
Alliance Lite2 support page
Alliance Lite2 Service Description
Alliance Lite2 Administration Guide
Security Officer Guide
Find Your Way in Alliance Lite2
Alliance Lite2 AutoClient User Guide
Alliance Lite2 Administration Guide - RMA
07 December 2018 5
Alliance Lite2 Introducing Alliance Lite2
User Guide
Types of environment
Alliance Lite2 offers two types of environments:
• Live environment: You use this environment to send live business messages and files. This
environment is also called Production environment.
• Test environment: You use this environment to exchange Test and Training messages and
files. Other benefits of this environment are as follows:
- New Alliance Lite2 users can try the Alliance Lite2 service in a safe environment before
using the Live environment. Messages and files that users exchange in the Test environment
have no financial consequences.
- Existing Alliance Lite2 users can exchange test messages and files with a new
correspondent to learn how to send and process messages and files properly.
- Customers can test new Alliance Lite2 releases.
You can view only live messages and files in the Live environment and only test messages and files
in the Test environment. The Test environment is a simulation of the Live environment, and you
cannot send, view, or process a live message or file in the Test environment. Messages or files that
you send from the Test environment are marked as test or pilot so that recipients of these
transactions do not process them as live messages or files.
07 December 2018 6
Alliance Lite2 Introducing Alliance Lite2
User Guide
07 December 2018 7
Alliance Lite2 Introducing Alliance Lite2
User Guide
Examples of messages
The following are some examples of the messages that you can process using the Web interface:
Payments messages (MT) such as:
• initiation of multi-bank payments
• display balances and history of multi-bank cash accounts
Treasury messages (MT) such as:
• Foreign-Exchange confirmations
• Fixed Loan/Deposit confirmations
Securities Instructions (MT):
• Receive Financial Instrument
• Deliver Financial Instrument
• Process Deliver and Receive Confirmations and Status
Funds Management (MX):
• Subscription Orders
• Redemption Orders
• Switch Orders
• Generate Confirmations and Status (accept or reject)
• Processing and Linking of incoming and outgoing Confirmations and Status
Asset Holdings (MT and MX):
• Display of received statements and holdings
07 December 2018 8
Alliance Lite2 Introducing Alliance Lite2
User Guide
BIC example
An example of a BIC is ALGEDEFF, the BIC8 for Algemeen Bank in Frankfurt, Germany which is
made up of the following:
• the first four characters of a BIC are a unique "shorthand" for the institution's name (ALGE)
• the next two characters are a country code (DE)
• the next two characters are a location (FF) which can, for example, indicate a city or a region.
The last three characters of a BIC11 indicate a branch of the institution. The BIC11 with XXX as
branch code, for example, ALGEDEFFXXX, is equivalent to the BIC8.
or
ou=<name>, o=<bic8>, o=swift
or
cn=<name>, ou=<name>, o=<bic8>, o=swift.
In general, the maximum length of a DN is 100 bytes plus maximum ten levels.
cn=<name>, ... , cn=<name>, ou=<name>, o=<bic8>, o=swift
or
cn=%52,cn=john,ou=users,o=algedeff,o=swift
07 December 2018 9
Alliance Lite2 Introducing Alliance Lite2
User Guide
An RMA relation
The Relationship Management Application (RMA) is SWIFT's generic correspondent-control
mechanism. RMA enables SWIFTNet customers to control what they want to receive and from
which correspondent. An Alliance Lite2 administrator can set up or create an "RMA relation" to
transact with a particular bank.
Activation of a received RMA is not automatic, the Alliance Lite2 administrator must view the
received RMAs to activate them for use in Alliance Lite2.
For more information, see the Alliance Lite2 Administration Guide - RMA.
07 December 2018 10
Alliance Lite2 SWIFT Training
User Guide
2 SWIFT Training
SWIFT provides training about standards, products, and services to suit different needs. From
tailored training to self-paced e-learning modules on SWIFTSmart, a range of training options are
available for all SWIFT users.
SWIFTSmart
SWIFTSmart is an interactive, cloud-based training service that offers a large variety of courses for
different levels of knowledge. The courses contain exercises and quizzes and are available in
multiple languages. The SWIFTSmart catalogue provides a lists of courses that are organised into
these learning tracks:
• General knowledge
• Work with messages
• Deploy and manage SWIFT software solutions
• Security and audit
• Compliance and shared services
SWIFTSmart is accessible from the desktop or from a mobile device. No installation is required.
It is available to all connected SWIFT users and registered SWIFT partners with a swift.com
account. For more information, see How to become a swift.com user.
Tailored training
A full range of tailored programmes are available to meet specific training needs. For more
information, visit the Training web page.
07 December 2018 11
Alliance Lite2 Getting Started
User Guide
3 Getting Started
This section describes how you can perform the following tasks:
• get access to Alliance Lite2.
• activate your personal token
• log in to Alliance Lite2: for an Alliance Lite2 user or an Administrator who wants to get access to
the Alliance Lite2 application
• use your password to sign important actions
• log out of, or end, a web session of Alliance Lite2
• troubleshooting
CAUTION Never share your password with other users, not even with SWIFT. SWIFT staff never
ask you for your password. Furthermore, you must take great care of your USB token
when it is not in use.
07 December 2018 12
Alliance Lite2 Getting Started
User Guide
You must activate your token on the SWIFT Certificate Centre before you can use it for SWIFT
services. The activation process generates your PKI private key and stores it on the token.
About this task
When you receive your personal token, the token is inactive because it does not yet contain the
private key to your digital certificate. Activation generates a public and private key pair. The public
key is sent for registration with the SWIFTNet PKI authority. The private key never leaves the token.
Procedure
1. Retrieve the activation code from Secure Channel (see the Secure Channel User Guide >
Activate a Personal Token).
2. Open Internet Explorer and navigate to http://www.swift.com/certificates.
The SWIFT Certificate Centre window appears.
3. Insert your token into a free USB port of your computer.
4. Click Login .
The Confirm Certificate window appears.
5. Check that you are using the correct certificate by clicking the link Click here to view
certificate propr....
The correct certificate is issued by SWIFT and has a numeric name.
6. Select the certificate and click OK .
The Token Logon window appears.
7. Type the initial password that was supplied with the token in the Token Password field and
click OK .
You receive your token from one security officer, and the initial password from the other security
officer.
8. You may have to provide the password a second time.
The SWIFT Certificate Centre Login window appears.
9. Type the initial password that was supplied with the token in the Enter your token password
field and click Login .
The Token Activation window appears.
10. Click Next .
11. In the Enter Activation Code window, type the activation code that you received from your
security officer and click Validate .
If there is a problem with the activation code, then re-enter the code and click Validate again.
Note The activation code is required only once to complete the activation. After
activation is complete, this code cannot be reused.
12. You must now set your own password for the token. Read the password policy rules on the
Change password window, then complete the following fields:
Current Password Enter the initial password that was supplied with the token.
New Password Enter your new password following the password policy rules.
07 December 2018 13
Alliance Lite2 Getting Started
User Guide
Note Passwords expire. The token password policy determines how often you must
change your password.
13. Click Change .
Your private key is now being generated on the token and the public key is being certified by
SWIFT.
The Activation complete window appears.
Your personal token is ready for use now that it a stores your certificate and a private key that is
password protected.
The Activation complete window displays the following information about the certificate on your
token:
07 December 2018 14
Alliance Lite2 Getting Started
User Guide
5. Complete the fields to set your new password for the token, and click Change .
A message pops up indicating that "Password changed successfully". Then you are back to the
Overview page.
07 December 2018 15
Alliance Lite2 Getting Started
User Guide
07 December 2018 16
Alliance Lite2 Getting Started
User Guide
Procedure
1. At the Alliance Lite2 login window, you can verify the authenticity of the Alliance Lite2 server as
follows:
• Click the little lock presented by Internet Explorer for one of the following versions.
- for Internet Explorer 8 click the lock at the right side of the address bar and select View
certificates.
- for Internet Explorer 9, 10, and 11, click the lock at the right side of the address bar and
select View certificates.
• A window appears. It contains the information about the certificate of the Alliance Lite2
server. Verify that the certificate is still valid in the Valid from/to field.
2. If OK and there is no reported warning then go to display the Certificate window.
3. Click the Certification Path tab. Only the following two nodes must appear:
• the first is the root CA that issued the Alliance Lite2 server certificate
• the second is the Alliance Lite2 server certificate itself.
4. Select the first node, the root CA, at the top of the Certification Path and click View Certificate.
This displays the General tab. Verify that the root CA certificate is still valid in the Valid from/to
field.
5. Select the Thumbprint in the field column on the Details tab. The Fingerprint of the
Certification Authority that certified the Alliance Lite2 server certificate appears in the lower
frame.
6. Verify that the value matches the value published in the Knowledge Base tip (28660,What are
the fingerprint values of the SWIFTNet Certification Authority Certificate and the SWIFT Code
Signing Certificate?) . You can find the tip on www.swift.com.
7. If all the steps were successful then close all open windows and click Log in to Alliance Lite2 and
continue. If any of the verification failed because of obsolete validation or Thumbprint
mismatching, then do not connect to Alliance Lite2 and contact SWIFT.
07 December 2018 17
Alliance Lite2 Getting Started
User Guide
Explorer. The labels on the Alliance Lite2 interface can have incorrect placement when the display
value of Internet Explorer is not set at 100 percent.
Procedure
1. Insert your USB token in a USB port of a Windows computer.
2. With your Internet Explorer browser, log in to Alliance Lite2 with the appropriate URL:
• On the Internet
https://alliancelite2.swift.com
• On MV-SIPN
https://alliancelite2.swiftnet.sipn.swift.comhttps://alliancelite2.swiftnet.sipn.swift.com
The Alliance Lite2 page appears.
3. Click Login to Live service - Alliance Lite2 customers to go to the Live environment, or click
Login to Test service - Alliance Lite2 customers to go to the test environment.
4. Select your Alliance Lite2 certificate that is issued by SWIFT and click OK .
5. On the Token Logon window, type the token password that you chose in section Change
Password on page 14.
6. Click OK .
The Alliance Lite2 login page appears.
7. Type your password again and click Login .
When the password is accepted, you are ready to access Alliance Lite2 user functions.
If the password is not accepted, then an error message indicates that you entered a wrong
password. After five wrong attempts to enter a token's password, the token becomes unusable.
If you see the message: "Signing failed: Password is permanently locked", then check with
your Alliance Lite2 administrator whether your user ID has been approved. If you try to log in to
Alliance Lite2 using a token that has already been locked you will see the following message:
"The Password is permanently blocked. It cannot be used".
For more information about tokens, see the SWIFT Certificate Centre Portal User Guide.
Note Each login activates an Alliance Lite2 session with an idle timeout of 10 minutes. If a
timeout occurs, then the system automatically logs you off, and you lose all unsaved
changes.
3.6 Troubleshooting
In case of problems, please refer to the following:
• Alliance Lite2 support page
• Find Your Way in Alliance Lite2
07 December 2018 18
Alliance Lite2 The Alliance Lite2 GUI
User Guide
Behaviour
If you click the Help link, then the corresponding help file opens in a new window. The system
opens the help file at the content that corresponds to the page or entity that is currently selected.
You can use the navigational links that are available in the help window to show other topics from
within the online help.
The page from which you click the Help link determines the topics that the system shows:
• If you click the Help link on a page within Alliance Lite2, then the system opens the Alliance
Lite2 online help.
07 December 2018 19
Alliance Lite2 The Alliance Lite2 GUI
User Guide
If you are creating a FIN message (Creation menu), then you can open an MX message template,
and also open a message in the Modification menu. The information remains active for all three
tasks.
You cannot open the same task twice. For example, you cannot create two MX Message: New at
the same time.
You can also do a message search (Search and Report menu) while you edit messages or
complete other tasks. However, if you do a Message Search and view the message search results
for a particular message then return to another task, the search results are discarded. This means
that you must run the message search again.
Selection lists
Some pages in Alliance Lite2 display a list that enables you to select one or more values for a field.
To select a group of values that are not sequential, click a value and then hold down the CTRL key
and click the other values.
Troubleshooting
In case of problems, please refer to the following:
• Alliance Lite2 support page
• Find Your Way in Alliance Lite2
Criteria
This is the behaviour for the search or filtering operation:
• If you do not specify a value for a criterion, then the system does not take that criterion into
account.
• If you specify values for more than one criterion, then the system uses an AND relationship to
evaluate these criteria.
07 December 2018 20
Alliance Lite2 The Alliance Lite2 GUI
User Guide
Wildcards
Some of the search criteria and the filtering criteria fields allow you to use these wildcards:
% (percent) Replaces one or more contiguous unknown a%a matches for example the
characters in a string following strings:
• aba
• afedpa
• azhgjdhsa
_ (underscore) Replaces one unknown character in a string aa_a matches for example the
following strings:
• aa1a
• aaGa
07 December 2018 21
Alliance Lite2 The Alliance Lite2 GUI
User Guide
6. Type the number of rows for the list to show at a time into the Page Size field, if it is available.
The value must be between 10 and 999.
Note The default and recommended value is 20. Using a higher value may have an
impact on the performance of the GUI. The more messages that you ask to be
displayed on a page, the longer it takes to receive the page in your browser.
Changing the Page Size value must be done with care.
7. Click OK .
The Change View window closes and the list layout changes accordingly.
The system also saves any changes to the column widths, if the Save Column Widths check
box is selected.
07 December 2018 22
Alliance Lite2 The Alliance Lite2 GUI
User Guide
Output
You can use the Report function to produce these types of reports:
• Summary report
Available only from pages that contain lists of entities, this report type enables you to include the
information from at least one or more columns on the page for every entity included in the
report.
• Details report
This report type includes all details for every entity included in the report. You can only choose
the output format and formatting options.
If available in the search or filtering criteria area of a page, then the corresponding report includes
all the entities that the current search or filtering criteria return. In the Export window, checking the
"Search Criteria" box will include the current values for search or filtering criteria in the report.
Tip For more information about the types of reports that you can run for messages, see
Message Search and Report on page 135.
07 December 2018 23
Alliance Lite2 The Alliance Lite2 GUI
User Guide
5. For summary reports, you can choose the columns for which details should be included in the
report from the Available list.
6. Click OK .
The File Download window opens and prompts you to open or save the report file.
7. If necessary, click Open to open the report or Save to save the report, as you require.
To open the report, you must have a tool installed that reads the corresponding file format: PDF,
CSV (only for summary reports), TXT, or XLS.
The system opens or saves the report accordingly.
Mandatory Creation: FIN, MX and APC You can set a colour to indicate mandatory fields. See
Field Colour Message Template or Step 3 on page 26.
Message New
07 December 2018 24
Alliance Lite2 The Alliance Lite2 GUI
User Guide
Error Field Creation: FIN, MX and APC You can set a colour to indicate which fields have
colour Message Template or validation or format errors. See Step 3 on page 26.
Message New
Enable Creation: FIN, MX and APC This preference enables you to produce a printed copy
Message Print Message Template or of a message that is being created. See Step 4 on page
for Creation Message New 26.
Enable Modification : all items This setting enables you to produce a printed copy of a
Message Print message that is being modified, after it is routed or
for disposed. See Step 4 on page 26.
Modification
Enable Approval: all items This preference enables you to produce a printed copy
Message Print of a message that is being approved (verified or
for Approval authorised), after it is routed or disposed to a message
queue.
Expansion Creation: FIN, MX and APC This preference enables you to select the language
Language used for displaying field expansions on screen, in the
Modification: FIN, MX and
report obtained by clicking Export , and in the printed
APC
version obtained when the Enable message print for
Approval: FIN, MX and APC Creation, Modification, or Approval preferences are set.
Search and Report: FIN, In reports obtained by clicking Export , this value is
MX and APC used if the report type is Details and if the Display
expanded text option is selected. In instance reports
obtained by clicking Instance report , this value is used if
both the Display expanded text and Message Partner
Print Layout options are selected.
Search Search and Report: FIN, If you have the Message File, Search Message
Template MX and APC permission and are opening a new instance of the
(template of Message Search GUI, this preference enables you to
search criteria) automatically execute a search criteria template of your
choosing. The results of the search are displayed in the
list of messages.
07 December 2018 25
Alliance Lite2 The Alliance Lite2 GUI
User Guide
3. Do the following to change the background colour of Mandatory Field or Error Field:
a) Click next to the appropriate field type box.
A colour palette appears with the colours available for that field type.
b) Click the colour that you want.
The field type box is displayed with the newly selected colour.
4. The Enable Message Print preference enables you to produce a printed copy of a message
after it is created, approved, or modified.
The available options are:
• No (default)
• After Route
• After Dispose
• After Route and Dispose
If you choose to print the message after creation, then Alliance Lite2 does the following:
• prepares the message details for printing
• allows you to select a printer on which to print the message
You can also change the following options:
• output format
• page orientation
• page format
• font size
• include header and footer of the message
The output that is printed includes the message details, the originating task name, and the
destination queue where the message was routed or disposed.
5. Click OK to confirm the changes or Cancel to discard the changes.
07 December 2018 26
Alliance Lite2 Message Preparation
User Guide
5 Message Preparation
Introduction
This section provides background information about the types of messages that an operator can
manage through Alliance Lite2.
It also describes the concepts that the tasks descriptions refer to. For example, it explains the types
of messages that you can send, and provides details about the key concepts related to those types
of messages.
It also describes the message editors that are used to manage MT, MX, and APC messages.
Types of messages
Alliance Lite2 allows you to create and send various kinds of messages:
FIN FIN messages are divided in two Message Information for FIN and
groups: APC Messages on page 36
APC (MT) System message only that allow Message Information for FIN and
you to communicate with the APC Messages on page 36
SWIFT organisation and its user
community.
File Send or receive files using the File Message: Send on page 101
FileAct service. and File Message: Get on page
110
07 December 2018 27
Alliance Lite2 Message Preparation
User Guide
Purpose
Alliance Lite2 includes a form for creating and managing MT, MX, or system messages (APC). The
form is referred to as a message editor. The form is also used to edit a template for MT, APC, or
MX messages.
The editor used to send and receive FileAct messages differs slightly from the message editor for
MT, MX, and APC. For more information about working with FileAct messages, see FileAct Details
(Send) Window on page 102 or FileAct Details (Get) Window on page 111.
Note The Receiver field for FIN messages and ResponderDn field for MX messages is
validated for RMA immediately after it is modified. This on the fly validation allows the
field to be immediately highlighted as an error if the RMA validation is not successful.
07 December 2018 28
Alliance Lite2 Message Preparation
User Guide
Legend
2 The tabs display the message and information about the message.
4 A repetition add button to include a sequence in a message. Each time Help for Messages on
you click the add button, the repetition is automatically expanded. page 43
5 A repetition remove button to remove a sequence and the values from the
fields in the sequence.
10 The field name and a detailed description of the field name. Format of values in
fields on page 30
11 Buttons that provide access to actions that you can perform on the Management of
message. Messages on page 33
The buttons that are available depend on the permission in the operator
profile that is assigned to you.
Tabs
The message editor displays the information in a message in the following tabs.
07 December 2018 29
Alliance Lite2 Message Preparation
User Guide
For more information about these tabs, see General Message Structure on page 32.
• Header
• Application Header (for MX messages only)
• Body
• Comments
The Validation Report tab appears in the message editor to provide errors and warnings about an
action that an operator performed.
If Alliance Lite2 detects errors during the various stages of message preparation, then the
Validation report outlines the following information:
• the location of the problem detected (for example, in the header or the body of the message)
• a description of the error or the warning
Tip Orange is the default colour for error messages. For information about how to change
the error colour, see Change the Preferences on page 24.
Icon Purpose
Click the icon to display the expected syntax of the field. For more information
about how to interpret the format descriptions, see Help for a FIN Message on
page 47.
Where relevant, you can use the drop-down lists to select values for the fields in a message, or
type the value directly in the field.
For text fields, the following information is shown:
• Number of characters already entered in the line on which the cursor is currently positioned
• Maximum number of characters allowed for the line in which the cursor is currently positioned
If the text field accepts multiple lines of input, then the following information is shown:
• Number of lines already entered
• Maximum number of lines allowed in that field
07 December 2018 30
Alliance Lite2 Message Preparation
User Guide
This table shows the different types of drop-down lists, and explains how to recognise when you
can type a value that is not in the list:
Select a value from the list only The drop-down arrow is grey
and the background colour of
the arrow is different from the
colour of the field.
Message instances
There are three different types of message instances:
• Original instance
• Copy instance
• Notification instance (transmission, information, or history)
A source instance is the instance that is being currently processed. It can be an original instance,
new instance, copy instance, or notification instance.
Each message instance has an independent existence and is processed separately from the
original instance.
Original instance
When an operator creates a message through the Message Creation application, or when Alliance
Lite2 receives a message, the first instance of the message is the original instance. Each message
has only one original instance.
You can modify only the message text of an original instance.
07 December 2018 31
Alliance Lite2 Message Preparation
User Guide
Copy instance
The routing software in Alliance Lite2 creates a copy instance of an original instance. A copy
instance is for information purposes only, and therefore, an operator cannot use a copy instance to
change the message text. A copy instance can only "point" to the message text.
Notification instance
The routing software in Alliance Lite2 creates a notification instance.
A notification instance provides information about the delivery status of a message. For example:
• The SWIFT network has acknowledged or rejected the message (that is, the original instance).
• The message failed authentication.
An operator cannot use a notification instance to change the message text. Like copy instances,
they can only "point" to the text.
Status Description
07 December 2018 32
Alliance Lite2 Message Preparation
User Guide
Body The contents (that is, the payload) of the message. The body ✓ ✓
carries the financial information that the sender wants to send
to the receiver.
Comments Comments are optional and not sent externally. You can add a ✓ ✓
comment for the people in your institution who further process
the message. (1)
(1) When an operator has added content in the Comments tab, and then validated or stored the message, the Comments tab
includes a * after the tab name. The * indicates that an operator has added comments.
All messages processed by Alliance Lite2 must comply with the Standards MT and Standards MX.
For more information, see Help about Message Standards on page 43.
07 December 2018 33
Alliance Lite2 Message Preparation
User Guide
The following graphic shows the possible message management steps for FIN or APC (MT 0_ _)
messages:
MT 0_ _
MT 999
D0540211
Text Modification
Overview
Message management includes the following steps:
1. Create a message
An operator creates a message manually through the Message Creation application in
Alliance Lite2. This creates an original instance of the message.
For more information, see Message Creation on page 72.
2. Route the message
An operator can take any of the following actions if the permissions in their operator profile
allow them to:
• Route a valid message to a queue that is defined in the routing rules.
• Move a message to a specific queue that the operator selects from the message editor. This
is called Dispose in Alliance Lite2.
• Close a message, and in this case the message is not saved.
To save a message for editing later, an operator can save it as a message template.
For more detailed information, see Message Queues on page 35.
3. Modify the message, if needed
Optionally, an operator can move messages to the Text Modification queue for editing later.
These messages can be modified through the Modification application in Alliance Lite2.
For example, you can move an invalid message to the Text Modification queue when you are
waiting for more information to include in the message.
4. Verify the message - only for MT and MX messages
07 December 2018 34
Alliance Lite2 Message Preparation
User Guide
In general, the creator of a message does not verify a message. Another operator verifies the
message and re-enters the values for the fields that require verification. These fields appear
empty when the verifier views the message. The values of fields in the original message must
match the values in the re-entered fields for the message to pass the verification successfully.
5. Authorise the message
An operator authorises a message by checking the message visually. Then, the authorised
messages are sent to the SWIFT network. Only operators with the appropriate profile can
authorise messages.
Note By default, the ACKs of messages created manually are automatically completed. This
messaging flow can be changed to have all the ACKs routed to the AutoClient
directory. See the Alliance Lite2 Service Description for more details about
configuration changes ("Appendix B").
Message queues
Alliance Lite2 holds a message instance in a message queue according to the current status of the
message.
The _MP_creation queue holds message templates, but Alliance Lite2 holds messages there for a
fraction of a second before routing the message instantaneously to the next queue.
You use the Creation, Modification, and Approval menus to process the messages in the
different queues.
07 December 2018 35
Alliance Lite2 Message Preparation
User Guide
If you cannot send a message to the next normal queue, then you can send it to the Text
Modification queue (_MP_mod_text). For example, you can send it to the Text Modification queue if
you do not have enough information to finish preparing the message. If Alliance Lite2 has a
problem with an input or output message and cannot process it, then the message is held in one of
several other modification queues. You can use the Modification menu to edit the messages in
these queues, to allow Alliance Lite2 to finish processing the messages.
Routing
Each message queue has a set of routing rules. These determine the default flow of messages
from one queue to the next. If needed, the routing rules can be changed to suit your institution.
An operator can move a message from one queue to another queue in the following ways:
• Send (dispose) a message to a queue. In general, you can select the required queue from a list
of available queues.
• Move a message to the Text Modification queue (_MP_mod_text) for editing later.
07 December 2018 36
Alliance Lite2 Message Preparation
User Guide
where Reference is either TRN or MUR (MUR can be empty). However, note that the UUMID will not
always be unique to a user, for example, if the user puts the same Reference twice in a single
message.
I/O This is a single-character direction indicator. "I" means an input message, that is, a
message input to the network specified within the message, from Alliance Lite2. "O"
- means an output message, that is, a message output from a network to Alliance
Lite2.
Correspondent This is 11 alphanumeric characters long and is the full BIC address of the sender or
receiver of the message. If no specific branch code is given, then the last 3
characters of the BIC address default to "XXX". For messages with a direction
indicator of "I", the BIC address identifies the receiver of the message. Where the
direction indicator is "O", it identifies the sender of the message.
MT For SWIFT format, this is always a 3-character number and refers to the message
type, for example, "100" for a customer transfer.
Reference This is the Transaction Reference Number (TRN) as given in field 20 of the
message. This reference may be up to 16 characters in length.
Suffix The suffix is a system-generated value that can help uniquely identify a message.
The first part is the creation date of the message in YYMMDD format, a six-digit
number. The second part consists of a 1-to-10 digit number that the system
generates. This number is incremental and unique for all messages.
07 December 2018 37
Alliance Lite2 Message Preparation
User Guide
Message Description
identifier
I/O This is a single-character direction indicator. "I" means an input message, that is, a
message input to the network specified within the message, from Alliance Lite2. "O"
means an output message, that is, a message output from a network to Alliance Lite2.
Correspondent Eleven-alphanumeric character long and is the full BIC8 address of the sender or the
receiver of the message plus "XXX". For messages with a direction indicator of "I", the
BIC address identifies the receiver of the message. Where the direction indicator is "O",
it identifies the sender of the message.
Message type Three-character number that indicates the message type. It is extracted from the
schema name or defaulted to "MX ".
Reference
Example: IGEBABEBBXXX007myref
Overview
Alliance Lite2 is responsible for formatting an MX message payload in an expanded form.
Payloads in UTF-8 encoding are accepted.
07 December 2018 38
Alliance Lite2 Message Preparation
User Guide
The expanded message is generated using the following conventions (indentation is two space
characters):
• Only printable US-ASCII characters below 127 appear. All other characters are replaced by a
full stop (.).
• CR, LF, and CR/LF are replaced by a new line.
• Tab is replaced by a space character.
• Lines are wrapped based on the maximum line length provided with the format API (typically
72). The wrapped line keeps the current indentation and is aligned with the text on the previous
line (that is, after the tag).
• A tag is never indented with more than 30 positions (nesting of 15 levels). If the tag goes deeper
than 15 levels, then only an indentation of 15 levels is used, and the indentation is only undone
upon the return to level 14.
• Start and end tags appear as follows:
- On one line if the field contained within the tags contains a value and no further subfields.
Line wrapping is as described above.
- The end tag on a new line and is aligned with the starting < character of the corresponding
start tag, if the field contained within the tags contains further subfields.
- Empty tags appear as one single tag ending with />.
• Tags that do not fit on one line are wrapped keeping the current indentation and are aligned with
the starting < character on the first line.
07 December 2018 39
Alliance Lite2 Message Preparation
User Guide
BICs in messages
ISO 9362 Business Identifier Codes (BICs) are used in certain fields of messages (for example,
field 53a, Sender's Correspondent, or field 59A, Beneficiary Customer) to identify a party in the
transaction.
When a BIC is available (for example, the party to be specified has been assigned a BIC), it should
be used whenever possible, as it is standardised and can therefore be automatically processed by
the receiver.
Both financial institutions and non-financial institutions can be identified with a BIC.
Related information
For more information on the BIC format and use of the BIC in SWIFT messages, see the BIC Policy
on swift.com.
PARTY PREFIX 4!a A 4-character code (BBBB) that identifies all instances of a
particular institution worldwide (this is sometimes referred to
as the BIC-4 address).
COUNTRY CODE 2!a A 2-character code (CC) that identifies a country in which an
institution operates (this, along with the Party Prefix, is
sometimes referred to as the BIC-6 address).
07 December 2018 40
Alliance Lite2 Message Preparation
User Guide
PARTY SUFFIX 2!c A 2-character code (LL) that identifies a particular location
within a country.
BRANCH IDENTIFIER [3!c] A 3-character code (BCD) that identifies a particular branch of
an institution in a particular location. In messages, if the
branch identifier is not known or not used, the characters
"XXX" are used instead.
If a BIC address is given without a branch identifier, then the eight characters, "BBBBCCLL",
uniquely identify a financial institution, at a particular location, within a particular country. This form
of address is called the "BIC-8" address for that institution and is identical to the institution's SWIFT
"destination address".
If a BIC address is given with a branch identifier, then the eleven characters, "BBBBCCLLBCD",
uniquely identify a particular branch of a financial institution at a particular location, within a
particular country. This form of address is called the "BIC-11" address for that institution. If a branch
is not known, or not used, then BIC-11 addresses may be expressed as "BBBBCCLLXXX".
Terminal code
During message preparation, the sender and receiver of a message are identified by their BIC-8 or
BIC-11 addresses. A further character, called a Terminal Code, is combined with the BIC to identify
the logical terminals used by the sender and the receiver of the message. The Terminal Code
occupies the ninth position of the BIC address (in front of the branch identifier):
"BBBBCCLLXBCD". The Terminal Code of the receiver defaults to "X" because the sender has no
way of knowing which logical terminal the receiver will use to receive the message.
07 December 2018 41
Alliance Lite2 Message Preparation
User Guide
Party prefix
Country code
Party suffix
Logical terminal code
Branch identifier
a a a a a a c c c c c c
1 2 3 4 5 6 7 8 9 10 11 12
SWIFT Destination
D0200002
Note: a = Letters only
c = Letters and digits only
Related information
For more information, see:
www.swift.com/bic
BIC Policy
07 December 2018 42
Alliance Lite2 Help about Message Standards
User Guide
For more information about MT Field Formatting Rules and characters for MT and MX messages,
click Help in the upper right-hand corner of the screen.
07 December 2018 43
Alliance Lite2 Help about Message Standards
User Guide
The following is an example of the message help for a FIN message, MT 103:
07 December 2018 44
Alliance Lite2 Help about Message Standards
User Guide
07 December 2018 45
Alliance Lite2 Help about Message Standards
User Guide
MX keywords
When you search for MX messages, you can provide values for the fields that are defined as MX
keywords. Alliance Lite2 provides a list that includes the identifier, keyword, and path information for
the messages within an MX standard. The information is based on the message standards that are
installed in the Alliance Lite2 database.
If the configuration parameter, MX Keyword Extraction is set to Off, then keywords are not
extracted from incoming MX traffic.
07 December 2018 46
Alliance Lite2 Help about Message Standards
User Guide
A link to a list of the MX keywords for all of the messages in a particular standard is available in the
following situations:
• You select an MX standard in the Standard field of the ID & Content tab of the Message
Search Criteria or the Report Search Criteria page.
The link is displayed next to the Message Name field.
• You view an MX message in the Message Details page.
The link is displayed next to the MX keyword text on the Header tab.
07 December 2018 47
Alliance Lite2 Help about Message Standards
User Guide
The format specifications are the rules for the layout of the message type. This information is
provided in table form as shown below:
----|
MT nnn (Message Type name) provides the message type number and name.
The table headings have the following meanings:
• Status indicates if the field is:
- M = Mandatory
- O = Optional - Network Validated Rules may apply
The status M for fields in optional (sub) sequences means that the field must be present if the
(sub)sequence is present, and is otherwise not allowed.
• Tag is the field identification.
• Field Name is the detailed name of the field tag, for this message type.
• Content/Options provides permitted field length and characteristics.
• No. identifies the number of the field in the Field Specifications for the message type. It is also
called Index.
Only fields and field tag options, which are shown in the message format, may be used in that
message type.
07 December 2018 48
Alliance Lite2 Help about Message Standards
User Guide
Some message formats are separated into sequences of fields, as shown below. An arrow
indicates that a sequence of fields may be repeated:
First sequence
---->
Second Sequence
----|
Third sequence
The arrows (----> and ----|) indicate that the second sequence may be repeated.
MT usage rules
Usage rules are not validated on the network, that is, no error code is defined for them, but are
nevertheless mandatory for the correct usage of the message. Rules specified in this section affect
more than one field in the message, or more than one SWIFT message.
07 December 2018 49
Alliance Lite2 Help about Message Standards
User Guide
should be aware that in addition to global market practices there may also be country-specific
requirements that should be considered when using the field or message type.
MT guidelines
Guidelines are not validated on the network and are not mandatory for the correct usage of the
message. They concern good practices. Guidelines specified in this section affect more than one
field in the message, or more than one SWIFT message.
MT field specifications
The rules for the use of each field in the message are specified in this section. Each field is
identified by its index number (as shown in the No. column of the MT format specifications), field
tag and detailed field name, followed by a description of the field.
The description may contain some, or all, of the following:
1. FORMAT specifies the field formats which are allowed in the field.
2. PRESENCE indicates if the field is mandatory, optional, or conditional in its sequence.
3. DEFINITION specifies the definition of the field in this sequence of the message type.
4. CODES lists all codes available for use in the field. If there is more than one subfield for which
codes are defined, each separate code list will be identified with a CODES heading. When a list
of codes is validated by the network, the error code will be specified.
5. NETWORK VALIDATED RULES specifies rules that are validated on the network, that is, rules
for which an error code is defined. Generally, rules specified in this section affect only the field
in which they appear. In some cases, rules which are validated at the message level, that is,
rules which affect more than one field, are repeated in this section. This is the case when the
rule does not affect the presence of the field, but information within several fields, for example,
a currency which must be the same for more than one field in the message.
6. USAGE RULES specifies rules that are not validated on the network, that is, rules for which no
error code is defined, but are nevertheless mandatory for the correct usage of the field. Rules
specified in this section affect only the field in which they appear.
7. EXAMPLES provides one or more examples of the field as it will be formatted/used.
Note For further information about the header and trailer, see the FIN Service Description
MT mapping
MT mapping explains how to map the fields of the message into another SWIFT message, either of
the same, or a different, message type.
MT example
Examples are provided to illustrate the correct use of a message.
Examples always include:
• narrative, which provides a brief description of a transaction
• information flow, which illustrates the relationships between the parties involved in the
message (see below diagram)
• SWIFT format, which provides the message using the defined SWIFT format, and providing an
explanation, where necessary, of the fields which have been used
The sender, receiver, and message type are summarily identified. Trailer contents are not shown.
Note For further information about the header and trailer, see the FIN Service Description.
07 December 2018 50
Alliance Lite2 Help about Message Standards
User Guide
Structure
Delimiter
Field tag number
Letter option
Delimiter
D0200005
: nn [a] :
Rules
Field structure must comply with the following rules:
• Each field is identified by a tag which consists of two digits, or two digits followed by a letter
option.
• Each field consists of a colon :, followed by a tag, followed by another colon :, and then the
field content.
• The following character restrictions apply to the field content:
- The field content must not start with a Carriage Return, Line Feed (CrLf).
- The field content must not be composed entirely of blank characters.
- Within the field content, apart from the first character of the field content, a colon : or hyphen
- must never be used as the first character of a line.
- The format of each field must comply with the standards. For more information, see the
Format Description of the field in the Message Help on Alliance Lite2. Alternatively, you can
view the format descriptions in the Standards MT General Field Definitions Plus, on
www.swift.com .
• Fields are separated by a 'Field Separator within Text' (CrLf).
• The first field in a message is preceded by a 'Start of Text' (CrLf:) and the last field in a
message is followed by an 'End of Text' (CrLf-).
• Field content may be composed of one or several subfields.
When subfields appear on separate lines, the Carriage Return, Line Feed (CrLf), which is not
included in the number of characters for the length of the subfield, serves as the subfield
separator.
Subfields:
- Subfields may themselves be of fixed or variable length.
- The order of subfields is fixed.
- When necessary, subfields are separated by special symbols, for example, / or //.
- Subfields must not be entirely composed of blank characters.
07 December 2018 51
Alliance Lite2 Help about Message Standards
User Guide
Restrictions on Length
07 December 2018 52
Alliance Lite2 Help about Message Standards
User Guide
Examples
2n up to 2 digits
07 December 2018 53
Alliance Lite2 Help about Message Standards
User Guide
6.5.2 Numbers
Format
nn...nn, nn...n
D0200006
Integer part
Usage rules
Wherever they represent a numeric value, numbers always take the same form:
• The integer part must contain at least one digit.
• Decimal points are not permitted. A decimal comma ',' shall precede the fractional part.
• The maximum length includes the decimal comma.
• The fractional part may be missing, but the decimal comma must always be present.
• Neither blank spaces, nor any symbols other than the decimal comma are permitted.
• The integer part is mandatory in the number component, and at least one character must
appear. Leading zeros are allowed.
• Normally, when a number represents an amount of money, the number of places following the
decimal comma may not exceed the number of decimal digits valid for the specified currency.
The specifications for the individual message types will indicate the fields where this is not the
case. Details regarding the allowable fractional parts for each currency code may be found in
the BIC Directory download file (CU***.txt file), which is available on www.swiftrefdata.com.
Examples
Valid Invalid
000,00 0000
0, 0
0,67 .67
0,25 ,25
100000, 100.000
25768, 25-768
99999999, 999.999.999
100, 100
10500,00 10500.00
5,25 5 1/4
07 December 2018 54
Alliance Lite2 Help about Message Standards
User Guide
Description
A currency code must be a valid ISO 4217 currency code, which normally consists of a two-letter
ISO country code followed by a third letter denoting the particular currency or type of funds.
Where:
Rules
When the party identifier is present, the following rules apply:
• The party specified in the field with the account must be the account owner. The optional party
identifier must specify the account known to the account servicing institution.
• Extreme care must be taken when formatting the party identifier, for example, when only
subfield 2 '[/34x]' is entered, and its first and third characters consist of '/', the system can only
presume that both subfields 1 and 2 are present. It will then qualify the second character for
either code 'C' or 'D', and NAK the message if one or the other is not present (Error code T51).
07 December 2018 55
Alliance Lite2 Help about Message Standards
User Guide
Additional rules
The following additional rules apply:
• An account specified in field 58a or 59a must be owned by that party and must be serviced by
the financial institution in field 57a or, if field 57a is absent, by the receiver.
• An account specified in field 57a must be owned by that party and must be serviced by the
financial institution in field 56a or, if field 56a is absent, by the receiver.
• An account specified in field 56a must be owned by that party and must be serviced by the
receiver.
• In field 53a, when an account is used it normally indicates:
- which account is to be used for reimbursement, if multiple accounts in the currency of the
transaction are serviced for the other party. In this case, the account should be specified
- whether the sender's account serviced by the receiver, or the receiver's account serviced by
the sender, is to be used for reimbursement, if they both service accounts for each other in
the currency of the transaction. In this case, the account to be debited or credited shall be
indicated in the party identifier by either the code /C or /D, or the account, or both
In both cases, this information should be specified in field 53a with the format option B (party
identifier only).
Examples
Valid Invalid
:53A:/C/12-12 :53A:/6/12-12
CITIUS33CHI CITIUS33CHI
:53B:/D/24-24 :53B:/A/24-24
:53D:/52/48-48 :53D:/:/48-48
John Doe John Doe
122 Peyton Place 122 Peyton Place
Elyria, OH 22216 Elyria, OH 22216
:87E:FREE :87E:APMT
/C/12-12 /A/12-12
CHASUS33 CHASUS33
:87F:APMT :87F:APMT
/D/12-12 /:/48-48
John Doe John Doe
122 Peyton Place 122 Peyton Place
Elyria, OH 22216 Elyria, OH 22216
07 December 2018 56
Alliance Lite2 Help about Message Standards
User Guide
Example
Bank A in New York services an account in USD for Bank B in London. Bank B also services, in
London, a USD account (number 567-3245-01) for Bank A.
Bank A sends a USD transfer to Bank B, using its USD account in London, serviced by Bank B, for
reimbursement. Bank A will request that Bank B debit its account in London as follows:
53B:/D/567-3245-01
Note In certain message types, there are exceptions to the rules for use of the party
identifier detailed in this section, for example, field 57a in category 3 messages. In
those cases, the intended use of the party identifier is described in the relevant field
specification for the message type.
[/34x] (Account)
Definition
Name and address of the party, with an optional account.
Usage rules
If Account is absent, then Name and Address must not start with a slash '/'.
Definition
Identifier code such as a BIC. Optionally, the account of the party.
07 December 2018 57
Alliance Lite2 Help about Message Standards
User Guide
Examples
The following example shows BICs of non-connected users, without, and with, a branch identifier:
:53A:CHBAKHH1
:54A:CHBLGB21BBB
[35x] (Location)
Usage rules
When used, at least one line must be present.
An account number only, not followed by any other identification, is allowed (field 53a).
For field 52a, the field specifications for individual message types specify whether this option
identifies a branch of the sender or the receiver.
In field 53a, this option specifies either the account to be debited or credited, or a branch of the
sender, that is, of the financial institution specified in the sender's address in the header.
In fields 54a and 57a, this option specifies a branch of the receiver, that is, of the financial
institution specified in the receiver's address in the header.
07 December 2018 58
Alliance Lite2 Help about Message Standards
User Guide
/34x (Account)
Definition
A code uniquely identifying an account and/or party.
In the MTs 101, 102, 102 STP, 103, 103 REMIT, 103 STP, and 104, clearing codes may be used.
Definition
Name and address and, optionally, the account or clearing code of the party.
Usage rules
When the party identification is provided by name and address (whether by full postal address or
informal identification), the following rules apply:
• at least one line of the name and address must be present, in addition to the party identifier
• the street address must be on a new line following the name
• when a city is present, it must be on the last line, with the postal code (zip, etc.), state and
country identification
Although more than one element of an address may appear on each line, care should be taken
that, when possible, no element, for example, street address, should be spread over more than one
line.
If a Party Identifier is absent, then Name and Address must not start with a slash '/'.
07 December 2018 59
Alliance Lite2 Help about Message Standards
User Guide
In some messages, some of these clearing codes may also be used with option A, that is, the MTs
101, 102, 102 STP, 103, 103 REMIT, 103 STP, and 104. This is indicated with the field
specifications of each message type.
When one of the codes //FW (with or without the 9-digit number), //AU, //CP or //RT is used, it
should appear only once, and in the first of the fields 56a and 57a of the payment instruction.
When it is necessary that an incoming SWIFT payment be made to the party in this field via
Fedwire, US banks require that the code FW appears in the optional Party Identifier.
07 December 2018 60
Alliance Lite2 Help about Message Standards
User Guide
When it is necessary that an incoming SWIFT payment be made to the party in this field via a real-
time gross settlement system (RTGS), the code RT should appear in the optional Party Identifier.
Option D must only be used in exceptional circumstances, that is, when the party cannot be
identified by a BIC, and when there is a bilateral agreement between the sender and the receiver
permitting its use. Unless qualified by a clearing system code or an account number, the use of
option D may prevent the automated processing of the instruction(s) by the receiver.
07 December 2018 61
Alliance Lite2 Help about Message Standards
User Guide
• The Portuguese National Clearing code is defined by the Banco de Portugal. Its structure is 4!
n4!n, where:
- 4!n = Bank Code (IFRI), potentially containing leading zeros
- 4!n = Branch Code (BLCI) which is unique for each branch and locally assigned by the
Financial Institution
• The Russian Central Bank Identification Code is to be considered as one, uniform, indivisible
code. Its structure is 2!n2!n2!n3!n, where:
- 2!n = Country Code. The first position is always 0 and is not shown in the database of the
Central Bank of Russia.
- 2!n = Region Code within the country
- 2!n = Code of the division of the Central Bank in the region
- 3!n = Bank Code
• The South African National Clearing code is defined by BankServ, the South African Bankers
Services Company Ltd. Its structure is 3!n3!n, where:
- 3!n = Bank Code, potentially with leading zeros
- 3!n = Branch Code, potentially with leading zeros
• The Spanish Domestic Interbanking Code is the identification scheme defined by CCI (Centro
de Cooperacion Interbancaria). Its structure is:
- 4!n = Bank Code
- 4!n = Branch Code
- [1!n] = Check Digit
Or
07 December 2018 62
Alliance Lite2 Help about Message Standards
User Guide
Or
Definition
Name and address in a structured format to facilitate straight through processing.
Codes
When Party Identifier is used with the (Code)(Country Code)(Identifier) format, for example in field
50F Ordering Customer, one of the following codes must be used:
ARNU Alien Registration Number The code followed by a slash, '/' must be followed by the
ISO country code, a slash, '/' and the Alien Registration
Number.
CCPT Passport Number The code followed by a slash, '/' must be followed by the
ISO country code, a slash, '/' and the Passport Number.
CUST Customer Identification Number The code followed by a slash, '/' must be followed by the
ISO country code of the issuer of the number, a slash, '/',
the issuer of the number, a slash, '/' and the Customer
Identification Number.
DRLC Driver's License Number The code followed by a slash, '/' must be followed by the
ISO country code of the issuing authority, a slash, '/', the
issuing authority, a slash, '/' and the Driver's License
Number.
EMPL Employer Number The code followed by a slash, '/' must be followed by the
ISO country code of the registration authority, a slash, '/',
the registration authority, a slash, '/' and the Employer
Number.
NIDN National Identity Number The code followed by a slash, '/' must be followed by the
ISO country code, a slash, '/' and the National Identity
Number.
SOSE Social Security Number The code followed by a slash, '/' must be followed by the
ISO country code, a slash, '/' and the Social Security
Number.
07 December 2018 63
Alliance Lite2 Help about Message Standards
User Guide
TXID Tax Identification Number The code followed by a slash, '/' must be followed by the
ISO country code, a slash, '/' and the Tax Identification
Number.
Codes
On each line of Name and Address, subfield Number must contain one of the following values
(Error code(s): T56):
1 Name of the Ordering Customer The number followed by a slash, '/' must be followed by the
name of the ordering customer.
4 Date of Birth The number followed by a slash, '/' must be followed by the
date of birth in the YYYYMMDD format.
5 Place of Birth The number followed by a slash, '/' must be followed by the
ISO country code, a slash '/' and the place of birth.
6 Customer Identification Number The number followed by a slash, '/' must be followed by the
ISO country code of the issuer of the number, a slash, '/',
the issuer of the number, a slash, '/' and the customer
identification number.
7 National Identity Number The number followed by a slash, '/' must be followed by the
ISO country code, a slash, '/' and the national identity
number.
07 December 2018 64
Alliance Lite2 Help about Message Standards
User Guide
Usage rules
• In subfield 2: Numbers 1, 2, and 3 may be repeated.
• In subfield 2: if number 2 is present, the first occurrence of number 3 must include the town in
additional details.
For ordering customer:
• Subfield 1 (Party Identifier) used with the (Code)(Country Code)(Identifier) format: if additional
space is required for providing the Identifier of the ordering customer, one of the following
options must be used:
07 December 2018 65
Alliance Lite2 Help about Message Standards
User Guide
- First option (preferred): Identify the ordering customer with a different identifier where the
length is not an issue.
- Second option: Continue the information in subfield 2 (Name and Address) using number 8.
• Subfield 2 (Name and Address): if additional space is required for providing the Customer
Identification Number (number 6) or the National Identity Number (number 7) of the ordering
customer, one of the following options must be used:
- First option (preferred): Identify the ordering customer with a different identifier where the
length is not an issue.
- Second option: Continue the information in subfield 2 (Name and Address) using number 8.
/34x (Account)
Definition
Identifier code of the party with mandatory account number.
/34x (Account)
Definition
Name and address of the party with a mandatory account.
07 December 2018 66
Alliance Lite2 Help about Message Standards
User Guide
5*40x (Narrative)
Definition
Identification of the party.
Codes
The following codes can be used with this option. Depending on the field tag and message type,
some codes may or may not be used, may exclude each other or not, or may be mandatory or not:
/CITY/ 35x city followed by the name of city (and state, country)
The codes do not need to be put on separate lines. It is the '/' at the beginning of a code, not the
end-of-line, that marks the end of the information behind the previous code.
As a result, the narrative following the code may not contain a slash '/'. The end-of-line may be part
of the narrative text following the code, but it is to be ignored when reading the field. However, the
end-of-line may not be part of the code.
Examples
/ABIC/BNKAXA11/NAME/BANK A OF XANADU(CrLf)
/NAME/BANK A OF XANADU/ABIC/BNKAXA11(CrLf)
/ABIC/BNKAXA11(CrLf) /NAME/BANK A OF XANADU(CrLf)
07 December 2018 67
Alliance Lite2 Help about Message Standards
User Guide
/ABIC/BNKAXA11/NAME/BRANCH B OF THE(CrLf)
SECOND NATIONAL BANK A OF XANADU(CrLf)
[/34x] (Account)
Definition
Name and address of the party, with an optional account.
Usage rules
If Account is absent, then Name and Address must not start with a slash '/'.
35x (Narrative)
Definition
Identification of the party
07 December 2018 68
Alliance Lite2 Help about Message Standards
User Guide
Definition
Identification of the party, with a qualifier and an identifier code such as a BIC.
Definition
Identification of the party, with a qualifier and name and address.
Definition
Identification of the party, with a qualifier, issuer code and proprietary code.
Definition
Identification of the party, with a qualifier, an optional issuer code, type of ID, country code and
alternate ID.
07 December 2018 69
Alliance Lite2 Help about Message Standards
User Guide
Definition
Identification of the party, with a qualifier and name.
Definition
Identification of the party, with a qualifier and names.
6.5.5 Times
Formats
4!n
6!n
Rules
Times are represented as either four or six digit integers, that is, in form HHMM or HHMMSS
respectively, where (Error code T38):
• H = Hour
• M = Minutes
• S = Seconds
No blank spaces or other characters are permitted.
Examples
0000
1200
235959
07 December 2018 70
Alliance Lite2 Help about Message Standards
User Guide
Example
ACKed NAKed
:32A:601130USD1, :32A:611130USD1,
:30:801130 :30:791130
For the purpose of value date ordering, if there is more than one value date field in a message, the
lesser date will be selected:
MTxxx
In this example, field 30 Value Date (18 December 1995) is selected for value date ordering of the
message. Error code T50 is returned after an invalid value date.
07 December 2018 71
Alliance Lite2 Message Creation
User Guide
7 Message Creation
Overview
You can create a message from scratch, from a message template, or from an existing message.
You create messages according to the permissions defined in your operator profile, including any
restrictions limiting the message types, currencies, or amounts.
Message editor
Messages are created in Alliance Lite2 through a message editor. The message editor is a form
with tabs which display the mandatory and optional fields that must be completed with information
by the sender or the requestor.
The forms for creating and editing FileAct message manually differ slightly from the form for
creating and modifying FIN, APC, and MX messages.
SWIFT gpi
In the scope of gpi, the different parties involved in a payment transaction pass on a unique end-to-
end transaction reference across the different messages and processing agents, allowing all agents
in the chain to keep track of the status of the transaction at any time.
For this purpose two new fields have been added to block 3 of FIN messages:
• Field 111 Service type identifier – a new field in FIN block 3
• Field 121 Unique end-to-end transaction reference – also known as UETR – a new field in
FIN block 3
Note Banks in the SWIFT gpi Closed User Group (CUG) are able to track payments
based on the UETR.
1. Support of gpi fields in the Alliance Lite2 GUI
gpi fields are supported to allow message creation and modification. A Generate button is also
available next to the Field 121 in order to create the “unique end-to-end transaction reference”
that will respect the format.
It is important to note that the gpi fields will be displayed to all Alliance Lite2 customers, even if
they are not registered as a gpi bank.
Note Banks not registered in SWIFT gpi Closed User Group (CUG) are not allowed to
send gpi payments with these new fields.
2. All banks must be capable of receiving gpi fields in the Block3 Header of the MT103
As mentioned above, the usage of Block3 fields 111 or 121 has previously been restricted to
SWIFT gpi participants.
SWIFT gpi participants must be able to include these header fields in all MTs 103, MTs 103
STP and MTs 103 REMIT that they send, including to those banks that are not in the CUG.
This will allow the gpi Tracker to track a gpi payment up to the first bank outside of the SWIFT
gpi Closed User Group (CUG).
Note Banks not registered in the CUG must be able to receive the gpi header fields.
They will not be able to send or forward these messages.
07 December 2018 72
Alliance Lite2 Message Creation
User Guide
SWIFT recommends all Alliance Lite2 customers who automate their FIN flows with their back-
office to check back-office compatibility with their back-office application providers.
Overview
The FIN Message: New page allows you to select the sender logical terminal, the FIN category,
and the message type.
07 December 2018 73
Alliance Lite2 Message Creation
User Guide
Page example
The following is an example. The list of standards that are installed in your institution may differ:
Page description
Sender Logical The logical terminal that you want the message to be sent from. You can
Terminal only send a message from a logical terminal that is licensed for your
installation and allowed by your profile. The value selected in Sender
Logical Terminal determines the message syntax version to use.
FIN Category You can select a message category from the ones that are available. The list
also includes the names of the message categories from the installed
MyStandards packet, if applicable. Each category contains only the
messages that you are allowed to create (as defined in your operator profile).
Description Text that explains the business purpose of the message type.
Version The message syntax version assigned to the logical terminal selected.
07 December 2018 74
Alliance Lite2 Message Creation
User Guide
Note If you select a Sender Logical Terminal ending in X, then the default syntax when
creating and validating the message will be used. If this syntax is different from the
installed version of a FIN message standard, you will be unable to see all of the
FIN category.
3. Select the appropriate message category in the FIN Category drop-down list.
The value entered for the FIN Category field by an operator when creating a FIN message is
automatically saved. It is proposed as the initial value when the same operator creates another
FIN message using the above GUI.
The list of message types available in the selected category appears.
4. Select a message type from that list.
The message editor appears and displays the fields that are appropriate for that message type.
The Header tab is selected by default.
Save as Template Saves the information in the message as a Create a Template for FIN, APC,
template. Then, you can close the message, or MX Messages on page 85
or perform another action.
New Fast With this mode, you can choose how tags Fast Mode on page 93
are displayed when creating messages,
either All Tags or Mandatory Tags.
Fast / Prompted Allows you to create the body of an MT Fast Mode on page 93
message in fast or prompted mode.
07 December 2018 75
Alliance Lite2 Message Creation
User Guide
Procedure
1. In the Sender part, select a unit from the Unit drop-down list. This is the unit to which the
message is assigned.
The value entered for the Unit field by an operator when creating a FIN message is
automatically saved. It is proposed as the initial value when the same operator creates another
FIN message.
2. The Sender Logical Terminal field shows the logical terminal that you have selected in the
previous page.
3. Click Type to select the type of correspondent sending the message: Institution, Department,
or Individual. If you select Department or Individual, then extra fields appear so that you can
enter additional details.
4. The Institution field displays the sender institution BIC8 corresponding to the logical terminal
as a read-only value before the input area for the branch code. Select the branch code from the
drop-down list.
5. If the correspondent Type is Department or Individual, then complete the extra fields so that
the Department or Individual is clearly identified. The combination of details in the Institution
field and these other fields make up a Full Name which uniquely identifies the correspondent.
6. In the Receiver part, you can specify that the message is sent to an alias provided the alias is
defined in the Correspondent Information File. The package is used to define aliases for
correspondents. An alias is an alternative name for one or more correspondents.
If you select Alias, then select an alias name in the field that appears. If the alias is for a group
of correspondents, then the message type must be MT 999. The message is broadcast to the
group of correspondents. If the alias represents only one correspondent then there is no
restriction on the message type.
7. Click Type to select the type of correspondent receiving the message: Institution,
Department, or Individual. If you select Department or Individual, then extra fields appear so
that you can enter additional details.
8. In the Institution field, provide the BIC11 address of the Receiver correspondent. This is
usually a BIC11 address for an external correspondent, that is, one not owned by your
organisation, and so having a different BIC11 to your organisation. It can, however, be an
internal one.
If a record exists for this BIC11 address in the CIF, then Alliance Lite2 displays the address
details. If the BIC is not found in the CIF, then the Address Expansion fields remain empty. It is
possible that the BIC is not yet included in the CIF. If Alliance Lite2 does not display values in
07 December 2018 76
Alliance Lite2 Message Creation
User Guide
the Address Expansion fields, then you can type the data yourself, although this is not
mandatory.
The validation of existing RMA is performed when you fill in the message receiver data.
9. If you specified the correspondent Type as Department or Individual, then you must complete
the extra fields.
10. In the Options part, complete the FIN Copy field if you use the FINCopy service. From the
drop-down list, select the FINCopy service corresponding to the central institution destination
that you want to copy the message to.
FIN Copy is shown only for relevant message types according to the sender LT and the
FINCopy profiles that are installed on Alliance Lite2.
11. In the Options part, click Priority to select the priority of the message on the network.
12. From the Monitoring list, select an option for monitoring the delivery of the message:
• For messages with normal priority
None for no monitoring
• Delivery or delivery notification
SWIFT sends an MT 011 (delivery notification) to you after the message has been delivered to
your correspondent.
SWIFT sends an MT 010 (non-delivery warning) if the message is not delivered to your
correspondent within a fixed period.
13. Select Yes in the User PDE field if you suspect that the message that you are creating was
sent previously. Otherwise you can leave the field empty. By default, messages are sent without
a Possible Duplicate Emission trailer.
14. In the Banking Priority field, type a priority with which your correspondent must process the
message. This field is optional. Any value that you enter in this field must be agreed with the
correspondent in advance.
15. In the MUR field, enter a message user reference of 16 alphanumeric characters maximum.
This field is optional. How the reference is derived and how it is used is for individual
organisations to decide.
07 December 2018 77
Alliance Lite2 Message Creation
User Guide
Fast mode
If you are an experienced operator, and you are familiar with message syntax, then you can also
complete the body of the message in fast mode.
For more information, see Fast Mode on page 93 and Structure of Fields in FIN Messages on
page 51.
Procedure
1. Complete all mandatory fields.
2. Complete any optional fields as needed.
Related information
Fast Mode on page 93
07 December 2018 78
Alliance Lite2 Message Creation
User Guide
Overview
The MX Message: New page allows you to select the message standard and the message.
Page example
Page description
Standard Each MX standard groups the messages used within a particular Solution. The
list also includes the names of the message groups from the installed
MyStandards packet, if applicable.
07 December 2018 79
Alliance Lite2 Message Creation
User Guide
Save as Template Saves the information in the message as a Create a Template for FIN, APC,
template. Then, you can close the message, or MX Messages on page 85
or perform another action.
Fast / Prompted Allows you to create the body of an MX Fast Mode on page 93
message in fast or prompted mode.
07 December 2018 80
Alliance Lite2 Message Creation
User Guide
Note An error in either the Requestor DN or the Responder DN field prevents you from
routing or disposing the message, even to the Text Modification queue.
Alliance Lite2 creates and maintains a Last Used DN store. Each time a DN is
successfully used for a message, the entry corresponding to the type of DN, operator,
service, and DN itself is created or updated. Therefore, when you create a message,
the DN can be selected from the drop-down list in the message header.
Procedure
1. Select a unit from the Unit drop-down list. This is the unit to which the message is assigned.
Only operators belonging to the same unit are able to access the message.
The value entered for the Unit field by an operator when creating a MX message is
automatically saved. It is proposed as the initial value when the same operator creates another
MX message.
2. Complete the Requestor DN field, or select it from the drop-down list. It must be a valid DN
and must contain a BIC8 which is an allowed sender destination according to your operator
profile. The BIC8 must be an internal correspondent for the Alliance Lite2 instance.
Note The Requestor DN and Responder DN fields may already contain default values
configured during the installation of the message standards.
3. Complete the Responder DN field, or select it from the drop-down list. If REACHPLUS has
been installed, you can also use the DN picker to select the DN from BICs and Other Codes.
4. If the message is going to a service that is not the live one, then type the relevant characters
after ! next to the Service Name field (for example, "p" for a pilot service). The service name
entered is subject to operator permission as defined in the operator profile.
5. Complete the User Ref field (optional).
6. Click Priority to select the priority of the message on the network. Select Normal for a normal
priority message or Urgent for urgent messages. The default value is Normal. If no delivery
criteria are specified, then messages with urgent priority are delivered before messages with
normal priority.
7. Signed field. You can select Yes or No, or leave the field empty.
The default value depends on the application service profile.
8. Non-Repudiation field. You can select Yes or No, or leave the field empty.
The default value depends on the application service profile.
Note This is not related to the signing of messages as discussed in section Message
Authorisation Page on page 127 and section Authorise a Message on page 131.
9. The Delivery Mode field is unavailable and shows the delivery mode of the message being
created.
10. The Possible Duplicate field is used to warn the receiver that some special handling may be
required for the message (for example, the message was already delivered by SWIFT or was
sent before). You can select Yes or No.
11. Notification Required field (only for messages sent using store-and-forward delivery). You can
select Yes or No, or leave the field empty.
12. SWIFTNet Copy field (only for messages sent using store-and-forward delivery). You can
select Yes or No. The default value depends on the application service profile.
13. Third Party DN (only if available for the selected service as defined by the application service
profile). The possible values are retrieved from the application service profile.
07 December 2018 81
Alliance Lite2 Message Creation
User Guide
14. Authorisation Notification Required (only for messages sent using store-and-forward
delivery for a Y-Copy service). You can select Yes or No. The default value depends on the
application service profile.
15. Overdue Warning Time field (only for messages sent using store-and-forward delivery). You
can select time in UTC after which store-and-forward must generate an overdue warning if the
message remains undelivered.
16. Overdue Warning Delay field (only for messages sent using store-and-forward delivery). You
can select the number of minutes after which store-and-forward must generate an overdue
warning if the message remains undelivered (min 5, max 1440).
07 December 2018 82
Alliance Lite2 Message Creation
User Guide
07 December 2018 83
Alliance Lite2 Message Creation
User Guide
To create FIN or MX messages only from an approved locked template, your operator profile must
have this action:
Mesg Creation / Create Message with the From locked templates only detail set to Yes.
This means that you will not have permission to create FIN or MX messages from scratch, or from
other messages, or from normal templates.
When a template is created, Alliance Lite2 verifies that if a subfield is locked then the parent field
must be locked as well. If this verification fails, then an error message is displayed and the locked
template cannot be saved. The same error message is displayed if the template fails validation
because of this issue.
To approve a locked template, the security parameter Mesg Templ Approval must be turned on.
CAUTION All locked mandatory fields must be completed when creating a locked template,
otherwise the message created from the locked template will be unusable, as the
fields will no longer be modifiable (messages with empty mandatory fields will always
be rejected).
When modifying a locked template, a checkbox next to each field or subfield is selected if the field
is locked, and cleared if the field is unlocked.
After a locked template is created or modified, the Approved/Not Approved status can be viewed
only if the security parameter Mesg Templ Approval is turned on. Then messages from locked
templates can be created ONLY if the template status is Approved.
Approving a locked template can only be done by an operator different than the one that created or
modified it. This second operator must have the Mesg Creation / Add/Mod/Rem Template with
the Locked detail set to Yes.
07 December 2018 84
Alliance Lite2 Message Creation
User Guide
Page example
Page description
Filtering criteria Enables you to filter the list of message templates according to various
area criteria. For details, see Filter a List of Message Templates on page 88.
Open by If a message template has an operator name in the Open by column, then
this means that operator is currently modifying the message template.
Sender Identifies the sender BIC used for this message template.
Usage Count The total number of times that the template has been used to manually build
a message.
Last Usage The timestamp (in the local time of the browser) when the template was used
to manually build a message.
Creation Date/ The date and time when the template was created.
Time
07 December 2018 85
Alliance Lite2 Message Creation
User Guide
Tip When you create a message template, you can also open other menu items
(messages) at the same time from the Creation, Modification, Approval, and Search
and Report menus.
Before you begin
To add a message or file template using the Message Creation application:
The User MT, System MT, or APC MT of the FIN/APC message template, the Service&Identifier of
the MX message template, or the Service&Identifier of the File message template must be checked
to be explicitly allowed or not explicitly prohibited by the following permission detail of your operator
profile:
• Mesg Creation, Add/Mod/Rem Templ
• User MTs
• System MTs
• APC MTs
• Service&Identifier - MX messages
• Service&Identifier - File messages
Procedure
1. Follow the steps to create a new message.
For MX messages, ensure that you have entered values for the Requestor DN field and the
Responder DN field.
2. After you enter the message details, click Save as Template .
The Save as Template page appears, and prompts you to enter a name for the message
template.
3. Type the name of the message template. This name identifies the template and appears in the
list of message templates.
Message template names must comply with the following requirements:
• The name must contain a maximum of 31 characters.
• The following characters are permitted: A-Z, a-z, 0-9, and special characters, except for
single and double quotation marks.
• Spaces are allowed.
• The first character can be a space, or any of the letters, numbers or characters mentioned
previously.
Note It is possible to add a message template with a name that is already used. The
existing and the new message templates coexist with the same name.
4. Click Save .
A confirmation message appears in the Status area, to confirm that the template was saved.
A FIN or APC message template includes the sender logical terminal and the message type the
operator had selected when the template was created. An MX message template includes the
identifier of the message standard that was selected when the operator created the template.
An MX messages template also includes the requestor DN and the responder DN.
5. You can continue to edit the message, send the message for further processing, or close the
message.
07 December 2018 86
Alliance Lite2 Message Creation
User Guide
07 December 2018 87
Alliance Lite2 Message Creation
User Guide
Table of actions
Report Creates a report of the message. Report Types and Settings on page
23
Save as Template Saves the information in the message as a Create a Template for FIN, APC, or
template. Then, you can close the message, MX Messages on page 85
or perform another action.
New Fast With this mode, you can choose how tags are Fast Mode on page 93
displayed when creating messages, either All
Tags or Mandatory Tags.
Unlock Allows you to unlock the message, if your Locked Message Templates on
operator profile detail Mesg Creation / page 83
Create Message with the From locked
templates only detail is set to No.
Fast / Prompted Allows you to create the body of an MT or MX Fast Mode on page 93
message in fast or prompted mode.
07 December 2018 88
Alliance Lite2 Message Creation
User Guide
Procedure
1. From the Message Creation menu, select one of the following options:
• FIN Message: Templates
• APC Message: Templates
• MX Message: Templates
The list of message templates available appears. For more information, see Message
Templates Page on page 84.
2. Define the criteria to use to filter the list of message templates based on the following
information:
• Template Name
You can use the following wildcards in the Template Name field:
- "_", to replace one unknown character
- ''%'', to replace zero, or one or more contiguous unknown characters
• Match Case (applies only to the value provided for template name)
• Created by (name of the operator who created the template)
• Modified by (name of the last operator who modified the template)
• Usage Count use the symbols <, <=, =, >=, > to specify the number of records you
want to display
• Last Usage
- From Date use the date picker provided to choose the date
- To Date use the date picker provided to choose the date
3. Click Submit .
The list of templates is filtered according to the selected criteria.
07 December 2018 89
Alliance Lite2 Message Creation
User Guide
Procedure
1. From the Message Creation menu, select one of the following options:
• FIN Message: Templates
• APC Message: Templates
• MX Message: Templates
The list of message templates available appears. For more information, see Message
Templates Page on page 84.
2. Select the check box beside the name of the message template that you want to modify.
If needed, navigate through the pages or refine the list using filtering criteria. For more
information, see Filter a List of Message Templates on page 88.
3. Click Modify .
The message entry form appears and the title of the window includes Edit Template.
When an operator modifies a message template, the operator's name appears in the Open by
column of the message template list to show that the template is being modified.
4. Change the values in the template, as required.
When modifying a locked template, a checkbox next to each field or subfield is selected if the
field is locked and unselected if the field is unlocked.
5. Any data which appears in the message entry form can be modified except the MX message
fields that follow:
• Service Name
You can add extensions to the service name, if required (and if allowed by your operator
permissions).
• Identifier
• Delivery Mode
6. Next, take the appropriate action in the following table.
Table of actions
Report Creates a report of the template. Report Types and Settings on page
23
New Fast With this mode, you can choose how tags are Fast Mode on page 93
displayed when creating templates, either All
Tags or Mandatory Tags.
07 December 2018 90
Alliance Lite2 Message Creation
User Guide
Approve Allows you to approve the locked template, if Locked Message Templates on
the security parameter Mesg Templ page 83
Approval is turned on, and if you are not the
last modifier of the template.
Fast / Prompted Allows you to create the body of an MT or MX Fast Mode on page 93
message in fast or prompted mode.
07 December 2018 91
Alliance Lite2 Message Creation
User Guide
07 December 2018 92
Alliance Lite2 Message Creation
User Guide
07 December 2018 93
Alliance Lite2 Message Creation
User Guide
Note You can enter some fields in fast mode only. For more information, see Knowledge
Base tip 5020378 (in regard to field 22C).
Field syntax
For each FIN or MX message, the message structure, syntax, field options, and code words must
be used when you edit a message in fast mode. These are detailed in the User Handbook, and in
the help for messages. For more information, see Help about Message Standards on page 43. You
can also find information about the character sets through the help link on the top right corner of
the message editor form.
When typed in fast mode, the on-screen appearance and format of a message text must be the
same as the various examples detailed in the Standards books.
07 December 2018 94
Alliance Lite2 Message Creation
User Guide
A field can consist of several subfields. Each new line is a continuation of the field defined in the
first line. Some fields have alternative sets of subfields, with each alternative identified by an option
letter after the field tag. For example, 32A and 32B
Subfields can be of fixed or variable length. A field with two fixed length subfields (date, currency),
and one variable length subfield (amount), looks like this:
:32A:040528EUR1958,47
A field with variable length subfields must have "/" as a separator between each subfield is like:
:22:NEW/BEBEBB1831CRESZZ
Note In field 22, the application only checks the syntax of subfield 2. Make sure that the
semantic content is correct.
Where a message consists of a defined set of sequences, type each sequence of fields in the order
in which they must appear in the message. Do no use / as a separator in this case.
Where a field, or series of fields, is repeated in the form of a loop, type the fields for each loop and
repeat the fields as required. Do no use / as a separator in this case.
Example - MX message
Some fields, such as field 72, contain more than one line. A typical multiple line field looks like:
:72:SWIFT
Avenue Adèle 1
La Hulpe
Belgium
07 December 2018 95
Alliance Lite2 Message Creation
User Guide
The invalid field is identified using a different colour (as defined in the Preferences. (For
information about changing the colour, see Change the Preferences on page 24.)
Note Warnings do not prevent a message from being routed within Alliance Lite2.
2.
Here is an example of a validation report:
Tip You can navigate between the Validation Report and the message tabs.
3. Click the error or warning in the Validation Report tab that you want to address, to move directly
to the field.
Complete the field correctly.
07 December 2018 96
Alliance Lite2 Message Creation
User Guide
For example, a box indicates that this is the second of a total of two errors or warnings.
Use the up and down arrows in the rectangle to move directly to the previous or the next
occurrence, without returning to the Validation Report.
Tip You can click the name of the message to view the help about the expected
content of the fields in the message.
4. If a message has many errors, then all or part of the message may be displayed in fast mode.
For more information about how to use fast mode, see Fast Mode on page 93
You can return to prompted view when the message is valid.
5. Click Validate to check that the message is correct.
The Validation Report shows errors and warnings that remain.
6. If you cannot correct all the errors in a message, then you can take one of the following steps:
• Select Text Modification from the drop-down list next to Dispose to .
This moves the message to the Text Modification queue, where it can be edited later. See
Send a Message to a Queue (Dispose to) on page 99.
• Click Close Message , to discard the message. A draft of the message is not saved.
07 December 2018 97
Alliance Lite2 Message Creation
User Guide
Alliance Lite2 validates the syntax of a message when an operator clicks Validate , Fast , Route , or
Dispose to .
Alliance Lite2 can also display a warning if there is no business relationship (RMA authorisation)
between the sender and the receiver.
Validation of MX messages
For MX messages, the Message Validation (MVal) processing can fail in case of errors or because
of problems with semantic checks. Responses from that processing are included in the emission
appendix.
Alliance Lite2 performs a basic validation of the XML structure of the payload in an MX message.
The validation checks the following:
• The size of an InterAct XML payload does not exceed 100,000 bytes.
• The InterAct XML payload has a structure that is compliant with the Standards MX.
07 December 2018 98
Alliance Lite2 Message Creation
User Guide
07 December 2018 99
Alliance Lite2 Message Creation
User Guide
Procedure
1. From the message editor, select the queue that you want from the drop-down list next to
Dispose to .
Queue Description
Text Modification This queue holds messages that need data modification or data correction.
You can dispose a message to the Text Modification queue if you have not
finished creating it (for example, due to a lack of information, or if it is invalid)
and want to save it in its current state.
For MX messages, you cannot dispose the message to this queue if the
following conditions are true:
Authorisation This queue holds messages that must be authorised before they are sent to
the SWIFT network.
Swift This queue holds messages that are valid and authorised and sends them to
the appropriate message queue:
• MT messages go to _SI_to_SWIFT
• MX messages go to _SI_to_SWIFTNet
Availability of queues
The queues available depend on the following:
• the permissions in the operator profile
• the format of the message
• the type of message
• the configuration parameters that are defined for the correspondent
It is not required that the queue to which you move a message be the next queue as defined in the
routing rules.
Before Alliance Lite2 moves the message to a selected queue (except for the Text Modification
queue), Alliance Lite2 validates the message. If validation is successful, then the message is stored
in the selected queue, and may be available for further processing (depending on the queue) by
authorised operators.
Overview
The File Message: Send page displays a list of the FileAct messages for transferring a file to
correspondents.
Page example
Filtering Criteria Enables you to filter a list of FileAct message templates according to various
criteria.
Service Name The name of the service over which the file is sent
Request Type The specific function within the service being provided
Responder DN The distinguished name of the organisation to which the file is being
transferred (also called the receiver). Please use the DN Picker provided.
Unit The unit that is assigned to the file message when an operator sends a file.
Last Modified By The name of the last operator who modified the template
Functions
New Enables you to create a FileAct message manually to send a file, and if needed, to save
the message as a template.
Functions
Function Description
Save as template Saves a new or existing file message template or saves an existing file
message template with a new name
Route Routes the file to Alliance Lite2 based on active routing schema
Responder DN The distinguished name of the correspondent that to which the file is
transferred (also called the receiver)
Service Name The name of the service over which the FileAct message is sent (for
example, swift.fileact.snf for store-and-forward)
Request Type The specific function within the service being provided
User Reference This optional field allows you to enter additional information about the file
transfer.
Possible There may be occasions when you need to re-send a file. Selecting this
Duplicate check box informs the receiver that it is a possible duplicate. The receiver
then has the option to check the files and accept the re-send, or if the file was
successfully received before, the receiver can mark the transfer as duplicated
and the file is ignored.
Select from the drop-down list:
• Yes
• No
Header Info This field allows you to add additional information in the header of the file
transfer.
Advanced If you select the Advanced Settings check box, then additional fields appear.
Settings
Note You must not use Advanced Settings. Using Advanced
Settings may disable your FileAct traffic temporarily.
Overdue Warning You can request that the store-and-forward system generates an overdue
Type warning if a sent file has not been delivered within a certain delay or at a
certain date and time. You can optionally flag a file with the overdue warning
option. This indicates that you want to receive an overdue warning from
SWIFT if the file was not delivered within a time frame.
• None
• Time: If you select Time, then the Overdue Warning Time field appears.
• Delay: If you select Delay, then the Overdue Warning Delay (Min) field
appears.
This is an advanced setting for FileAct messages.
SnF Copy This feature allows you to require a store-and-forward copy of the header of a
file transfer request, or the full file to a third party, as provisioned for the
service.
Select from the drop-down list:
• Automatic
• Yes
• No
Third Party DNs The distinguished names of third parties for the store-and-forward copy
This is an advanced setting for FileAct messages.
Authorisation Select from the drop-down list to indicate whether a system message with the
Notification third party's decision to authorise the transfer is expected:
• Automatic
• Yes
• No
Logical File The logical file name defined in the database for that file message.
Name
File Info This optional field is for structured data that can be used by the receiver for
automatic processing of the file. It has to be agreed between you and the
receiver. Backus-Naur Form (BNF) notation is used as the syntax for this field.
For more information, see the Alliance Gateway File Transfer Interface Guide.
File compression can be used only if you have an agreement with your
counterparty to use the same file compression algorithm and tools. If file
compression is to be used, then it is the responsibility of the users to compress
the file before it is transferred, and to de-compress it after it is received. SWIFT
defines the SwCompression keyword in the FileInfo field to indicate if a file has
been compressed. The usage of the SwCompression keyword is mandatory
for all file transfers and must be the first keyword in the FileInfo field. If the file
is not compressed, then the File Info must contain SwCompression=None.
Examples of possible values for SwCompression are:
• Zip
• Gzip
• None
Note Other values are possible, as long as both sides of the file transfer
understand the compression used.
File Description This optional field allows you to provide information for the receiver about the
file.
Transfer Info An optional field for structured data that can be used by the receiver to process
the file transfer automatically. The contents of this field must be agreed
between you and the receiver. Backus-Naur Form (BNF) notation is used as
the syntax for this field. For more information, see the Alliance Gateway File
Transfer Interface Guide.
Transfer An optional field where you can enter information about the file transfer that
Description you want to exchange with the receiver.
(1) To display the User space option of the File on field in the File tab of the FileAct Message Details (Send) view, the Access
Control, Files on User Space permission is also needed in your operator profile.
(2) Show Message displays the message details and is available through the File Transfer Details window.
Note Adjust additional permissions accordingly to allow or prohibit for Own Destinations,
services, and request types.
This is a customisation option.
Procedure
1. From the Creation menu, select File Message: Send.
The File Message: Send window opens.
2. Do you want to use a FileAct message template? Choose the next action:
• If yes, click the row of the template.
The FileAct Template Details - <template name> (Send) window opens.
• If not, click New . The FileAct Message Details (Send) window opens.
3. Enter the message details in the tabs:
• Header: see FileAct Details Window (Send): Header Tab on page 103
• File: see FileAct Details Window (Send): File Tab on page 106
• Comments: if you want to, you can enter comments about the message.
4. Choose the action to take:
Action Next, go to
Route the message based on the active routing Step 6 on page 109
schema
Click Show Message from the File Transfer Details window or go to the Search and Report
menu > Message Search, search for messages and select a file message to view its
Message Details.
Click Save File .
• Save the payload from the file transfer details.
Go to the Search and Report menu.
Select the file message and save the payload file from the File Transfer Details window.
• From the Search and Report menu, select a file message and save the payload file from
the File Transfer Details window.
Filtering Criteria Enables you to filter a list of FileAct message templates according to various
criteria.
Service Name The name of the service over which the file download is requested
Request Type The specific function within the service being provided
Responder DN The distinguished name of the organisation from which file is requested (also
called the sender)
Unit The unit that is assigned to the file message when an operator requests a file
transfer
Last Modified By The name of the last operator who modified the template
Functions
New Enables you to create a FileAct message manually to request a file for download.
Functions
Function Description
Save as template Saves a new or existing file message template or saves an existing file
message template with a new name.
Unit The unit that is assigned to the file message when an operator requests a file
transfer
The value entered for the Unit field by an operator when creating a file GET
request is automatically saved when the message is created successfully. It is
proposed as the initial value when the same operator creates another file GET
request.
Authoriser DN The Authoriser DN to be used for the file get request. If present, its level 2
BIC8 must be the same as the level 2 BIC8 of the Requestor DN.
Responder DN The distinguished name of the organisation the file is transferred from (also
called the sender)
Service Name The name of the service over which file download is requested.
Request Type The specific function within the service being provided
User Reference This optional field allows you to enter your own reference information
concerning the file download
Possible There may be occasions when you need to re-send a request. Selecting this
Duplicate check box informs the receiver that it is a possible duplication. The receiver
then has the option to re-send the file or not.
Select from the drop-down list:
• Yes
• No
Advanced If you select the Advanced Settings check box, then additional fields appear.
Settings
Reception The name of the real-time SWIFTNet reception profile to be used for the
Profile request, its response, and the subsequent file reception.
This is an advanced setting for FileAct messages.
Logical File Logical name of the file to be downloaded. This name must be known also by
Name the correspondent from whom the file transfer is requested.
Transfer Info An optional field for structured data that can be used by the correspondent to
process the file transfer automatically. It has to be agreed between you and
your correspondent. The contents of this field must be agreed between you
and the correspondent. Backus-Naur Form (BNF) notation is used as the
syntax for this field. For more information, see the Alliance Gateway File
Transfer Interface Guide
Transfer An optional field where you can enter information about the file transfer that
Description you want to exchange with the correspondent.
A pop-up window appears with one of the following messages when an RMA check failure occurs:
RMA not authorised The business relationship between sender {0} and
receiver {1} does not allow you to send this message.
Are you sure you want to continue?
RMA is not enabled The business relationship between sender {0} and
receiver {1} is not enabled. Are you sure you want to
continue?
Authorisation is not within validity period The business relationship between sender {0} and
receiver {1} does not allow you to send this message at
this moment. Are you sure you want to continue?
(1) {0} and {1} correspond to the BIC8 of the requestor DN and the responder DN.
8 Message Modification
Introduction
By default, if Alliance Lite2 cannot process a message, it routes it automatically to the appropriate
queue. For example, if a message fails authentication or cannot be authorised because there is no
business relationship, Alliance Lite2 routes it to the Emission Security Modification queue.
Messages or files are in the Text Modification queue because operators deliberately sent them
there or they may arrive there because of routing rules. You can view and work with messages held
in modification queues depending on your operator profile.
Modification queues
Messages or files that require modification are held in the following modification queues in Alliance
Lite2:
• Text Modification
• Emission Security Modification
• Reception Security Modification
Allowed changes
Your operator profile determines which message queues that you can display and which messages
that you can modify. For example, you can only modify messages assigned to your operator profile.
To modify a message, you may need to contact the person who originally put the message in the
modification queue to find out which fields are incorrect.
The list of messages displayed for a modification queue may include messages that are reserved.
These messages are already open by other operators. Only one operator at a time can modify a
message, to prevent concurrent updates.
The fields that you can change in a message depend on the modification queue in which the
message is held.
After modifying a message, you must either route it or dispose it so that its processing continues.
Note A file message or a message with format FpML or AnyXML can potentially appear in a
modification queue. Such messages are displayed with the body in fast mode.
When more than one messages are selected, the behaviour is:
• The first message of the selection is opened with the editor
• Once the current message has been modified and the editor closed, a popup appears asking
you to confirm that the next message in the selection must be opened with the editor. If you
confirm, the next message is opened and the current message is removed from the selection. If
you cancel, then no further message from the selection is opened with the editor and the
selection is emptied.
• If a message from the selection, by the time it is opened, has been reserved or moved to
another queue, an error message is displayed. When this error is acknowledged, a popup is
displayed asking you to confirm that the message after the one in error in the selection can be
opened.
• If the Route or Dispose operation fails on one message, after it is handled, you are asked to
confirm the next message in the selection.
Note No status message is displayed when returning to the full list of messages in the
modification queue.
Fast mode
You can use fast mode to modify messages in certain queues.
Fast mode presents the message information as follows:
• MX messages:
- beautified XML representation, if the elements of the message can be parsed, or possibly as
a mixture of beautified XML and plain text
• FIN messages:
- plain text, that is, the original string representation
List example
The example that follows shows a list of messages held in the Text Modification queue:
Correspondent The sender of the message if the message was output from the network. The
receiver of the message if the message was input to the network.
Identifier The message identifier that uniquely identifies the message type (within a
particular service).
Open By Name of the operator who reserved the message, that is, who has already
opened it and is currently working on it.
NAK Code For FIN or APC messages, this is the error code returned by the SWIFT
network. For more information about NAK codes, see the FIN Error Codes.
Last Change Name of the last operator who modified the message
SLA ID The applicable global payment service level (field 111 in the MT header).
Status Indication of whether the message is locked (if not, the entry in this column is
blank).
Status Indication of whether the message is locked (if not, the entry in this
column is blank).
3. Click the message that you want to open. If the message is valid, then it is displayed with the
Header tab open by default. If the message contains errors, then a Validation Report is
displayed in addition.
4. The fields that you can change depend in which of the following queues the message is held:
• Text Modification, see Messages in the Text Modification Queue on page 120
5. If you need to correct errors for a message in the Text Modification queue, then you can click
Validate to verify that you have corrected them properly and that no errors remain.
6. When you have finished entering modifications, either route the message or dispose it to
another queue. The Status area informs you that the message was routed or disposed
successfully.
If the message still contains errors or warnings, you can dispose it to the Text Modification
queue for later editing.
7. You can generate a report of the message. Click Report . For more information about generating
a report, see Report Types and Settings on page 23.
8. Click another message to be modified or perform any other available task.
2. Define the values to use in filtering the list in the filtering criteria fields.
Note When using filtering criteria for FIN messages, you must key the Identifier (for
example, fin.103) instead of just the MT (for example, 103).
3. Once you have provided all relevant criteria, click Submit . A new list is returned according to the
criteria submitted.
2. Select one or more messages to complete by checking the box next to the messages. To
complete all the messages in the displayed page, check the top box.
3. Click Complete . A confirmation window appears.
4. Click OK to confirm or Cancel to return to the list of messages.
Example
Here is an example of the validation report for a FIN message that has been opened from this
queue:
Message authorisation
Alliance Lite2 uses authorisations created with the Relationship Management interface to check
that it is possible to send messages or files to a correspondent. Authorisation fails if there is no
appropriate authorisation. For example, the authorisation does not exist, the message is not
allowed, or the message is outside the validity period specified in the authorisation. The
authorisation result is also in the emission appendix, shown in the RMA Check field.
Procedure
1. Investigate the problem that caused authentication or authorisation to fail.
2. Correct information as needed for RMA.
3. Open or select a message and click Authenticate .
Alliance Lite2 attempts to authenticate the message and send it to the appropriate input queue.
If authentication fails, then the message returns to the Emission Security Modification queue.
Message authorisation
Alliance Lite2 uses business relationships from RMA to authorise messages received. If the
message needs to be authorised using RMA, then Alliance Lite2 checks whether an appropriate
RMA relationship exists when attempting to receive a message. If there is no appropriate business
relationship, then RMA authorisation will fail. The authorisation result is visible in the RMA Check
field in the reception appendix. After solving the problem that caused the message to fail
authorisation, you can reauthorise the message (only FIN messages allow reauthentication to be
used). For example, an RMA authorisation is received after the message is routed to the
_MP_mod_rec_secu queue. The trailer of a reauthenticated message now shows that the
authorisation is successful.
You can also possibly bypass security for the message if you have the appropriate permissions.
Procedure
1. Investigate the problem that caused authentication or authorisation to fail.
2. Correct information as needed for RMA.
3. If you open the message
Open the message by clicking the message or select the checkbox to the left of the message
and click Open then perform one of the following actions:
• Bypass Security
• Route
• Bypass Security
9 Message Approval
Introduction
Approval can include the following task:
• Authorise messages, that is, perform a visual check on the messages before sending them to
the network input queue.
Note Messages with format FpML or AnyXML can potentially appear in the authorisation
queue. Such messages can be opened using fast mode.
Note InterAct and FileAct messages have an emission expiry time. This means that there is
a limited time between message creation and the time that they can be authorized.
See Message Details Page on page 140.
Message Verification List view Reject Single Mesg Approval, Approve Message, Own
message destination/ Can Verify/ Verify own entered
msg/ Ccy-amount/ Message types
AND
AND
Message List view Approve/ Single Mesg Approval, Approve Message, Own
Authorisation Reject message destination/ Can Authorise/ Auth own
entered msgs/ Auth own verif msgs/ Ccy-
amount/ Message types/ Trans app limit,
Daily app limit
AND
Rejecting MT and MX messages that are syntactically incorrect and cannot be opened
Operators can reject one or more messages selected from the list of MT and MX messages in the
verification queue using the Reject button. In order to reject one or a group of messages, an
operator requires the Msg_Auth or Msg_All permission. This action enables the operator to move
syntactically incorrect messages that cannot be opened from the verification queue to the text
modification queue.
Page example
Identifier The message identifier that uniquely identifies the message type.
Match Case You can check the Match Case box to restrict entries in the results to the
messages matching the case used in the Reference field.
SLA ID Service Level Agreement (SLA) identifier in the MT header: field 111. This field
identifies the applicable global payment service level.
UETR Unique end-to-end transaction reference in the MT header: field 121. This field
provides an end-to-end reference across a payment transaction.
Identifier The message identifier that uniquely identifies the message type.
SLA ID The applicable global payment service level (field 111 in the MT header).
Open By Name of the operator who reserved the message, that is, who has already
opened it and is currently working on it.
Last Change Name of the last operator who modified the message
Status Indication of whether the message is locked (if not, the entry in this column is
blank).
Page example
Enables you to filter a list of messages according to various criteria. For more
information, see Filter a List of Messages in a Queue on page 119
Identifier The message identifier that uniquely identifies the message type.
Match Case You can check the Match Case box to restrict entries in the results to the
messages matching the case used in the Reference field.
SLA ID Service Level Agreement (SLA) identifier in the MT header: field 111. This field
identifies the applicable global payment service level.
UETR Unique end-to-end transaction reference in the MT header: field 121. This field
provides an end-to-end reference across a payment transaction.
Identifier The message identifier that uniquely identifies the message type.
SLA ID The applicable global payment service level (field 111 in the MT header).
Open By Name of the operator who reserved the message, that is, who has already
opened it and is currently working on it.
Last Verify Name of the last operator who verified the message.
Last Change Name of the last operator who modified the message
Transaction The Transaction Reference Number (TRN) of FIN messages (usually field
Reference 20 of the message), and the MX keyword 1 of MX messages. This field is
left blank for File and proprietary messages.
Related Reference The Related Reference of FIN messages (usually field 21 of the
message), and the MX keyword 2 of MX messages. This field is left blank
for File and proprietary messages.
Example
Tabs
The permissions in your operator profile may allow you to authorise messages without viewing their
content. In this case, you can route those messages from the authorisation queue using Authorise .
Authorised messages can be routed or disposed, depending on your Alliance Lite2 operator profile
permissions.
You can also open a message and reject it using Reject . To reject one or a group of messages
without viewing their content, you require the Msg_Auth or Msg_All permission.
Message signing
You must sign a message before it is authorised. This feature applies to all MT, MX messages and
FileAct files.
You can sign messages individually, or sign multiple messages in one operation. You sign a
message in the Message Signing window.
The list shows various attributes for each message. For a description of these attributes, see
Message Authorisation Page on page 127.
Messages shown as reserved (that is, having a name in the Open By column) are already
open by other operators. To prevent concurrent updates, any other operator cannot open a
reserved message.
2. If needed, refine the list using filtering criteria. For more information, see Filter a List of
Messages in a Queue on page 119.
3. Do you want to view the message before you authorise or reject it? Choose the appropriate
step:
• Yes: go to Step 9 on page 132
• No: go to Step 4 on page 131
4. Select the checkbox to the left of the message or messages, in the Message Authorisation
page.
Choose the appropriate actions:
• Click Authorise .
Select the Payload tab to partially display the content of the file payload. Click Save File to save
the content.
If the message has validation errors then the Validation Report appears. For more information,
see Validate a Message and Correct Errors on page 96.
10. To view the body of the message in fast mode, click Fast .
The body of the message appears in fast mode.
11. Optionally, click the Comments tab and add your comment.
12. Next, take the appropriate action. You authorise a valid message if you route it or if you dispose
it to the Swift queue.
Route This button authorises the valid message Route a Message on page 99
and routes it according to the routing rules
defined within Alliance Lite2.
Dispose to Sends the message to a queue that you Send a Message to a Queue
choose. You authorise the message if you (Dispose to) on page 99
dispose the message to Swift.
CAUTION If you do not provide search criteria, then you will not easily find what you are
looking for. The server will only fetch a limited number of records (that is, enough
to show a first page of results).
3. Click Search . While messages are being added to the list, the text Please wait may appear.
The search results appear with the list of messages that meet your search criteria. If a search
returns no results, then a message is displayed that indicates that no results match the current
criteria.
The total number of messages matching the search criteria is displayed next to Rows in list in
the list. This total is computed or refreshed only when you click Search . Otherwise, it is not
automatically refreshed at regular intervals. If the number of messages matching the search
criteria is above 10.000 occurrences, in order to avoid a degradation of performance, Alliance
Lite2 stops counting and displays the link Total: More than 10.000 in the top menu, instead of
the counting result. If you select this link, the full counting function is resumed.
Use Previous and Next, if necessary, to navigate through the pages of the complete list.
Click Change View to select the number of rows displayed.
You can use the check boxes to select the messages for which you want to generate a report of
the message details, or the message summary. You then click Export to generate a report. See
Generate a Report of Messages from Search Results on page 166 to select and generate a
report of one or more messages from this page.
For MX messages, the Reference column is populated with the content of the RequestRef
field. This field is extracted from MX keyword 2 in the MX System Messages Deployment
Package, for the following MX system messages:
• xsys.002.001.01
• xsys.003.001.01
• xsys.010.001.01
• xsys.010.001.02
• xsys.011.001.01
• xsys.011.001.02
• xsys.012.001.01
• xsys.012.001.02
4. Click a message in the list to open it and view its details. The Message Details page appears
with the Header tab open by default. For a description of that page, see Message Details Page
on page 140.
You can generate a report of the message details, or the message summary by clicking Export .
See Generate a Report of Messages from Search Results on page 166 to select and generate
a report of one or more messages from this page.
5. Take one of the following actions.
• Click Previous or Next to go directly to the previous or next message in the list without
closing the message currently displayed.
• Click Search Results (located between Previous and Next) or Close to go back to the list
of messages.
SLA ID The service type identifier (field 111 in the MT header) that is used for
services such as SWIFT gpi.
Reference
Message Value in the Reference field
Format
MX A user reference
MUR Message User Reference extracted from the User Header block of the
message
Related Reference Contains the Related Reference of FIN messages (usually field 21 of the
message), and the MX keyword 2 of MX messages. This field is left blank
for File and proprietary messages.
Suffix A system generated value intended to make the UMID unique. The first
part is the creation date of the message in YYMMDD format, a six-digit
number. The second part consists of a number (1 to 10 digits) that the
system generates. This number is incremental and unique for all
messages.
Value Date The date on which funds are credited or debited to or from the receiver's
account.
Format/Status The message format and current processing state of the message. For
example, a message may be in SWIFT format with a status of "live",
which means the message has one or more instances undergoing or
awaiting processing. Alternatively, a message can have a status of
"complete", which means that all instances have been processed.
Netw. Status The network processing result of the last transmission. The data for this
field is taken from the information contained in the last transmission
intervention attached to the corresponding message instance. To see the
transmission result of previous networks, use the Transmission tab to
search for messages based on details of their transmission interventions.
For more information, see Search by Transmission Details on page 154.
Orig Inst RP The queue or routing point in Alliance Lite2 where the original instance of
the message is located. If the original instance has been completed, then
no routing point appears.
Dup from Network A message that has been received with duplicate information from the
network
Dup Set Locally A message that has been marked as duplicate locally (inside Alliance
Lite2) by a user
Interface Detected A message that Alliance Lite2 has identified as duplicate by means of its
Dup duplicate detection mechanism
Mesg Creation The date and time when the message was created
Emission Info The network name, session number, and sequence number of the last
emission appendix of the original message instance have the following
format:
<network name><session number><sequence number>
Reception Info The network name, session number, and sequence number of the last
reception appendix of the original message instance. It has the format:
<network name><session number><sequence number>
Sender/Receiver The BIC-11 address of the sender, and receiver of the message
The nested sorting determines the order in which the results of a search are made available to the
GUI in the list of messages/instances. For example, if Mesg Creation, Identifier, and Service
Name are selected (in that order), the messages/instances will be sorted first by Mesg Creation,
then by Identifier, and then by Service Name.
The sorting selected on the table header applies to all messages or messages instances and is not
limited to the subset of results displayed in the GUI page.
While sorting, you can click Abort to cancel the ongoing sorting action. In this case, no results are
returned.
Note The default sorting for message and instance searches is based on Mesg Creation.
You receive an error message when you attempt to sort an unsortable column, such
as Mesg Description or Suffix.
During a search, if some fields are returned empty and need to be sorted on, The
empty values are displayed at the beginning of the returned list. The empty values
include: null values (for optional fields), empty string values (for mandatory string
fields), or 0 values (for mandatory numeric fields).
Page example
Page description
Sender/ Contains details of the sender and the receiver of the message.
Receiver tab
Response Text For MX messages sent using real-time delivery, the Response Text tab
tab (real-time contains a business response from the message receiver. The Display
MX AnyXML or expanded text option is also available on this tab. This option is only shown
other XML when Alliance Lite2 was able to retrieve the message definition of the response
messages sent (deployment package installed) and the response is valid according to its
only) schema definition.
History tab Shows the history of a message, which is derived from message interventions.
The message history is presented chronologically as individual paragraphs.
Starting with the original instance, each paragraph refers to a separate instance
associated with the message, such as copy or notification.
The History tab shows only the final routing rule that was applied to the original
message.
For example, if a routing rule was applied to an original instance but without an
action defined to apply to the message, and then a second routing rule was
applied, then the history of the message does not include details of the first
routing rule.
If there are more than 50 appendices, then only the 25 first appendices and 25
last appendices are displayed. The same rule applies to interventions.
Instances tab Shows all the instances, both live and complete, that were created for a
message.
You can also cancel message instance emissions on this page.
Other tab Contains further information about the message, such as the message priority,
and the number of signatures required by the message.
This tab also contains information related to emissions, such as:
• Expiry Date Time, which indicates the date and time after which Alliance
Lite2 should stop attempting to send a real-time FileAct or InterAct message
to SWIFTNet, should the emission repeatedly fail until that date and time.
This information is applicable to input SWIFTNet messages only.
• Next Emission Date Time, which indicates the date and time before which
Alliance Lite2 will not attempt to send a real-time FileAct or InterAct
message to SWIFTNet. This field provides information about the Alliance
Lite2 retry logic only, which regularly recalculates the sending interval to
maximise the chance of sending the message successfully.
Note If the delivery notification cannot be returned, then the file will be
re-sent up to 10 times; each time the acknowledgement and the
failed delivery notification will be stored in the reception directory. If
the delivery notification is still not received after 10 retries, then the
payload file and the companion parameter file are moved to the
error directory. If the delivery notification is sent successfully, then
the payload file and the companion parameter file are moved to
the reception directory.
For both store-and-forward and real-time traffic, Alliance Lite2 global system
parameter Default emission expiry is set to 4 hours, and this is the maximum
length of time during which retries can happen. For store-and-forward
specifically, there is a retry limit of 2 times, indicating the maximum number of
retries done for store-and-forward FileAct or InterAct.
When it is up and running, the Alliance Lite2 checks every five minutes if
messages with an emission expiry date and time that are in the
_SI_to_SWIFTNet queue have expired. The expiry criterion is that the File
message emission expiry date and time is earlier than or equal to the current
date and time.
When a message is found to be expired, it is immediately rejected locally as if it
had been rejected by the network, and Alliance Lite2 no longer attempts to
send it to SWIFTNet. The detailed process is as follows:
1. An emission appendix is created with:
• Network Delivery Status: Rejected Locally
• Session number: 0
• Sequence number: 0
• Session holder: expired
• The pseudo Network ACK/NAK text: T08 - Message expired
2. The function result is set to Failure.
3. The message is routed.
4. An intervention Message Expired is created for the message.
5. SNIS event 28149 is logged in the Event Journal.
Related Appears in the message details if the message that you open is related to at
Messages tab least one other message. For more information, see Find and View Related
(MX messages; Messages on page 144.
relevant only
for store-and-
forward
delivery)
Export Clicking this button generates a report of a message or messages. For more
information, see Report Types and Settings on page 23.
Print Prints a report directly from the GUI. For more information, see Print a Report
Directly from the GUI on page 23.
You can combine search criteria from different tabs. For example, you can search for all messages
in a specific queue (selected from the Instances Location tab) that were created between 9 am
and 10 am (defined in the Source & Creation tab).
Frequently performed searches using the same criteria can be saved. See Save Search Criteria as
Template on page 157 for details.
Message Format
FIN MT messages only Identifier. Enter a message identifier to filter upon. This is a free-text field
that accepts the wildcards _ and %.
It is possible to search for multiple message type families when using the
message Identifier field in one search. If multiple values are provided for
the Identifier field, then the values must be separated by a comma ",".
Any Messages of any Identifier. Enter a message identifier to filter upon. This is a free-text field
format that accepts the wildcards _ and %.
It is possible to search for multiple message type families when using the
message Identifier field in one search. If multiple values are provided for
the Identifier field, then the values must be separated by a comma ",".
File File message only Service Name. You can enter a service name to search for messages
sent to a service for which the message standards are no longer installed.
You can search for messages of a specific service even if the message
standards were removed.
You can type a value in the Identifier field, which is a free-text field that
accepts the wildcards _ and %.
Internal Store-and-forward Identifier. Enter a message identifier to filter upon. This is a free-text field
delivery notifications; that accepts the wildcards _ and %.
also for messages that
may have arrived with
an unrecognised format
Other Standard ... Service Name. You can enter a service to search for messages sent to a
service for which the message standards are no longer installed. You can
search for messages of a specific service even if the message standards
were removed.
You can type a value in the Identifier field, which is a free-text field that
accepts the wildcards _ and %.
For Solutions that you MX messages The Service Name is automatically filled in to correspond to the MX
have implemented message standard that you select.
If you select a specific message from the Message Name drop-down list,
then the Identifier is automatically filled in.
UMID
Type Enter the message type that is the object of the search (for example,
103). It must be a three-digit number.
Qual If necessary enter a qualifier. For example, use STP or REMIT in the case
of MT 103.STP and MT 103.REMIT.
Reference Enter a value that corresponds to the user reference in the message.
Correspondent Type the sender BIC8 (if the message was output from the network) or the
receiver BIC8 (if the message was input to the network).
Reference Enter a value that corresponds to the user reference in the message
header.
Content
FIN Sender The sender Type the name of the sender Any, Institution, Department, or
Individual.
Receiver The receiver Type the name of the receiver Any, Institution, Department, or
Individual.
Search Text A string contained in Type a string, which must begin and end with %.
the message
Consider the following restrictions:
• this field is case-sensitive
• the search is limited to the message body only
For improved results use wildcards.
You can specify the character string fully or partially by using
wildcards:
• "_", to replace one unknown character. For example, type
A_Z to match both "AUZ" and "ABZ".
• "%", to replace zero, one or more contiguous unknown
characters. For example, type A%Z to match both
"ABCDEZ" and "AZ".
Message User Maximum length is 16, only alphanumeric values are allowed.
Reference
SLA ID The Service Level The applicable global payment service level (field 111 in the
Agreement (SLA) MT header).
identifier
UETR The unique end-to-end An end-to-end reference across a payment transaction (field
transaction reference 121 in the MT header). This field is not case-sensitive.
(UETR)
Copy MX, File, or Any Select the check box to include copy messages.
messages
Does not display
for Internal.
Requestor DN The requestor DN Type the requestor DN. The wildcards '_' and '%' can be used
in the name. No normalisation is performed, so the DN criteria
you provide must exactly match the DN of the message to be
found.
Responder DN The responder DN Type the responder DN. The wildcards '_' and '%' can be used
in the name. No normalisation is performed, so the DN criteria
you provide must exactly match the DN of the message to be
found.
Copy File messages Select the check box to include copy messages.
Requestor DN The requestor DN Type the requestor DN. The wildcards '_' and '%' can be used
in the name. No normalisation is performed, so the DN criteria
you provide must exactly match the DN of the message to be
found.
Responder DN The responder DN Type the responder DN. The wildcards '_' and '%' can be used
in the name. No normalisation is performed, so the DN criteria
you provide must exactly match the DN of the message to be
found.
Logical File The logical file name Type the logical file name. The wildcards '_' and '%' can be
Name used in the name.
Transfer The transfer description Type the transfer description. The wildcards '_' and '%' can be
Description used. A '%' wildcard is automatically appended to values that
do not already contain a '%' wildcard. This applies regardless
of whether the value contains space character(s) and/or '_'
characters.
Requestor DN The requestor DN Type the requestor DN. The wildcards '_' and '%' are accepted
in the name. No normalisation is performed, so the DN criteria
you provide must exactly match the DN of the message to be
found.
Responder DN The responder DN Type the responder DN. The wildcards '_' and '%' are
accepted in the name. No normalisation is performed, so the
DN criteria you provide must exactly match the DN of the
message to be found.
Related information
Search by ID and Content on page 145
Live Days Messages in the Alliance Lite2 database, that is live and completed
messages for days that have not been archived yet.
Archived Days Messages in an archive file, that is a file containing messages that
were archived (and are no longer live).
Use the arrows to move the values required from the Available field
to the Selected field.
Complete the Creation date/time range and the Find Possible Duplicates check box. For
more information, see step 7 on page 153 and step 9 on page 154.
5. If you select Instances, then the Search In field automatically shows Live Days. Select the
appropriate value from the State drop-down list:
• Live
• Completed
• Reserved
6. If you select Templates, then the ID & Content tab is the only other tab available.
7. To specify creation date and time criteria, complete the Date and Time fields in the Creation
part.
For message search this criteria applies to the message creation date and time.
For instance search this criteria applies to the instance creation date and time.
From Date Type the date of the earliest message to be found, using numeric characters. The date
can be entered with or without slashes, for example, DD/MM/YY or DDMMYY. The date
format is interpreted according to the Alliance Web Platform settings, for example
European, US, or ISO format.
From Time Type the time of the earliest message to be found. Provide either the entire HH:MM:SS
value with or without the : or only the one-digit or two-digit (HH) hour value. Alliance
Web Platform interprets this value as 24 hour time format, and fills in the values for
MM:SS automatically with the current settings.
To Date Type the date of the latest message to be found, using numeric characters only.
To Time Type the time of the latest message to be found. Provide either the entire HH:MM:SS
value with or without the : or only the one-digit or two-digit (HH) hour value. Alliance
Web Platform interprets this value depending as 24 hour time format, and completes the
values for MM:SS automatically with the current settings.
If no value is entered, then the field is automatically completed with a time of 23:59:59.
8. To specify message template usage tracking criteria, complete the Usage Count and Last
Usage From Date fields in the Usage Statistics part. This part is available only when the
Search In field is set to Templates.
Usage Count This field indicates the total number of times that the MT or MX
template has been used to manually build a message.
In the first field, select a threshold value, either: '=', '>', '<', '>=', or
'<='. In the second field, specify an integer. Both fields are optional,
but must be present together.
Last Usage From Date This field indicates the timestamp (in the local time of the browser)
when the MT or MX template was used to manually build a message.
Specify either a start date field or an end date (or both). Both fields
are optional.
9. To search for duplicate messages or templates, select the option Find Possible Duplicates.
This search criterion returns all messages that have been received with duplicate information
from the network, messages that Alliance Lite2 has identified as duplicate by means of its
duplicate detection mechanism, or messages that have been marked as duplicate locally
(inside Alliance Lite2) by a user. Messages that Alliance Lite2 identifies as duplicate are also
automatically marked as having been flagged locally as duplicate by the user.
For more information, see Detecting Duplicate Messages on page 158.
10. To search for messages that have been manipulated by a human, select the option Touched
By Human. Type the name of the operator in the Operator field. You can use wildcards in this
field.
Each time that an intervention performed by an operator is recorded on a message instance of
a message, the whole message is considered as Touched by Human.
Examples of a message that involve human intervention:
• The text of a message is modified.
• An instance of a message is completed.
• A message is created from the message creation application.
11. When you have finished making your search criteria selection, click Search .
3. To specify details of the transmission interventions of the message, complete the fields in the
Interventions part.
Network Name Select the network used to send or receive the message: The Reference field
appears if you selected
• Any, to search for messages sent or received on any
SWIFTNet as a
networks
network. Enter a value
• APPLI for the reference in the
• SWIFT message header. You
can use wildcards in
• SWIFTNet this field.
Session Holder Type the name of the logical terminal or message partner
profile that established the session during which the
message was exchanged with Alliance Lite2.
Example: SWHQUS33AXXXF
Sequence
Number:
4. To specify the networks that sent or received the messages to be searched, use the Available
and Selected columns in the Status part. Move the networks that you want to include in your
search to the Selected column. Click the appropriate networks in the Available column and
click the > arrow, or double-click them to move them directly to the Selected column. You can
select several networks simultaneously. To do so, press the CTRL key and click on the networks
that you want.
The following networks are available:
• APPLI
• SWIFT
• SWIFTNet
5. After selecting a network, options appear for you to specify transmission details.
Select one of the following:
• Transmission Failure, to search for messages whose transmission has failed
• Waiting Delivery, to search for messages that are awaiting delivery
• Waiting Transmission, to search for messages that have not been transmitted yet
Use Previous and Next, if necessary, to navigate through the pages of the complete list.
5. To close the search template, select Close Template.
Description
Alliance Lite2 distinguishes between three types of duplicate messages:
• Messages received with duplicate information from the network (either the back office or
SWIFT/SWIFTNet)
• Messages marked as duplicate locally (inside Alliance Lite2) by the user
• Messages identified as duplicate by the Alliance Lite2 server by means of its duplicate detection
mechanism. Such messages are also automatically marked as having been flagged locally as
duplicate by the user.
Duplicate detection is based on digest comparison.
Note If a duplicate FileAct message is sent or received using a different file digest algorithm,
then it will not be flagged as a duplicate.
• generate a report
• change the priority
• open the details of the message that contains the message instance
For information about generating a report of an instance, see Generate a Message Instance Report
on page 167. For details on the other actions, see further in this section.
These actions can be performed on a group of instances when you search specifically for message
instances.
Format of Reports
The reports are generated to be exported to a file or displayed for printing.
The report can be generated in the following formats:
• PDF
• CSV (only available for summary report, that is, message summary and messages per queue
reports)
• XLS
Operator permissions
The Alliance Lite2 operator profile permission to search for messages (Message File / Search) is
required for producing the message details and message summary reports in Alliance Lite2.
Message text
Depending on the value of the configuration parameter FIN User Header in Alliance Lite2, the
message text section shows the contents of the FIN User Header (block 3) of the message.
Column selection
The columns selected by default for summary information correspond to the set of columns that is
used for the Search Results page when searching for messages. You can modify this default set of
columns by clicking Change View on the Search Results page.
You can always select a different set of columns by selecting them in the Export window when you
click Export . You can reset the selected set of columns to its default value at any moment by
clicking Reset .
Sort order
Sort order is only applicable when running a Summary or a Details report from search criteria.
Alliance Lite2 presents summary results in the sequence that Alliance Lite2 provides them. You can
select a value in the Sort Order field to determine the order in which Alliance Lite2 returns the
resulting output.
Value Result
Creation Date (default) The output is sorted in descending order so that the most recent message appears
first.
Currency / Amount The output is first sorted in alphabetical order by currency code, and then sorted in
ascending order by amount.
Use Currency / Amount for a report that includes only FIN messages.
When using the report function from the search criteria, you are able to select a detailed report or
summary report and the report can contain too many messages. It is better to redefine your search
and then use the report function of messages from search results. For this procedure, see
Generate a Report of Messages from Search Results on page 166. If you want to create a details
or summary report from search criteria, then use the following procedure.
Procedure
1. Specify the search criteria, see Specify Search Criteria on page 144.
2. Click Export in the search criteria.
The Export window appears.
3. For Export Range, the following rules apply.
• If you have selected all of the entities in the search list, the Export Range is set to Selected
items.
• If you have not selected an entity on the search page, then all of the entities matching the
criteria across the results are selected (not limited to the results on the page). The Export
Range is set to All items.
• If you have selected a subset of the entities in the list, then only those entities are selected
for export. The Export Range is set to Selected items. However, you can alternatively
select All items, which causes all entities matching the filters to be exported.
4. Select a report type from the Export Type drop-down list.
The report types available are:
• Summary
• Details
If you select to create a Details report, the following check boxes are activated:
• Display Expanded Text: if selected, descriptive names for each field are displayed in the
report, provided that the corresponding message standards are installed.
• Include History: if selected, message history details are included in the report. The history
is derived from message interventions.
If any of the above check boxes are not selected, the corresponding section of the message
Details report is omitted.
• Selecting Details outputs all the message information retrieved by the search for one or more
selected messages.
• Selecting Count provides the number of messages that satisfy the search criteria.
If your operator profile does not allow you to see the message text, then it does not appear in the
printed output.
Procedure
1. Run the search query.
The Search Results page appears.
2. Use the check boxes to select the messages for which you want to generate a report, or click a
message to open it.
3. Click Export on the top of the table of search results or at the bottom of the message details
page if you opened an individual message.
The Export window appears.
4. For Export Range, the following rules apply.
• If you have selected all of the entities in the search list, the Export Range is set to Selected
items.
• If you have selected no entities on the search page, all of the entities matching the criteria
across the results are selected (not limited to the results on the page). The Export Range is
set to All items.
• If you have selected a subset of the entities in the list, only those entities are selected for
export. The Export Range is set to Selected items. However, you can alternatively select
All items, which causes all entities matching the filters to be exported.
5. Select a report type from the Export Type drop-down list.
The report types available are:
• Summary
• Details
• Count
6. Select a format from the Output Format drop-down list. The formats available are: PDF, CSV
(only for summary reports), XLS, and TXT.
Note If you selected TXT or CSV format, then Page Orientation Page Format are not
available.
7. Select the orientation of the report from the Page Orientation drop-down list.
8. Select the page size of the report from the Page Format drop-down list.
9. If you selected the Summary report type then you can modify the default set of Columns used
for the report. It is also possible to select the font size and the content.
10. Click OK .
The File Download window appears. You can then click Open to view or Save to save the
report.
If you click Open , then the report automatically opens assuming that you have a tool installed to
read PDF, CSV or XLS files.
11 Browse Services
Browse Services enable you to access secure Browse Services that are offered by third parties on
SWIFTNet. You can only access the services that your institution has subscribed to.
To access a Browse Service, you must first log on to the Browse environment of Alliance Lite2, you
have the permissions to do so.
Note Security Officers always have access to SWIFTNet Online Operations Manager, a
Browse service, for administration tasks.
To use Browse Services, you must deactivate the pop-up blocker for the website. The
pop-up blocker is deactivated by default. If the pop-up blocker has been activated, then
go to Internet Explorer > Tools > Internet options > Privacy > Pop-up Blocker >
Turn Off Pop-up Blocker.
When you select a Browse service, you will go through several screens before
actually accessing the service. You can skip these screens by clicking the
Preference button on the upper right corner of the screen. You may still be
requested to enter the password to access the service.
12 Message Upload
This chapter explains how to manage manual file transfer for batch input and to view details about a
file transfer session for a message partner.
Note Message Partner configuration is only available upon customer request.
• If necessary, the operator can select Allow Batch Duplication. When selected, this option allows
an operator to reuse batch files that have already been used by a message partner.
Note If an operator tries to start a session with a batch file that has already been used to
start another session, then an error is given and states that the batch file has
already been "used".
If you select the option Allow Batch Duplication, then it allows you to start the
session anyway and to bypass this check.
• An input session will stop automatically when the input file that contains messages has been
read. The name of the operator who started the session becomes the "creator" of any
messages that the message partner accepts.
• It is possible to view session details for the message partner while the session is in progress or
after it has finished.
• After the session has finished, Alliance Lite2 sends messages to the appropriate destination.
• The operator is responsible for removing the uploaded file when it is no longer needed.
CAUTION You must check whether a session was successful by checking the content of queues.
If the message cannot be found back in the queues, then SWIFT Support has to be
contacted to check the Event Journal.
Direction Indicates the direction that the message partner sends files relative to the
Alliance Lite2 session. From Message Partner indicates input to Alliance
Lite2.
Format Recognition Shows the type of format recognition defined for the message partner.
This column appears only in the File Input - Choose a Message Partner
page.
Data Format Shows the data format defined for the message partner.
Note When the Format Recognition is set to Auto then the Data
Format does not need to be specified in the message
partner configuration. When it is set to Forced, then you
must specify it.
Session Status Shows the current status of the message partner session.
If Then
The file is located in the User Space, and you know Type the path and file name in the Connection
the path and file name. Point field.
The file is located in the User Space, and you need • Click to locate and select the file to upload.
to select the file.
• Select the file for input.
Procedure
1. From the User Space page, click a folder.
2. Click Upload .
The Upload window opens.
3. Click Browse .
The Choose file window opens.
4. Browse to the location of the file, select it and click Open .
The Choose file window closes.
5. In the User Space File Name field, type a name for the file.
This name is used for the file in the User Space. The physical name does not change.
6. Click Upload .
The Upload window closes.
The file appears in the list.
If a file with the same User Space name exists in the folder, then the File Overwrite Confirmation
window opens.
2. Click Rename .
The Rename Item From User Space window opens.
3. Type a name in the New Name field.
4. Click Rename .
The Rename Item From User Space window closes.
The element is renamed.
13 Support
Support for SWIFT customers
By default, SWIFT Support is the single point of contact to report all problems and queries that
relate to SWIFT services and products. Support is available to all SWIFT customers.
Individuals within a customer organisation must register to use the Support service.
SWIFT automatically registers the Alliance Lite2 customer security officers, specified at ordering
time, as users of the Support service. Other users within a customer organisation must register to
get access to the Support service.
Subscription to Alliance Lite2 includes SWIFT's Standard Plus support package.
For more information about the different services that SWIFT offers as part of the support
packages and the procedure to order support, see Comparison of support packages on swift.com.
Related information
For more information about Support services, see the service description related to the applicable
support package:
Support documentation
Legal Notices
Copyright
SWIFT © 2018. All rights reserved.
Restricted Distribution
Do not distribute this publication outside your organisation unless your subscription or order
expressly grants you that right, in which case ensure you comply with any other applicable
conditions.
Disclaimer
The information in this publication may change from time to time. You must always refer to the
latest available version.
Translations
The English version of SWIFT documentation is the only official and binding version.
Trademarks
SWIFT is the trade name of S.W.I.F.T. SCRL. The following are registered trademarks of SWIFT:
the SWIFT logo, SWIFT, SWIFTNet, Sibos, 3SKey, Innotribe, the Standards Forum logo,
MyStandards, and SWIFT Institute. Other product, service, or company names in this publication
are trade names, trademarks, or registered trademarks of their respective owners.