Professional Documents
Culture Documents
20
This guide describes how to use Alliance Message Management to manage messages through Alliance Access through
the Alliance Web Platform. An Alliance Access operator can use Alliance Message Management to create, modify, verify,
and authorise messages, as well as search for messages, create reports, and send and receive batch files.
17 December 2021
Table of Contents
Preface............................................................................................................................................................... 6
1 SWIFT Training........................................................................................................................................ 7
6 Universal Confirmations....................................................................................................................... 45
8 Message Preparation............................................................................................................................ 47
8.1 Message Editor......................................................................................................................................47
8.2 Messages and Message Instances....................................................................................................... 51
8.3 General Message Structure...................................................................................................................52
8.4 Management of Messages.................................................................................................................... 53
17 December 2021 2
Alliance Access 7.6.20 Table of Contents
Message Management Guide
10 Message Creation..................................................................................................................................93
10.1 Create Messages...................................................................................................................................93
10.2 Create FIN Messages............................................................................................................................94
10.3 Create APC Messages........................................................................................................................ 100
10.4 Create MX Messages.......................................................................................................................... 101
10.5 Use Message Templates..................................................................................................................... 106
10.6 Create a Message from an Existing Message..................................................................................... 122
10.7 Fast Mode............................................................................................................................................123
10.8 Validate a Message............................................................................................................................. 126
10.9 Route a Message.................................................................................................................................130
10.10 Send a Message to a Queue (Dispose to)...........................................................................................131
10.11 File Message: Send.............................................................................................................................133
10.12 File Message: Get................................................................................................................................141
10.13 RMA Check Failure for File Messages................................................................................................ 148
12 Message Approval...............................................................................................................................162
12.1 Message Verification Page.................................................................................................................. 166
12.2 Message Verification............................................................................................................................168
17 December 2021 3
Alliance Access 7.6.20 Table of Contents
Message Management Guide
15 Operational Reporting.........................................................................................................................264
15.1 Ready-to-Use Reports.........................................................................................................................265
15.2 Terminology......................................................................................................................................... 278
15.3 Set Up and Manage the Reporting Data Store....................................................................................280
15.4 Manage Reports from the Reporting GUI............................................................................................ 286
15.5 Overview of the Reporting Command-Line Tool.................................................................................. 294
15.6 Manage Reports and Data from the Command Line........................................................................... 298
17 December 2021 4
Alliance Access 7.6.20 Table of Contents
Message Management Guide
17 December 2021 5
Alliance Access 7.6.20 Preface
Message Management Guide
Preface
Purpose
This guide describes how to perform business and administration tasks in Alliance Message
Management using the interface that is provided as a package for the Alliance Web Platform
Server-Embedded.
Audience
This guide is for operators who perform business and administration tasks using the Alliance
Message Management interface.
17 December 2021 6
Alliance Access 7.6.20 SWIFT Training
Message Management Guide
1 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 end 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 list 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 a mobile device. No installation is required.
SWIFTSmart is available to all connected SWIFT end 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 is available to meet specific training needs. For more
information, visit the Training web page.
17 December 2021 7
Alliance Access 7.6.20 Alliance Message Management
Message Management Guide
When applicable, operators can also consult, verify, authorise, and modify messages created by
back-office applications. Back-office applications can send a message as read-only, meaning that it
cannot be modified in Alliance Access.
Supported messages
Alliance Message Management supports FIN and APC messages (MT), Standards XML messages
(MX), FpML messages, and file messages (FileAct). When Alliance Message Management
connects to Alliance Access, messages with the format AnyXML and Proprietary can also appear
in queues, search results, or reports.
Operator permissions
The permissions defined in the profile of the operator determine the specific message processing
tasks that an operator can perform with Alliance Message Management.
Related information
The Alliance Message Management GUI on page 23
17 December 2021 8
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
When logged in to Alliance Message Management hosted on Alliance Web Platform Server-
Embedded, you can open a new browser window or tab (depending on browser configuration) by
using the browser's embedded options within a single session.
Your Alliance security officer defines the login method that you must use.
Procedure
Follow the steps in the appropriate procedure.
• Log in Using Two-Factor Authentication (TOTP) on page 9
• Log in Using an Identity Provider on page 13
• Log in Using a SWIFT Personal Token on page 17
• Log in Using a User Name and Password on page 19
Note Login with a user name and password without a second factor of authentication
must be avoided as it is not in line with the Customer Security Programme SWIFT
Customer Security Controls Framework Detailed Description.
Related information
Alliance Access Security Guide
Where:
- <host> is the Alliance Web Platform Server-Embedded host name
- <port> indicates the port number
It is not necessary to specify a value for <port> if the default port for HTTPS is used.
- swp refers to Alliance Web Platform Server-Embedded
17 December 2021 9
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
To optimally display the information in Alliance Message Management pages, set your screen
resolution to 1280 by 768 pixels or higher.
If you use the zoom functionality of the browser, then please note that the layout of Alliance
Message Management labels can be incorrect when the display value of the browser is not set at
100 percent.
Procedure
1. Start your browser.
2. Perform one of these actions to provide the URL for Alliance Message Management, as
applicable:
• Type the URL in the address bar of your browser and press ENTER.
• Select the URL from your list of saved links, for example, from Favourites or Bookmarks.
• Select the URL from the list of previously visited addresses.
3. The How would you like to login? window appears.
17 December 2021 10
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
7. Click Login .
Tip If you experience problems logging in, then delete the browser cache and try
again.
You can delete these files from the Tools menu or Options window. The exact
location depends on your browser type and release.
You have successfully logged in, when you see the Welcome page.
The Welcome page shows a list of shortcuts to tasks that are also available through the menus in
the navigation area.
The list of tasks available depends on your operator profile and the application group. The Alliance
Web Platform administrator configures an application group through the GUI application.
Tip When you log out of any browser tab or window, then the system will end any
sessions opened in the other remaining browser tabs or windows.
17 December 2021 11
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
Personal token
Personal tokens are small USB-based hardware devices that a user carries to authenticate access
to data or services. Personal tokens contain a pair of public and private keys which can be used for
cryptographic operations.
17 December 2021 12
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
2. Once your user name and password have been verified, a secret key from Alliance Access is
displayed.
3. Either scan the QR code with an authenticator mobile phone application or other software or
hardware authenticator tool or enter the string on the device manually.
Important Scan or save the key as quickly as possible. Do not leave it displayed on your
screen so that others can observe it.
4. Enter the code generated from your authentication device in the configuration screen, and click
Continue .
5. Alliance Access validates the credentials (user name, password, and authentication code).
If validation is successful, you are logged on.
If not, you can repeat the step with another authentication code. If you quit without entering the
authentication code, then you can set up two-factor authentication the next time you log in (you
will receive a new secret).
17 December 2021 13
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
Where:
- <host> is the Alliance Web Platform Server-Embedded host name
- <port> indicates the port number
It is not necessary to specify a value for <port> if the default port for HTTPS is used.
- swp refers to Alliance Web Platform Server-Embedded
- group/messagemgmt refers to Alliance Message Management
To optimally display the information in Alliance Message Management pages, set your screen
resolution to 1280 by 768 pixels or higher.
If you use the zoom functionality of the browser, then please note that the layout of Alliance
Message Management labels can be incorrect when the display value of the browser is not set at
100 percent.
Procedure
1. Start your browser.
2. Perform one of these actions to provide the URL for Alliance Message Management, as
applicable:
• Type the URL in the address bar of your browser and press ENTER.
• Select the URL from your list of saved links, for example, from Favourites or Bookmarks.
• Select the URL from the list of previously visited addresses.
17 December 2021 14
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
17 December 2021 15
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
6. You will be redirected to the IdP login page provided by your institution, where you must
provide your credentials.
For example:
Tip If you experience problems logging in, then delete the browser cache and try
again.
You can delete these files from the Tools menu or Options window. The exact
location depends on your browser type and release.
You have successfully logged in, when you see the Welcome page.
The Welcome page shows a list of shortcuts to tasks that are also available through the menus in
the navigation area.
17 December 2021 16
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
The list of tasks available depends on your operator profile and the application group. The Alliance
Web Platform administrator configures an application group through the GUI application.
Tip If you have configured your IdP server with a logout URL, when you log out of any
browser tab or window, then the IdP server will log you out from all the other groups
you are logged in on other browser tabs or windows.
Where:
- <host> is the Alliance Web Platform Server-Embedded host name
- <port> indicates the port number
It is not necessary to specify a value for <port> if the default port for HTTPS is used.
- swp refers to Alliance Web Platform Server-Embedded
- group/messagemgmt refers to Alliance Message Management
To optimally display the information in Alliance Message Management pages, set your screen
resolution to 1280 by 768 pixels or higher.
If you use the zoom functionality of the browser, then please note that the layout of Alliance
Message Management labels can be incorrect when the display value of the browser is not set at
100 percent.
Procedure
1. Start your browser.
2. Perform one of these actions to provide the URL for Alliance Message Management, as
applicable:
• Type the URL in the address bar of your browser and press ENTER.
• Select the URL from your list of saved links, for example, from Favourites or Bookmarks.
• Select the URL from the list of previously visited addresses.
17 December 2021 17
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
The Welcome page shows a list of shortcuts to tasks that are also available through the menus in
the navigation area.
17 December 2021 18
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
The list of tasks available depends on your operator profile and the application group. The Alliance
Web Platform administrator configures an application group through the GUI application.
Tip When you log out of any browser tab or window, then the system will end any
sessions opened in the other remaining browser tabs or windows.
The GUI displays warnings as follows:
• Token certificate expiry
The GUI displays a token certificate expiry warning when the expiration date is within the next
30 days.
For more information, see "Renew Token Certificate" in the Alliance Access Configuration
Guide.
• Token password expiry
The GUI displays a token password (PIN) expiry warning according to the token password
policy selected by your security officer during the DN creation process. For more information,
see "Personal Token Passwords" in the SWIFTNet PKI Certificate Administration Guide.
• Token is locked
The GUI displays a warning when the token is locked or when it is the last password attempt
before the token will be locked. The number of failed attempts before an account is locked is
also determined by the token password policy.
If the token is locked, then no other warnings are displayed.
Where:
- <host> is the Alliance Web Platform Server-Embedded host name
- <port> indicates the port number
It is not necessary to specify a value for <port> if the default port for HTTPS is used.
- swp refers to Alliance Web Platform Server-Embedded
- group/messagemgmt refers to Alliance Message Management
To optimally display the information in Alliance Message Management pages, set your screen
resolution to 1280 by 768 pixels or higher.
17 December 2021 19
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
If you use the zoom functionality of the browser, then please note that the layout of Alliance
Message Management labels can be incorrect when the display value of the browser is not set at
100 percent.
Procedure
1. Start your browser.
2. Perform one of these actions to provide the URL for Alliance Message Management, as
applicable:
• Type the URL in the address bar of your browser and press ENTER.
• Select the URL from your list of saved links, for example, from Favourites or Bookmarks.
• Select the URL from the list of previously visited addresses.
3. The How would you like to login? window appears the first time you log in from a given
browser.
17 December 2021 20
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
6. If multiple Alliance Access instances have been configured for the Alliance Web Platform
Server-Embedded host, then select the applicable instance from the Alliance Server Instance
drop-down list.
7. Click Login .
Tip If you experience problems logging in, then delete the browser cache and try
again.
You can delete these files from the Tools menu or Options window. The exact
location depends on your browser type and release.
You have successfully logged in, when you see the Welcome page.
The Welcome page shows a list of shortcuts to tasks that are also available through the menus in
the navigation area.
The list of tasks available depends on your operator profile and the application group. The Alliance
Web Platform administrator configures an application group through the GUI application.
Tip When you log out of any browser tab or window, then the system will end any
sessions opened in the other remaining browser tabs or windows.
17 December 2021 21
Alliance Access 7.6.20 Logging in to Alliance Message Management
Message Management Guide
Procedure
1. If you want to change your password on demand, then click the User: <name> menu in the
upper right corner of the navigation area.
There are three options displayed. Change Password, Session Info, and Time Zone.
2. Click the Change Password menu option.
The Change Password window appears.
3. Type your current password in the Old Password field. Then type your new password in the
New Password and Password Verification fields.
4. Click Change Password .
The password is changed.
17 December 2021 22
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management 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 Message Management, then the system
opens the Alliance Message Management online help.
17 December 2021 23
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
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 Message Management 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.
17 December 2021 24
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Alarm button
An alarm button is located on the top right of the page (in the Web Platform banner) and indicates
the number of alarms for action and information.
The alarm counter is increased and highlighted when there are new alarms not treated. The alarm
counter is also increased (and not highlighted) when there is a new alarm already treated.
When this button is clicked, it opens a pop-up window that displays the list of alarms. Each entry
has two buttons, to treat or dismiss the alarm.
Once an alarm is treated or dismissed, it is no longer counted in the alarms total.
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.
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
17 December 2021 25
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Variable Values
<symbol> + or -
You can enter both m and M. As the date field does not use minutes, the m is converted into M to
represent months. For example: +12m becomes +12M and represents 12 months in the future.
If you enter an incorrect character, then Alliance Access removes it automatically.
Examples
+6h or +6 Time Alliance Message Management increases the current time by six hours.
-7d or -7 Date Alliance Message Management sets the date to seven days before the
current date.
+0 or -0 Time Alliance Message Management sets the time to the current time.
+0 or -0 Date Alliance Message Management sets the date to the current date.
Date formats
To view the format of the data that a field requires, move the mouse over the picker icon or the
field.
17 December 2021 26
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
The Alliance Web Platform Server-Embedded administrator defines the date format that Alliance
Message Management displays. For information about how to change the default date format, see
"Alliance Web Platform Configuration Parameters" in the Alliance Web Platform Server-Embedded
Administration and Operations Guide.
The date picker supports these date formats:
Date From Time From Date To Time To Date From Time From Date To Time To
Result Result Result Result
• If the field already contains a value that uses the correct format and syntax, for example,
2012-04-18T15:13:43, then the picker is set to that date and time. Click the picker if you want
to change the value in this field to the current date and time or to select another date and time.
• If the field is set to a date that is not valid (for example, 2012-02-31T11:08:10), then the field
displays the error colour. If you then click the picker, then the field will be set to the current date
and time. One example of how the field can be set to a date that is not valid is if you manually
type an incorrect date.
• The Time drop-down list allows you to change the time.
• The Time Zone drop-down list allows you to select the offset from UTC (that is, the number of
hours deviation).
If you select a specific offset from UTC, then the picker formats the date and time accordingly.
For example, UTC -06:00 hours are represented as 2012-04-18T15:13:43-06:00.
17 December 2021 27
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
4.6.1 Pickers
Description
A picker is a graphical element that is located beside a field in some pages. It helps you to enter
data according to the correct syntax and format that the field requires.
If Alliance Message Management shows to the right of a field, then the picker lets you enter the
following types of information:
• a file name using the Choose File function
• data that is appropriate to the field, such as a date
Types of pickers
These are the different types of pickers available within Alliance Message Management:
• Date picker (see Date Picker on page 28 )
• Time picker (see Time Picker on page 30 )
• Picker for date, time, and time zone (see Picker for Date, Time, and Time Zone on page 31 )
• BIC picker (see Choosing a BIC on page 32 )
• Currency picker (see Currency Picker on page 34 )
17 December 2021 28
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Date formats
To view the format of the data that a field requires, move the mouse over the picker icon or the
field.
The Alliance Web Platform Server-Embedded administrator defines the date format that Alliance
Message Management displays. For information about how to change the default date format, see
"Alliance Web Platform Configuration Parameters" in the Alliance Web Platform Server-Embedded
Administration and Operations Guide.
The date picker supports these date formats:
17 December 2021 29
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Tip When you enter a date directly in the date field, you can omit the separator.
You can also enter a relative date, such as plus one month or minus five days. For
information about relative dates, see Behaviour and Format of Date and Time Fields
on page 26.
Example
Allowed values
The time picker enables you to select a time from a drop-down list, which is either on the hour or at
a half past the hour. To enter a more specific time, for example 10:13:45, you can enter it directly
in the time field.
When you enter a time, it is not necessary to include the colons, but you must include leading
zeros where applicable. For example, you can enter either 082500 or 08:25:00.
If you enter a time that does not follow this syntax, then the time picker ignores it and sets the field
to its default value.
Tip You can also enter a relative time, such as plus 1 hour, or minus 5 minutes. For
information about relative times, see Behaviour and Format of Date and Time Fields
on page 26.
17 December 2021 30
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
17 December 2021 31
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
• The Time Zone drop-down list allows you to select the offset from UTC (that is, the number of
hours deviation).
If you select a specific offset from UTC, then the picker formats the date and time accordingly.
For example, UTC -06:00 hours are represented as 2012-04-18T15:13:43-06:00.
Search criteria
The BIC picker enables you to enter a value in one or more search criteria and then click Search or
press ENTER to submit the criteria.
Choose the type required from the Type drop-down list:
• Institution
• Department
• Individual
Depending on the type of BIC required, the BIC picker offers these fields as search criteria:
Field Description
Institution Name To search based on the name of the institution or part of it.
This is a case-sensitive field. Wildcards can be used.
Branch To search based on the branch name of the institution or part of it.
This is a case-sensitive field. Wildcards can be used.
City To search based on the city name of the institution or part of it.
This is a case-sensitive field. Wildcards can be used.
Country Code To search based on the country code of the institution or part of it.
If lower-case letters are typed, then they are converted to upper-case letters. Wildcards
are not allowed.
17 December 2021 32
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Field Description
Note The wildcard % replaces one or more contiguous unknown characters in a string. The
wildcard _ replaces one unknown character.
Example
Related information
Online BIC Search
17 December 2021 33
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Example
17 December 2021 34
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Procedure
1. If you want to increase or decrease the width of a column in the list, then move the mouse
pointer over the right-side edge of the column header, then click and drag.
2. Repeat the previous step for the other columns in the list, as necessary.
3. Click Change View .
The Change View window opens.
4. Use these methods to change the list layout, as necessary:
• Select or clear the check box for a column to show or hide it.
• Click the name of a column and use the up or down arrow to change its position in the list.
Alternatively, you can drag and drop the column names to reorder them.
5. If you made any changes to the column widths in the current list, then select or clear the Save
Column Widths check box, as necessary.
If you select the Save Column Widths check box, then the system saves the changes to the
column widths and retains them in subsequent sessions.
If you clear the Save Column Widths check box, then the system discards the changes to the
column widths when the current session ends.
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.
17 December 2021 35
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
17 December 2021 36
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Output
You can use the Export 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.
• Count report
This report type shows the number of entities that match the search criteria provided, as well as
the criteria.
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 187.
Configuring the maximum number of entities in a report
To configure the maximum number of entities that can be displayed in a report, use the Alliance
Web Platform Server-Embedded administration parameter Maximum Number of Entities per
Report. If the number configured in this parameter is exceeded, you will receive the prompt:
Incomplete report: maximum number of entities - as currently configured - is
exceeded.
To avoid this situation, provide a higher value for this parameter. For more information on this
parameter, see Alliance Web Platform Server-Embedded configuration parameters in the Alliance
Web Platform Server-Embedded Administration and Operations Guide.
17 December 2021 37
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
Procedure
1. Click the Preferences link in the navigation area of the Alliance Message Management GUI.
The Preferences window opens.
17 December 2021 38
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
The fields in the window vary depending on the task window that was open when you clicked
the Preferences link.
2. To change the value of a setting, select the option you want from the drop-down list next to the
setting:
Date Format All Select either to use the default AWP server value, or a
specific format (for example, American or European).
You must restart the application for any changes to take
effect.
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 40.
Message New
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 40.
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. .
for Creation Message New
Print to File Creation: FIN, MX and APC When selected, the printed copy of the message goes
Message Template or to file. At print time, the user can modify the export
Message New settings and download the report.
Modification: all items When unselected, the printed copy of the message is
sent to the printer. At print time, the user can modify the
Approval: all items
font size, content, and the printer.
17 December 2021 39
Alliance Access 7.6.20 The Alliance Message Management GUI
Message Management Guide
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. .
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.
The setting for this preference does not affect
messages being authorised without viewing the
content. .
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 Creation, Modification, or Approval preferences are set.
APC
In reports obtained by clicking Export , this value is
Search and Report: FIN, used if the report type is Details and if the Display
MX and APC 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.
As well as the supported languages, the Server default
value is displayed. If this value is selected, the language
defined in the Expansion language global
configuration parameter will be used.
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.
This preference is displayed only when you select the
Message Search option.
This field is blank by default, but you can choose from
the drop-down list the name of a search criteria
template that is assigned to your unit.
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. Click OK to confirm the changes or Cancel to discard the changes.
17 December 2021 40
Alliance Access 7.6.20 UETR and SLA ID Fields in Alliance Access
Message Management Guide
17 December 2021 41
Alliance Access 7.6.20 UETR and SLA ID Fields in Alliance Access
Message Management Guide
For more information about the fields in the FIN message header, see Complete the Header of a
FIN or APC message on page 97.
Intermediary institutions
Alliance Access does not provide the feature to forward the UETR. The UETR is present in the
received message and must be passed on unchanged to the next message in the transaction
chain.
17 December 2021 42
Alliance Access 7.6.20 UETR and SLA ID Fields in Alliance Access
Message Management Guide
Auto-generate UETR System > Use this configuration parameter to deactivate Alliance Access
Configuration the automatic generation of the UETR. Configuration Guide
parameter
If you deactivate the Auto-generate UETR
parameter, then the MT 103 look-up feature is
ignored.
The default value is Yes.
MT 103 look-up System > Use this configuration parameter to specify per Alliance
Configuration 8-character BIC whether Alliance Access must AccessConfiguration
parameter find the related MT103 UETR when Guide
automatically generating the UETR of a MT 202
COV.
The default value is Yes.
Transfer UETR Message Partner This option indicates if Alliance Access must Alliance Access
Details Window: transmit the UETR field to the back office in the Configuration Guide
Configuration Tab > message partner transmissions.
Emission section
Important This option is not present for
message partners configured with
the data format XML because the
UETR is always transferred for this
data format.
For the following data formats, this
option is present and selected by
default:
• DOC/PCC
• MERVA/2
• RJE
• MQ-MT
17 December 2021 43
Alliance Access 7.6.20 UETR and SLA ID Fields in Alliance Access
Message Management Guide
Auto-generate SLA ID System > Alliance Access verifies if the SLA ID (field 111 in Alliance Access
Configuration block3) is populated for the FIN messages listed Configuration Guide
parameter in FIN Message Types with automatically
generated UETR on page 41.
If there is no SLA ID, then Alliance Access
generates and populates the value based on the
Auto-generate SLA ID configuration parameter.
By default, this feature is deactivated.
Configuration steps
1. Install the appropriate Message Syntax Table. See Install a New Message Syntax Table in the
Alliance Access Configuration Guide.
2. Assign the new Message Syntax Table to the Logical Terminals. See Modify the Syntax Table
Assigned to One or More Logical Terminals in the Alliance Access Configuration Guide.
3. Install the FIN SR <yyyy> for Message Management and Online Help package (linked to the
Message Syntax Table in step 1) that is available on the Download Centre.
4. Update the UETR and SLA ID Alliance Access configuration parameters and fields listed
previously, as appropriate.
Related information
Alliance Access/Entry: UETR Addition SWIFTSmart module
17 December 2021 44
Alliance Access 7.6.20 Universal Confirmations
Message Management Guide
6 Universal Confirmations
Starting November 2020, financial institutions must provide a confirmation to the Tracker on the
status of all incoming MT 103 messages, cross-border and domestic.
For more information, see Universal Confirmations in Alliance Access in the Alliance Access
Configuration Guide.
17 December 2021 45
Alliance Access 7.6.20 ISO 20022 Programme
Message Management Guide
17 December 2021 46
Alliance Access 7.6.20 Message Preparation
Message Management Guide
8 Message Preparation
Introduction
This section provides background information about the types of messages that an operator can
manage through Alliance Message Management.
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 Message Management 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 56
• FIN user-to-user messages Category Volumes: MT Message
Text Standards on page 68
the financial SWIFT MT
messages that allow you to
conduct transactions with your
correspondents on the SWIFT
network.
• FIN system messages
You send FIN system
messages to communicate
with the SWIFT organisation
and its user community.
APC (MT) System message only that allow Message Information for FIN and
you to communicate with the APC Messages on page 56
SWIFT organisation and its user
community.
File (FileAct) Send or receive files using the File Message: Send on page 133
FileAct service. and File Message: Get on page
141
Note Messages with the format FpML, AnyXML, or Proprietary may also be visible in some
queues. You cannot create such messages using Alliance Message Management, but
it is possible to open them when they are present in a queue. Alliance Message
Management displays a message with format FpML or AnyXML with the body text in
fast mode.
17 December 2021 47
Alliance Access 7.6.20 Message Preparation
Message Management Guide
Purpose
Alliance Message Management 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 135 or FileAct Details (Get) Window on page 143.
Note The Receiver field for FIN messages and Responder DN 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.
17 December 2021 48
Alliance Access 7.6.20 Message Preparation
Message Management 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 64
Some messages can have several sequences and subsequences. Within
a sequence, some fields are mandatory and some are optional.
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 50
11 Buttons that provide access to actions that you can perform on the Management of
message. Messages on page 53
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.
17 December 2021 49
Alliance Access 7.6.20 Message Preparation
Message Management Guide
For more information about these tabs, see General Message Structure on page 52.
• 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 Message Management 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 38.
Icon Purpose
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
17 December 2021 50
Alliance Access 7.6.20 Message Preparation
Message Management 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 Creation application, or when Alliance Access
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.
Copy instance
The routing software in Alliance Access 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.
17 December 2021 51
Alliance Access 7.6.20 Message Preparation
Message Management Guide
Alliance Access can create any number of copy instances from an original instance.
Notification instance
The routing software in Alliance Access creates a notification instance.
After the original instance is created and sent to a correspondent, Alliance Access can duplicate
the notification instance (ACK/NAK) of the message.
Alliance Access can create any number of notification instances from an original 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
17 December 2021 52
Alliance Access 7.6.20 Message Preparation
Message Management 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.
The data in the text block is usually structured into a
predefined sequence and format, as determined by SWIFT's
message standards. For FIN/APC messages, the text is in
block 4 of the message.
The payload of the message is carried in the application
header and in the body of the message. In the body of the
message, the data is stored as a Document element, which
also identifies the XML schema for the message.
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 Access must comply with the Standards MT and Standards
MX. For more information, see Help about Message Standards on page 64.
17 December 2021 53
Alliance Access 7.6.20 Message Preparation
Message Management 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 Creation application in Alliance Message
Management. This creates an original instance of the message.
For more information, see Message Creation on page 93.
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 Message Management.
• 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 and Routing on page 55.
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 Message
Management.
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.
17 December 2021 54
Alliance Access 7.6.20 Message Preparation
Message Management Guide
For more information about how Alliance Message Management validates a message, see Validate
a Message on page 126.
Message queues
Alliance Access holds a message instance in a message queue according to the current status of
the message.
17 December 2021 55
Alliance Access 7.6.20 Message Preparation
Message Management Guide
The _MP_creation queue holds message templates, but Alliance Access 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.
You can change the default message queue settings in Alliance Access Configuration. For more
information, see routing in the Configuration 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 Access 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 Access 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:
• Route a message to the next logical queue, according to the routing rules.
For information about routing rules, see queues in the Configuration Guide.
• 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.
There are restrictions on the methods that you can use to move a message. Details are given in
the next section.
17 December 2021 56
Alliance Access 7.6.20 Message Preparation
Message Management Guide
Most trailers are computed and attached automatically to the end of the message. They do not
normally appear as part of the message. The only exception is the PDE (Possible Duplicate
Emission) trailer, which is added to a message, at the sender's request, to indicate to the recipient
that the same transaction may already have been conveyed in an earlier message.
A PDE trailer is usually added if the sender is unsure whether a previous message was actually
sent to the recipient, for example, following an application system failure. On receipt of a message
with a PDE trailer, the recipient will try to match the transaction to an earlier message, for example,
by reference to the TRN. If none is found, then the message containing the PDE trailer is
processed as normal. If a duplicate transaction is found, then the message with the PDE trailer is
discarded.
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 Access.
"O" - means an output message, that is, a message output from a network to
Alliance Access.
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.
ID 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 either the Transaction Reference Number (TRN) as given in field 20 of the
message, or the Message User Reference (MUR) extracted from the User Header
block of the message, in SWIFT format. This reference may be up to 16 characters
in length. The exact form of reference used - TRN or MUR - is determined during the
installation of SWIFT Message Syntax Tables into Alliance Access.
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.
17 December 2021 57
Alliance Access 7.6.20 Message Preparation
Message Management Guide
17 December 2021 58
Alliance Access 7.6.20 Message Preparation
Message Management 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 Access. "O"
means an output message, that is, a message output from a network to Alliance
Access.
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 This is a maximum of 30 characters and contains the "Request Reference" (equivalent
to the TRN or MUR for a SWIFT MT message). It is extracted from the
mesg_user_reference_text.
Example: IGEBABEBBXXX007myref
17 December 2021 59
Alliance Access 7.6.20 Message Preparation
Message Management Guide
</camt.007.001.01>
</Document>
Overview
Alliance Access is responsible for formatting an MX message payload in an expanded form.
Payloads in UTF-8 encoding are accepted.
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.
17 December 2021 60
Alliance Access 7.6.20 Message Preparation
Message Management Guide
BICs in messages
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.
ISO 9362 allows alphanumeric values for the first 4 characters in the BIC, but SWIFT has
implemented a more restrictive structure in message types only allowing alphabetic indications for
the party prefix (BIC format 4!a2!a2!c[3!c] ). SWIFT, as registration authority, has no plans to issue
BICs with numeric characters in the first 4 characters.
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 about the BIC format and use of the BIC in SWIFT messages, see the BIC
Policy on swift.com.
17 December 2021 61
Alliance Access 7.6.20 Message Preparation
Message Management Guide
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).
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.
17 December 2021 62
Alliance Access 7.6.20 Message Preparation
Message Management 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
17 December 2021 63
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
17 December 2021 64
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
The following is an example of the message help for a FIN message, MT 103:
17 December 2021 65
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
17 December 2021 66
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
MX keywords
When you search for MX messages, you can provide values for the fields that are defined as MX
keywords. Alliance Message Management 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 Access database.
If the configuration parameter, MX Keyword Extraction is set to Off, then keywords are not
extracted from incoming MX traffic.
17 December 2021 67
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
17 December 2021 68
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
The format specifications are the rules for the layout of the message type. This information is
provided in a table 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.
17 December 2021 69
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
17 December 2021 70
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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.
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.
17 December 2021 71
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
• Lower case "a" next to the field tag number indicates that there are different formats available to
capture the information for this field. When this field is used in an MT, a specific format must be
indicated by replacing the lower case "a" with an upper case letter option.
An upper case letter next to the field tag number refers to the format option that will be used for
validating this field.
• 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 Message Management.
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.
17 December 2021 72
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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.
- Subfields and/or components must consist of at least one meaningful character.
• If a field content contains mandatory and optional subfields, then at least all of the mandatory
subfields must appear when that field is used.
• The specification of field or subfield content may consist of:
- restrictions on the length of field or subfield content, using the descriptions listed in
Restrictions on Length on page 73
- special formats, for example, for numbers and dates
- codes, for example, currency codes
(See the BIC Plus, which is available for download from www.swiftrefdata.com.)
• In some messages, the field specifications may indicate specific characters, or sets of
characters, for inclusion in the text of the field.
These take the following forms:
- codes, for example, AMEND, TRF, or 08
- slash / or double slash //
- slash or double slash followed by a code, for example, //CH or /FIXED
- slash followed by a code and another slash, for example, /REC/
Note All codes must be in uppercase alphabetic characters. When codes contain a mix of
alphabetic and numeric characters, the alphabetic character must also be in
uppercase.
Restrictions on Length
Restrictions on length Types of Characters Allowed
17 December 2021 73
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
Examples
2n up to 2 digits
17 December 2021 74
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
9.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
17 December 2021 75
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
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).
17 December 2021 76
Alliance Access 7.6.20 Help about Message Standards
Message Management 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
17 December 2021 77
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
Valid Invalid
: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
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.
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 '/'.
17 December 2021 78
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
Definition
Identifier code such as a BIC. Optionally, the account of the party.
Network validated rules
Identifier Code must be a registered BIC (Error codes T27, T28, T29 and T45).
[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.
17 December 2021 79
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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 '/'.
17 December 2021 80
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
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.
17 December 2021 81
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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.
17 December 2021 82
Alliance Access 7.6.20 Help about Message Standards
Message Management 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
17 December 2021 83
Alliance Access 7.6.20 Help about Message Standards
Message Management 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.
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.
17 December 2021 84
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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.
17 December 2021 85
Alliance Access 7.6.20 Help about Message Standards
Message Management 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:
- 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.
17 December 2021 86
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
Definition
Identifier code of the party with mandatory account number.
Network validated rules
Identifier Code must be a registered BIC (Error codes T27, T28, T29, and T45).
Definition
Name and address of the party with a mandatory account.
Definition
Identification of the party.
Codes
In option J, Party Identification must be specified as a list of pairs (Code)(Value) and one or more of
the following codes and formats must be used (Error code(s): T78).
The codes must be placed between slashes ('/').
17 December 2021 87
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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/NAME/BRANCH B OF THE(CrLf)
Definition
Name and address of the party, with an optional account.
17 December 2021 88
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
Definition
Identification of the party
Field assigned to this option
50L
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.
17 December 2021 89
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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.
Definition
Identification of the party, with a qualifier and name.
Definition
Identification of the party, with a qualifier and names.
17 December 2021 90
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
9.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
Example
ACKed NAKed
:32A:061130USD1, :32A:611130USD1,
:30:181130 :30:791130
17 December 2021 91
Alliance Access 7.6.20 Help about Message Standards
Message Management Guide
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 2015) is selected for value date ordering of the
message. Error code T50 is returned after an invalid value date.
17 December 2021 92
Alliance Access 7.6.20 Message Creation
Message Management Guide
10 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 Message Management 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.
For more information about message editor forms, see the following sections:
• Message Editor on page 47
• FileAct Details (Send) Window on page 135
• FileAct Details (Get) Window on page 143
Message standards help
If the online help for message standards is installed, then help about the fields in a message is
available from Alliance Message Management. See Help for Messages on page 64.
17 December 2021 93
Alliance Access 7.6.20 Message Creation
Message Management Guide
17 December 2021 94
Alliance Access 7.6.20 Message Creation
Message Management 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.
17 December 2021 95
Alliance Access 7.6.20 Message Creation
Message Management Guide
2. Select a logical terminal from the Sender Logical Terminal drop-down list.
The value entered for the Sender Logical Terminal field by an operator when creating a
message is automatically saved. It is proposed as the initial value when the same operator
creates another message.
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 (installed) MY FIN message standards are displayed in the FIN Category list, next to the
name of the installed base FIN message standards. Although a My FIN message standard can
contain different FIN messages categories, the FIN Category field is not renamed.
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.
Tip For more information about how to use the message editor, see Message Editor
on page 47.
5. Enter the values for the fields in each tab:
• Complete the Header of a FIN or APC message on page 97
• Complete the Body of a FIN or APC Message on page 99
• Define the Network of a FIN or APC Message on page 100
• Complete the Comments, if any. Comments can contain a maximum of 500 characters.
6. Next, take the appropriate action:
Export Creates a report of the message. Report Types and Settings (Export
Function) on page 36
Print Prints a report directly from the GUI. Print a Report Directly from the
GUI on page 36
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 111
or perform another action.
New Fast With this mode, you can choose how tags Fast Mode on page 123
are displayed when creating messages,
either All Tags or Mandatory Tags.
This button is not available for locked
templates.
17 December 2021 96
Alliance Access 7.6.20 Message Creation
Message Management Guide
Fast / Prompted Allows you to create the body of an MT Fast Mode on page 123
message in fast or prompted mode.
Route Routes a valid message according to the Route a Message on page 130
routing rules defined within Alliance Access.
Note Online help for the message is also available (see Help for Messages on page
64). The online help is based on the information in the User Handbook and
explains how to complete specific fields.
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 Alliance Access Configuration 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.
17 December 2021 97
Alliance Access 7.6.20 Message Creation
Message Management Guide
In order to use an alias, the Message Creation, Can create broadcasting permission is
required. For more information on creating messages by using an alias, see Knowledge Base
tip 22392.
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 Message Management
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 Message
Management does not display values in 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 Access.
11. In the Options part, click Priority to select the priority of the message on the network. In the
absence of user-specified delivery criteria, system messages are always delivered first,
followed by messages with urgent priority, and then messages with normal priority.
12. From the Monitoring list, select an option for monitoring the delivery of the message:
• For messages with normal priority
None for no monitoring
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.
17 December 2021 98
Alliance Access 7.6.20 Message Creation
Message Management Guide
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.
16. Optional: If you have activated the Auto-generate SLA ID parameter, then the SLA ID field is
populated automatically.
The SLA ID is the service type identifier. For gpi, this field identifies which SWIFT gpi service
the sender is subscribed to.
For more information about the Auto-generate SLA ID parameter, see the Alliance Access
Configuration Guide.
17. UETR field: By default, for certain FIN messages, Alliance Access generates automatically a 36
character alphanumeric unique end-to-end transaction reference (UETR) after you route or
dispose the message. Alternatively, you can click Generate . If you do this, then you will see the
UETR before you route or dispose the message.
You can edit this field only during message creation or in message modification.
You can deactivate the automatic generation of the UETR using the Auto-generate UETR
parameter. See the Alliance Access Configuration Guide.
See also UETR and SLA ID Fields in Alliance Access on page 41.
Procedure
1. Complete all mandatory fields.
2. Complete any optional fields as needed.
Related information
Fast Mode on page 123
17 December 2021 99
Alliance Access 7.6.20 Message Creation
Message Management Guide
Page example
The following is an example. The list of standards that are installed in your institution may differ:
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.
Print Prints a report directly from the GUI. Print a Report Directly from the
GUI on page 36
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 111
or perform another action.
Fast / Prompted Allows you to create the body of an MX Fast Mode on page 123
message in fast or prompted mode.
Route Routes a valid message according to the Route a Message on page 130
routing rules defined within Alliance Access.
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 Access instance.
Note The Requestor DN and Responder DN fields may already contain default values
configured during the installation of the message standards using the Alliance
Access/Entry Configuration GUI.
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 or 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. You cannot edit the Identifier field or the MessageIdentifier field.
6. If the Usage Identifier field is empty, then you can edit this optional field.
7. Complete the User Ref field (optional).
8. 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.
9. Signed field. You can select Yes or No, or leave the field empty.
The default value depends on the application service profile.
10. 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 173 and section Authorise a Message on page 176.
11. The Delivery Mode field cannot be edited and shows the delivery mode of the message being
created.
12. 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.
13. Notification Required field (only for messages sent using store-and-forward delivery). You can
select Yes or No, or leave the field empty.
14. 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.
15. 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.
16. 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.
17. 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.
18. 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).
You can correct the message template by clearing the contents in the automatic fields.
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 check box 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.
Page example
Button description
Change View Allows you to select the columns to be displayed and number of rows to be
displayed.
Mark as Locked Marks a normal template as locked. If the security parameter Msg Templ
Approval is set to Yes, then the template becomes unapproved locked. This
button is available to operators with the Mesg Creation, Add/Mod/Rem
Templ, Locked = Yes permission.
This functions is not available for APC messages.
Unmark as Locked Unmarks a locked template. If confirmed, all fields are unlocked. As a result,
the template becomes unapproved normal. This button is available to
Approve Template Only displayed if the Msg Templ Approval security parameter is set to Yes.
Approves an unapproved locked/normal template. As a result, the template
becomes approved. This button is available to operators with the Mesg
Creation, Add/ Mod/ Rem Templ permission. Only operators with the
Locked = Yes permission detail can approve a locked template.
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 114.
Status If the Msg Templ Approval security parameter is set to Yes, the value is
either: Locked/Approved (for approved locked templates), Locked / Not
Approved (for unapproved locked templates), Approved (for approved
normal templates), or Not Approved (for unapproved normal templates).
if the Msg Templ Approval security parameter is set to Yes, the value is
either: Locked (for locked templates), or blank (for normal templates).
Display Name The message standard (either base or MyStandards) assigned to messages
in the list.
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
• 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.
Export Creates a report of the message. Report Types and Settings (Export
Function) on page 36
Print Prints a report directly from the GUI. Print a Report Directly from the GUI
on page 36
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 111
or perform another action.
New Fast With this mode, you can choose how tags are Fast Mode on page 123
displayed when creating messages, either All
Tags or Mandatory Tags.
This button is not available for locked
templates.
Unlock Allows you to unlock the message, if your Locked Message Templates on
operator profile detail Mesg Creation / page 107
Create Message with the From locked
templates only detail is set to No.
If you unlock a message, then all the fields
are no longer locked and it is not possible to
return to a locked state.
Fast / Prompted Allows you to create the body of an MT or Fast Mode on page 123
MX message in fast or prompted mode.
These buttons are not available for locked
templates.
Route Routes a valid message according to the Route a Message on page 130
routing rules defined within Alliance Access.
Bulk operations
By doing the bulk processing, you can avoid having the pop-up every time you open a template
that is still resolved with a previous message standard.
In the Message Management GUI package you can:
• Do a bulk resolution of templates.
• Do a bulk simulation resolution of templates to see which ones will be properly resolved and
which ones will require manual intervention. As a result you will have a report available in your
userspace with the list of templates that were in the simulation and the corresponding simulated
result.
• When importing an exported set of templates from (an) older FIN Standards Release(s), it is
possible that Alliance Access is unable to fully convert the template in accordance with the new
message syntax. In such cases, the template will only appear in Fast mode. The template then
either needs to be updated in Fast mode by adding/removing/modifying the relevant fields or
manually recreated from a new FIN message (which is saved as a template)
• If you are uncertain about the MSTV ID version that is currently assigned to your message
template, then you can also export your templates and open the exported file in your favourite
editor. Locate the desired template within the export file using the mesg_template_name field.
Once you have located the template entry, check the text_swift_prompted field and if it starts
with XML#. If so, then this template has been migrated to the Message Management format,
otherwise it is still in the Workstation format:
• If you are uncertain if a template has been converted to the Message Management format (if
you cannot open/access a template export), you can open the template in the Message
Management GUI. If no Information window appears informing you that the content of the
template will be migrated, then it has already been converted:
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 114.
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
• Usage Identifier
• Delivery Mode
6. Next, take the appropriate action in the following table.
Table of actions
Export Creates a report of the template. Report Types and Settings (Export
Function) on page 36
Print Prints a report directly from the GUI. Print a Report Directly from the GUI
on page 36
New Fast With this mode, you can choose how tags are Fast Mode on page 123
displayed when creating templates, either All
Tags or Mandatory Tags.
This button is not available for locked
templates.
Approve Allows you to approve the locked template, if Locked Message Templates on
the security parameter Mesg Templ page 107
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 Fast Mode on page 123
MX message in fast or prompted mode.
These buttons are not available for locked
templates.
If you are modifying a message template, then save the template to confirm the migration.
Message entry can continue.
2. If there is no schema with a more recent version, then an error message informs you that the
message description could not be found. Message entry cannot continue: refer to your Alliance
Message Management administrator to install the correct message standards.
Permissions required
In order to use the Add as button, you must have the Mesg Creation, Create Message permission.
In addition, you must have the permission(s) required to view all details of a message in the
Modification, Approval, and Search and Report application groups. In addition, you must have the
permissions required to route or dispose the message to the required destination queue.
Handling of standards, Deployment Packages, Universal Standard Archive (USA) packages, and
verifiable fields
When creating a new MT message with Add as , Alliance Access assigns to the new MT message
the FIN Standards that is assigned to the logical terminal that is assigned to the message. If
necessary (that is, if the FIN Standards is not the most recent one), the new message is migrated
as a prerequisite, whether the source message resides in a queue or in Message Search, similar to
when creating a message from a template. See Migration of FIN and MX Message Templates on
page 121 for more information about migration.
When creating a new MX message with Add as , Alliance Access assigns to the new MX message
the current deployment package or USA package that corresponds to the service/request type of
the source message. If necessary, the new message is migrated as a prerequisite, whether the
source message resides in a queue or in Message Search.
In support of MT and MX message verification and user-defined verifiable fields, when a new MT or
MX message is created using Add as , the Mesg_needs_verification field of the new message is set
to Yes if the Web Platform deployment package active at that moment indicates that it contains
verifiable fields. Otherwise, this field is set to No, as in the case of File messages, for which this
functionality is not available.
For more information on verifiable fields, see Message Verification on page 168.
For FIN messages, fast mode presents the message body as plain text, that is, the original string
representation.
For MX messages, fast mode presents the message body as a beautified XML representation
(assuming that discrete XML elements can be parsed) or possibly as a mixture of beautified XML
and plain text.
Note You cannot create FIN System Messages (MT 0nn messages), or APC messages in
fast mode.
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 64. 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.
Example - MX message
Message is The Validation Report tab displays errors Go to Step 2 on page 127.
invalid and warnings.
Note Warnings do not prevent a message from being routed within Alliance Access.
2. You can review the errors or warnings in the Validation Report.
The validation report displays errors received from SWIFTNet or found locally:
Column Description
Location Location of the error, such as the application header or the body of the message
Node The Node column displays the name of the field that contains the error. This
name is the last node of the XPath.
For MX messages only
Message For MX messages, you can view the full XPath expression if you hover over the
Message column. The XPath is shown only if the error is in the Application
Header or the Body of the message.
SWIFTNet errors may no longer be relevant after the message has been
modified.
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.
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 123
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 131.
• Click Close Message , to discard the message. A draft of the message is not saved.
Note For information about validation of File messages, see RMA Check Failure for File
Messages on page 148.
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 Message Management performs a validation of the XML structure of the payload in an MX
message. The validation also 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.
• Syntax and semantic validation for the enhanced deployment packages and Universal Standard
Archive packages
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:
• there are errors in the DN for requestor or responder
• your operator permissions do not allow the service name
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
an exit point If the preferred network of the correspondent is APPLI, then the list of queues
also displays the exit points that are available for routing messages to the
correspondent.
If the network in the Network tab is set to APPLI, the exit point must be
specified in the Target Exit Point for Message Disposal field in the same tab.
Other This queue is available if _OI_to_OTHER is a valid routing target. For more
information, see the Queue Details window: Routing Info tab in the
Configuration Guide.
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 Access moves the message to a selected queue (except for the Text Modification
queue), Alliance Message Management 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.
Note For Alliance Message Management connected to Alliance Access, a FIN message
with an alias representing several receivers cannot be disposed.
The Message Details are also accessible from the File Transfer Details window. To save
the file, click Save File from the Message Details window.
• From the Search and Report menu > File Transfer Monitoring, select a file message and
save the payload file from the File Transfer Details window by clicking Save File .
Note If a SWIFTNet service is configured to delete FileAct payload on message completion
for that service, the payload of File messages for that service is deleted upon
message completion, for example, when all instances of that message are completed.
If a SWIFTNet service is configured to archive FileAct payload for that service, the
payload of File messages for that service is archived with the message. As a result,
the payload is also included in archive backups and restored when the message
archives are restored. This is visible in the Message Search application of Message
Management, where you can successfully request to save the payload of a File
message (using the Save File button on the Message Details, File tab) even if the
message has already been archived (and backed up or not, but not removed) or
restored, provided the archive took place with Alliance Access or later.
Overview
The File Message: Send page displays a list of the FileAct messages for transferring a file to
correspondents.
From this page, you can perform the following tasks:
• create a FileAct message to send a file to a correspondent, and save the message as a
template
• view, select, edit, and delete FileAct message templates
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.
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 Access 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
Settings appear.
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.
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.
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.
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 135
• File: see FileAct Details Window (Send): File Tab on page 138
• 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 141
schema
Note In the context of real-time file get functionality (whether triggered by means of the
Manual FileAct GUI or the saa_rtfilegetrequest tool), the Authoriser DN permission
detail has been added to the SWIFTNet Interface, RT File Get Request permission.
See the Alliance Access Security Guide for more information.
• From the Search and Report menu > File Transfer Monitoring, select a file message and
save the payload file from the File Transfer Details window.
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 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.
Unit The unit that is assigned to the operator must match the unit
that is assigned to the File: Get message.
(1) The Payload tab displays the message details and is available through the File Transfer Details window.
Procedure
1. From the Creation menu, select File Message: Get.
The File Message: Get 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> (Get) window opens.
• If not, click New . The FileAct Message Details (Get) window opens.
3. Enter the message details in the tabs:
• Header: see FileAct Details Window (Get): Header Tab on page 144
• File: see FileAct Details Window (Get): File Tab on page 145
• Comments: if you want to, you can enter comments about the message.
4. To save the message as FileAct message template, do the following:
a) Click Save as template .
The Save as template window opens
b) Type the name of the message template.
Tip The name must be unique for a given unit.
If the message was created from an existing template with the same value for
Unit, then Alliance Message Management proposes a name for the template.
c) Click OK .
Note The only field that is mandatory for a FileAct message template is Unit. The other
fields can be empty.
5. To send the request to download the file, click Get .
RMA validation occurs. The outcome is as follows:
• If RMA validation succeeds, then the File Transfer Details window opens. For more
information about how to monitor file transfers, see File Transfer Monitoring on page 242.
• If there is an RMA check failure, then a pop-up window appears. Click Cancel . Correct the
data and perform the action again. For more information, see RMA Check Failure for File
Messages on page 148.
• If RMA validation fails but you ignore the message and click OK , then an Error pop-up
window opens. The error message explains why the file message is invalid and asks you to
correct the data and perform the action again.
6. For more information about how to monitor file transfers, see File Transfer Monitoring on page
242.
You can abort the file transfer if needed by clicking Abort .
7. You can save the payload file to a local directory by clicking Save File .
Alternatively, you can:
• Save the payload from the message details. Click the Payload tab from the File Transfer
Details window or go to the Search and Report menu > Message Search, do a search on
messages and select a file message to open the Message Details, then from the File tab,
click Save File .
• Save the payload from the file transfer details. Go to the Search and Report menu > File
Transfer Monitoring, select the file message and save the payload file from the File
Transfer Details window.
If the file message is not available yet in the Alliance Access database, then Save File and the
Payload tab is unavailable.
What to do next
Route the FileAct message by using the Routing Code ManFileAct.
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.
11 Message Modification
Introduction
By default, if Alliance Access 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 Access 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
Access:
• Text Modification
• Emission Security Modification
• Reception Security Modification
• Modification for Transmission
• Modification after Reception
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
These sentences are only visible in the Validation tab when the message is re-opened.
After modifying the message, if you attempt to save the changes (by clicking Route or Dispose ),
before trying to save the changes in the database, Alliance Access first performs its own duplicate
detection on the message, based on the latest values as displayed in the GUI. This check occurs
only if there has been a change to a field that is included in the digest calculation or if the message
was already a duplicate as detected by Alliance Access.
If the message is detected to be a duplicate according to its criteria, Alliance Access displays a
Duplicate detected by interface warning in a pop-up window. You are prompted to either
continue or cancel the message processing. If you click Cancel , Alliance Access does not try to
route or dispose the message. If you click OK , the message processing continues.
List example
The example that follows shows a list of messages held in the Text Modification queue:
Change View Allows you to select the columns to be displayed and number of rows to be
displayed.
Add As Adds a message based on the currently selected message, if not locked.
Open Opens the message. Enables you to see the contents of the header,
application heade, body of the message, and any operator comments.
Complete Completes the selected message and removes it from the list.
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.
Display Name Identifies the base or MyStandards standard assigned to the message.
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 service type identifier that is used for services such as gpi (field
111 in the MT header).
Status Indication of whether the message is locked (if not, the entry in this column is
blank).
Format The format of the message (for example, Swift, MX, or File).
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
Access) by a user
Interface detected dup A message that Alliance Access has identified as duplicate by means of
its duplicate detection mechanism.
Inst Creator Name of the operator who created the message instance.
Inst Creation
The creation date and time of the message instance.
Inst Last Modifier Name of the last operator who modified the message instance.
Message Description The name of the message. For MT and MX messages, the Message
Description field contains the Display Name of the message type.
Status Indication of whether the message is locked (if not, the entry in this
column is blank).
The list shows the name of the selected queue and includes various attributes for each
message. For a description of these attributes, see Message Modification Page Example on
page 152.
2. If needed, refine the list using filtering criteria. For details, see Filter a List of Messages in a
Queue on page 155.
You can open a selection of multiple messages in any of the GUIs of the Message Modification
and Message Approval application groups of the Message Management package. When
opening a selection of multiple messages, the first message of the selection is opened. When
you close, route, or dispose that first message, you are prompted to either open the next
message of the selection or to return to the list of messages. This happens for all messages in
the selection until the last message is reached, in which case you are automatically returned to
the list of messages.
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 156
• Emission Security Modification, see Messages in the Emission Security Modification Queue
on page 158
• Reception Security Modification, see Messages in the Reception Security Modification
Queue on page 159
• Modification for Transmission, see Messages in the Modification for Transmission Queue on
page 161
• Modification after Reception, see Messages in the Modification After Reception Queue on
page 161
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 (Export Function) on page 36.
8. Click another message to be modified or perform any other available task.
You can use the following wildcards in the I/O, Correspondent, Identifier, and Reference fields:
• ''_'', to replace one unknown character
• ''%'', to replace zero, one or more contiguous unknown characters
When filtering for Correspondent or Reference, the use of the "%" wildcard is not recommended,
because the filter results may not be as expected.
Check the Match Case box if you want to restrict the search to the messages matching the case of
the value entered in the Reference field.
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 ",".
Procedure
1. From the Modification menu, select the queue that you want. The page for the selected queue
appears with the list of messages currently held in that queue.
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.
being a duplicate. Are you sure you want to continue?. Click OK to continue or Cancel
to cancel the operation.
Note You can use fast mode to modify messages in this queue.
Messages held in the Text Modification queue can also be completed, that is discarded. For details,
see Complete Messages on page 157.
To save a message in this queue as a template, click Save as Template . You are prompted to enter a
name for the new template (which can be a duplicate name if you choose). Click Save . When the
template is created, you can continue editing the details of the source message. To further modify
or delete the template just created, you must use the Create/Edit template applications and
screens.
Example
Here is an example of the validation report for a FIN message that has been opened from this
queue:
Message authorisation
Alliance Access 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 Access 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.
Here is an example of the Validation Report for a FIN message which was opened from this queue:
visible in the SWIFTNet Options area of the reception appendix. If a received message failed
authentication, then first investigate the problem. You may decide to bypass security for the
message.
SWIFTNet Copy
When the SWIFTNet Copy destination's Alliance Access receives an InterAct Partial Copy
message, the SWIFTNet partial copy digest is available in the appendix of the xcop message
received from SWIFTNet.
When you open the message in the Reception Security Modification queue, the Validation Report
tab displays an information or warning message:
• passed the partial copy digest verification
• bypassed the partial copy digest verification
• did not pass the partial copy digest verification due to invalid digest
If you decide to bypass security, then the Partial copy Digest Result field in the Interventions tab
is updated with the value PartialCopy_Bypassed.
For more information about SWIFTNet Copy, see the Alliance Access Configuration Guide.
Message authorisation
Alliance Access uses business relationships from RMA to authorise messages received. If the
message needs to be authorised using RMA, then Alliance Access 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. 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. During the reauthorisation, the RMA
Check Service is also filled with the service coming from the ASP.
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 check box to the left of the message
and click Open then perform one of the following actions:
• Bypass Security
• Route
• Dispose to the Modification for Transmission queue (see Messages in the Modification for
Transmission Queue on page 161)
4. If you select the message without opening it
Select the check box to the left of the relevant message or messages and perform one of the
following actions:
• Authenticate
• Bypass Security
Note Depending on security practices at your institution, you or another operator with
appropriate permissions may decide to bypass security for the message so that
processing can continue. When you bypass security for a message, Alliance Access
routes it according to the defined routing rules, but without authentication.
Alternatively, it may be necessary to complete a message that failed authentication
(after moving it to the Text Modification queue).
12 Message Approval
Introduction
Approval can include three tasks:
• Verify MT and MX messages, that is, verify the accuracy of certain fields, such as currency or
amount.
• Authorise messages, that is, perform a visual check on the messages before sending them to
the network input queue.
• Recover FIN, InterAct, or FileAct messages and initiate actions to route a message, complete a
message instance, or move a message instance back to the original queue.
You can generate a report of the details of a message that is opened from the recovery
investigation queue. For more information, see Report Types and Settings (Export Function) on
page 36.
Note Messages with format FpML or AnyXML can potentially appear in the authorisation
queue. Such messages can be opened using fast mode.
GUI View Action Single Permission check for Permission check for Permission check for
Applicatio type or FIN InterAct FileAct
n multipl
e
messa
ges
Message List view Reject S Mesg Approval, Approve Mesg Approval, Approve Mesg Approval, Approve
Verificatio Message, Own Message, Own Message, Own
n Destination(s)/ Can Destination(s) for InterAct Destination(s) for InterAct
Verify/ Verify own entered & FileAct (DN)/Service $ & FileAct (DN)/Service $
msg/ Ccy-amount/ identifier - InterAct identifier - FileAct
Message types messages/ Can Verify/ messages/ Can Verify/
Verify own entered msg/ Verify own entered msg
AND
Ccy-amount/
AND
(Mesg Approval, Route
AND
Messages, Own (Mesg Approval, Route
Destination(s) OR Mesg (Mesg Approval, Route Message, Own
Approval, Approve Message, Own Destination(s) for InterAct
Message, Group Destination(s) for InterAct & FileAct (DN)/Service $
Authorise) & FileAct (DN)/Service $ identifier - FileAct
identifier - InterAct messages OR Mesg
messages OR Mesg Approval, Approve
Approval, Approve Message, Group
Message, Group Authorise)
Authorise)
GUI View Action Single Permission check for Permission check for Permission check for
Applicatio type or FIN InterAct FileAct
n multipl
e
messa
ges
Details Reject S Mesg Approval, Approve Mesg Approval, Approve Mesg Approval, Approve
view Message, Own Message, Own Message, Own
Destination(s)/ Can Destination(s) for InterAct Destination(s) for InterAct
Verify/ Verify own entered & FileAct (DN)/Service $ & FileAct (DN)/Service $
msg/ Ccy-amount/ identifier - InterAct identifier - FileAct
Message types messages/ Can Verify/ messages/ Can Verify/
Verify own entered msg/ Verify own entered msg/
AND
Ccy-amount/
AND
Mesg Approval, Route
AND
Message, Own Mesg Approval, Route
Destination(s). Mesg Approval, Route Message, Own
Message, Own Destination(s) for
Destination(s) for InterAct/FileAct Message/
InterAct/FileAct Message/ Service $ identifier -
Service $ identifier - FileAct messages
InterAct messages
Message List view Authorise/ S Mesg Approval, Approve Mesg Approval, Approve Mesg Approval, Approve
Authorisat Reject Message, Own Message, Own Message, Own
ion Destination(s)/ Can Destination(s) for InterAct Destination(s) for InterAct
Authorise/ Auth own & FileAct (DN)/Service $ & FileAct (DN)/Service $
entered msgs/ Auth own identifier - InterAct identifier - FileAct
verif msgs/ Ccy-amount/ messages/ Can messages/ Can
Message types/ Trans Authorise/ Auth own Authorise/ Auth own
app limit, Daily app limit. entered msgs/ Auth own entered msgs/ Auth own
verif msgs/ Ccy-amount/ verif msgs/ Trans app
AND
Trans app limit, Daily app limit, Daily app limit.
(Mesg Approval, Route limit.
AND
Message, Own
AND
Destination(s) OR Mesg (Mesg Approval, Route
Approval, Approve (Mesg Approval, Route Message, Own
Message, Group Message, Own Destination(s) for InterAct
Authorise) Destination(s) for InterAct & FileAct (DN)/Service $
& FileAct (DN)/Service $ identifier - FileAct
identifier - InterAct messages OR Mesg
messages OR Mesg Approval, Approve
Approval, Approve Message, Group
Message, Group Authorise)
Authorise)
GUI View Action Single Permission check for Permission check for Permission check for
Applicatio type or FIN InterAct FileAct
n multipl
e
messa
ges
Details Authorise/ S Mesg Approval, Approve Mesg Approval, Approve Mesg Approval, Approve
Reject Message, Own Message, Own Message, Own
Destination(s)/ Can Destination(s) for InterAct Destination(s) for InterAct
Authorise/ Auth own & FileAct (DN)/Service $ & FileAct (DN)/Service $
entered msgs/ Auth own identifier - InterAct identifier - FileAct
verif msgs/ Ccy-amount/ messages/ Can messages/ Can
Message types/ Trans Authorise/ Auth own Authorise/ Auth own
app limit, Daily app limit. entered msgs/ Auth own entered msgs/ Auth own
verif msgs/ Ccy-amount/ verif msgs/ Trans app
AND
Trans app limit, Daily app limit, Daily app limit.
Mesg Approval, Route limit.
AND
Message, Own
AND
Destination(s) Mesg Approval, Route
Mesg Approval, Route Message, Own
Message, Own Destination(s) for InterAct
Destination(s) for InterAct & FileAct (DN)/Service $
& FileAct (DN)/Service $ identifier - FileAct
identifier - InterAct messages
messages
Message List view Authorise/ S Mesg Approval, Treat Mesg Approval, Treat Mesg Approval, Treat
Recovery Reject Recovered Msg, Own Recovered Msg, Own Recovered Msg, Own
Destination(s) Destination(s) for InterAct Destination(s) for InterAct
& FileAct (DN)/Service $ & FileAct (DN)/Service $
AND
identifier - InterAct identifier - FileAct
(Mesg Approval, Route messages messages
Message, Own
AND AND
Destinations OR Mesg
Approval, Treat (Mesg Approval, Route (Mesg Approval, Route
Recovered Msg, Group Message, Own Message, Own
Authorise) Destination(s) for InterAct Destination(s) for InterAct
& FileAct (DN)/Service $ & FileAct (DN)/Service $
identifier - InterAct identifier - FileAct
messages OR Mesg messages OR Mesg
Approval, Treat Approval, Treat
Recovered Msg, Group Recovered Msg, Group
Authorise) Authorise)
GUI View Action Single Permission check for Permission check for Permission check for
Applicatio type or FIN InterAct FileAct
n multipl
e
messa
ges
Details Route (S) Mesg Approval, Treat Mesg Approval, Treat Mesg Approval, Treat
view Recovered Msg, Own Recovered Msg, Own Recovered Msg, Own
(=authoris
Destination(s) Destination(s) for InterAct Destination(s) for InterAct
e)
& FileAct (DN)/Service $ & FileAct (DN)/Service $
AND
identifier - InterAct identifier - FileAct
Mesg Approval, Route messages messages
Message, Own
AND AND
Destination(s)
Mesg Approval, Route Mesg Approval, Route
Message, Own Message, Own
Destination(s) for InterAct Destination(s) for InterAct
& FileAct (DN)/Service $ & FileAct (DN)/Service $
identifier - InterAct identifier - FileAct
messages messages
If the details of a message are opened in prompted (or fast) mode, when moving to the details of
the next message using Next , the details of the next message are also displayed in the same
prompted (or fast) mode.
These sentences are only visible in the Validation tab when the message is re-opened.
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 service type identifier that is used for services such as gpi.
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.
Display Name The message standard (either base or MyStandards) assigned to messages in
the Verification queue.
Identifier The message identifier that uniquely identifies the message type.
SLA ID The applicable service type identifier that is used for services such as gpi (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).
Inst Creator Name of the operator who created the message instance.
Inst Creation The creation date and time of the message instance.
Inst Last Modifier Name of the last operator who modified the message instance.
Inst Last Modification The date and time of the last modification of the message instance.
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
Access) by a user
Interface detected dup A message that Alliance Access has identified as duplicate by means of
its duplicate detection mechanism.
Messages to be verified
Messages in the verification queue are retrieved according to their priority. System Messages
(APC) are listed first, followed by urgent priority messages, and then normal priority messages.
The following criteria in your Alliance Access operator profile determine which messages are
presented to you for verification:
• Units assigned to you
• Sender Logical Terminal
• Message Type
• Currency code
• Amount
• Verify own entered message
Note If No validation is defined in the Reception parameters of a message partner
profile, then the list of messages in the Message Authorisation page may include
messages that your operator profile forbids based on certain keywords. For example,
if you are limited to an amount of N, messages with amounts greater than N may
appear in the list of messages. This happens because keywords are not extracted
from the message when the validation level is No validation.
Verifiable fields
The FIN message standards determine which fields are verifiable for a given MT message. For
more information, see Help about Message Standards on page 64.
The Standards (or official) definition of verifiable fields for MX messages is provided by the SWIFT
Standards department, and the Message Management Deployment Packages and Universal
Standards Archive packages delivered by SWIFT to customers contains the official definition of
verifiable fields for MX standards.
Note As opposed to MT messages, for which most message types have verifiable fields,
only a few MX service/request type standards will initially have verifiable fields.
Typically, the fields that you can verify include the following kinds of information:
• currency
• amount
• value date
Tip The XPath expression of a field can be copied and pasted from the field-level help that
is available when creating a new message of that type. The operator can target ALL of
the instances of a repeated field by removing the [n] in the path. In addition, qualifier
values can contain (or be replaced by) wildcards, such as *.
Both mandatory and optional fields can be defined as verifiable. When a optional field defined as
verifiable field is not present and is moved to the verification queue, the optional (empty) field is not
displayed as there is no value to be retyped in/verified.
When saving their changes, operators overwrite the verifiable fields of that particular MT or MX
message standard in the Message Management Deployment Packageor Universal Standards
Archive (USA) package. Changes to verifiable fields take effect immediately on all MT/MX
messages that arrive in the verification queue.
Verifiable fields for a message and service that are contained in both a USA business message
and a Deployment Package message are shared. If you install both packages and you edit a
verifiable field, then the updated field is visible in both the USA package and the Deployment
Package.
Operators can add or remove verifiable fields in any MT or MX standard irrespective of whether or
not the message is enterable and irrespective of whether or not the default standard from SWIFT
contains verifiable fields for that MT or MX standard.
If a new version of a FIN MT or MX standard is installed and contains a different set of verification
fields than the set of verifiable fields (including user-defined verifiable fields) contained in the
previous version of the standard, the previous version is not updated (and retains its set of
verifiable fields) and the new version is installed with its own set of verifiable fields. The new
version is not automatically updated with the previous set of user-defined verifiable fields.
Alliance Access also supports the definition of verifiable fields in some MX and MT message
header fields, including:
• For MX messages:
- Requestor DN
- Responder DN
- User Reference
• For MT messages:
- Receiving Institution
- MUR
The definition of verifiable fields by operators does not require four-eyes approval.
Related information
Verify a FIN, APC, or MX Message on page 171
Messages shown as reserved (that is, having a name in the Open By column) are already
open by other operators. This prevents concurrent updates because another operator cannot
open a reserved message.
2. If needed, filter the list of messages. For more information, see Filter a List of Messages in a
Queue on page 155.
3. Click the message that you want to verify.
The message editor displays the message as follows:
• Only some fields in the message body can be verified. Verifiable fields are empty.
Fields that require verification are highlighted in the colour selected for mandatory fields in
Preferences.
• Non-verifiable fields are displayed as originally entered, and you cannot change their
values.
• Optional fields that were empty in the original message no longer appear in the message.
4. Complete the verifiable fields with the same data as entered by the message creator.
If there are differences, then message verification fails and a Validation Report is generated
when routing or disposing the message. Try to provide the correct data again and route or
dispose the message.
You can toggle to fast mode by clicking the Fast button, which is located between the Validate
and Route buttons. The verifiable fields are shown as '####', and if you have the relevant
permission, you can re-enter values in them, which are then shown in clear. After you have re-
entered values in the verifiable fields in fast mode, you cannot return to prompted mode. If you
modify something else than the verifiable fields, the operation is denied.
Tip If you cannot correct the errors, then select one of the following:
• Select Text Modification beside Dispose to , to move the message and edit it
later.
• Click Reject , to route the message with an indication of failure.
5. Optionally, select the Comments tab and add your comment.
Export Creates a report of the message. Report Types and Settings (Export
Function) on page 36
Route Routes a valid message according to the Route a Message on page 130
routing rules defined within Alliance Access
A notification message appears in the Status
area.
Reject The message is sent to the Text Modification Rejecting a message in the
queue by default, or to another routing queue verification queue enables you to
defined in the routing in Alliance Access. move syntactically incorrect MT or
MX messages that cannot be
Optionally, add a comment with more
handled in the verification queue
information for the rejection.
to the text modification queue.
Dispose to Sends the message to a queue that the Send a Message to a Queue
operator chooses: (Dispose to) on page 131
• Text Modification, where an operator can
fix the message
• Authorisation, sends the message to the
Authorisation queue
• Swift, sends the message to SWIFTNet
A notification message appears in the Status
area.
A confirmation appears to indicate that the message was successfully routed or disposed.
The list of messages for verification appears. Open another message to verify or select any
other task available.
Procedure
For the steps to verify a FileAct message, see Verify a FIN, APC, or MX Message on page 171.
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 service type identifier that is used for services such as gpi.
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.
Display Name Identifies the base or MyStandards standard assigned to the message
Identifier The message identifier that uniquely identifies the message type.
SLA ID The applicable service type identifier that is used for services such as gpi (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
Inst Creator Name of the operator who created the message instance.
Inst Creation The creation date and time of the message instance.
Inst Last Modifier Name of the last operator who modified the message instance.
Inst Last Modification The date and time of the last modification of the message instance.
Message The name of the message. For MT and MX messages, the Message
Description Description field contains the Display Name of the message type.
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
Access) by a user
Interface detected A message that Alliance Access has identified as duplicate by means of
dup its duplicate detection mechanism.
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.
You can also open a message and reject it using Reject . To reject a group of messages without
viewing their content, you require the Mesg Approval, Approve message, Can verify, Group
authorise permission/permission detail. On the other hand, to reject a single message, this
permission detail is not required.
Note If No validation is defined in the Reception parameters of a message partner
profile, then the list of messages in the Message Authorisation page may include
messages that your operator profile forbids based on certain keywords. For example,
if you are limited to an amount of N, messages with amounts greater than N may
appear in the list of messages. This happens because keywords are not extracted
from the message when the validation level is No validation.
The list shows various attributes for each message. For a description of these attributes, see
Message Authorisation Page on page 173.
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 155.
3. Do you want to view the message before you authorise or reject it? Choose the appropriate
step:
• Yes: go to Step 5 on page 177
• No: go to Step 4 on page 177
4. Select the checkbox of the left of the message or messages, in the Message Authorisation
page.
Choose the appropriate action:
• Click Authorise .
A confirmation window appears. Click OK to authorise the message.
A message appears in the Status area to confirm that the message was successfully routed.
• Click Reject . The message is sent to the Text Modification queue by default, or to another
routing queue defined in the routing in Alliance Access.
The Message Authorisation page appears with the list of messages. Open another message
to authorise, and repeat this procedure, or select another task.
5. Click the message to view the message details. Review the content of the message and verify
that the data is correct.
The message editor displays the message.
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 126.
6. To view the body of the message in fast mode, click Fast .
The body of the message appears in fast mode.
To return to prompted mode, click Prompted .
7. Optionally, click the Comments tab and add your comment.
8. Next, take the appropriate action. You authorise a valid message if you route it or if you dispose
it to the Swift queue.
Export Creates a report of the message. Report Types and Settings (Export
Function) on page 36
Validate Validates the message format. Validate does Validate a Message and Correct
not appear if you are in fast mode. Errors on page 126
Route This button authorises the valid message Route a Message on page 130
and routes it according to the routing rules
defined within Alliance Access.
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 131
dispose the message to Swift.
• Text Modification, where an
operator can fix the message
• Swift, sends the message to SWIFTNet
A notification message appears in the Status
area.
Page example
Correspondent The receiver of the message. The wild cards % and _ are accepted.
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.
From BIC Enables you to enter a BIC. The wild cards % and _ are accepted.
FINCopy Service Suggests values of the FIN Copy services from the FIN Copy Alliance Access
table or 'None'. By default, the field is left empty. If the field is empty, the
messages that are returned are those messages that meet the other filtering
criteria (regardless of whether they are for a FIN Copy service). If the field is
set to 'None', then only messages for non-FIN Copy services are returned.
This criterion is only applicable to FIN messages.
SLA ID Service Level Agreement (SLA) identifier in the MT header: field 111. This field
identifies the service type identifier that is used for services such as gpi.
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 service type identifier that is used for services such as gpi.(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.
Cur/Amt The currency code and amount of the transaction (for FIN messages only).
Value Date The date on which the transaction is to be completed (for FIN messages only).
Last Change Name of the last operator who modified the message
Last Verify Name of the last operator who verified the message.
Additional columns
The columns that follow can also be shown in the list using Change View :
Inst Creator Name of the operator who created the message instance.
Inst Creation The creation date and time of the message instance.
Inst Last Modifier Name of the last operator who modified the message instance.
Inst Last Modification The date and time of the last modification of the message instance.
Message Description The name of the message. For MT and MX messages, the Message
Description field contains the Display Name of the message type.
ACK/NAK Reception The date and time of the receipt of the notification instance (ACK/NAK),
Date/Time in GMT.
SnF Input Time The store-and-forward input time, if this delivery mode was used.
See Permission checks for approving and rejecting messages on page 162.
Procedure
1. From the Approval menu, select Message Recovery.
The Message Recovery page appears with a list of messages in the recovery queue. For
more information, see Message Recovery Page on page 178.
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 155.
3. Click the message that you want to view.
The message editor displays the message:
• Optional fields that were left blank in the original message no longer appear.
• Fields that contain information are displayed as originally entered, but the content cannot be
changed.
4. You can generate a report of the message. Click Export . For more information about generating
a report, see Report Types and Settings (Export Function) on page 36.
5. Review the message to ensure that it is correct.
Choose the appropriate action:
• Click Route to send the message instance directly to the appropriate network input queue.
• Click Complete to complete the message instance. For more information, see Message
Instances on page 230.
Procedure
1. From the Approval menu, select Message Recovery.
The Message Recovery page appears with a list of messages in the recovery queue. For
more information, see Message Recovery Page on page 178.
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 155.
3. Select the relevant message or messages by checking the box on their left. You can then
perform one of the following actions:
• Click Authorise to send the message instance directly to the addressee through appropriate
network input queue.
• Click Reject .
CAUTION In Message Recovery, if you click Reject , then the message instance is also
sent directly to addressee through the appropriate network input queue . If you
want to change this behaviour, then you must modify the routing rules in
Alliance Access .
• Click Complete to complete the message instance. For more information, see Message
Instances on page 230.
• For disaster site recovery
Click Move to Original if the original queue is defined. The message is moved to the original
queue.
A status window briefly appears that confirms the message was successfully routed. To view
the content of this window again after it closes, click Status .
Retrieval process
1. The user sends an xsys.015.001.01 or xsys.015.001.02 Retrieval Request, which specifies the
retrieval criteria and the store-and-forward queue to which the retrieved messages or files and
optional Retrieval Report are to be queued. The user can also make a manual retrieval request
outside of Alliance Access, using SWIFTNet Online Operations Manager.
xsys.015.001.02 is used for InterAct and FileAct retrievals. xsys.015.001.02 contains an
element to specify the scope of the retrieval: FILE, MESG, or ALLL
A single xsys.015.001.01 or xsys.015.001.02 Retrieval Request can retrieve a range of
SWIFTNet messages or files sent or received in a given 24-hour period. If retrievals are
needed over a longer period of time, then multiple retrieval requests must be sent.
2. SWIFTNet store-and-forward processes the Retrieval Request. Retrieved messages and files
are queued to the queue specified in the Retrieval Request.
Note Retrieval Requests are not always processed immediately. Some time may elapse
between when the Retrieval Request is sent, and the availability of the retrieved
messages and files.
3. If the optional Retrieval Report has also been requested, then SWIFTNet store-and-forward
queues the xsys.016.001.01 Retrieval Report to the specified queue.
If the Retrieval direction is input, then Alliance Access applies the own destination
permission on the sender of the message.
If the Retrieval direction is output, then Alliance Access applies the own destination
permission check on the receiver of the message.
To search for instances and templates, you must first specify the search type in the Source and
Creation tab.
When searching for messages and instances in the Source and Creation tab, you can also refine
your search in the Instances Location tab.
When you click on a row in the search results list, the Message Details page opens (see Message
Details Page on page 197). Depending on what you are searching for, a series of actions can be
taken on the search result.
I am searching for Search criteria options Actions that can be taken Actions that can be taken
from the search results list on a search result
Messages Search by ID and Content on page • Change View You can take the following
210 actions within all tabs in the
• Sorting
Message Details:
Search by Source and Creation on • Export
page 223(1) • Export
• Print
Search by Instances Location on • Print
page 227 • Add as: create a new
Search by Transmission Details on message from an existing
page 225 one
I am searching for Search criteria options Actions that can be taken Actions that can be taken
from the search results list on a search result
Instances Search by Source and Creation on Based on your operator profile You can take the following
page 223(2) and the state of the instance, actions within all tabs in the
you can take the following Message Details:
Depending on the state of the
actions:
instance (Live, Completed, or • Export
Reserved), you can refine your • Change View
• Print
search in the following tabs: • Sorting
• Find Related: displays the
Search by ID and Content on page • Refresh following:
210
• Change Priority - details for an MX
Search by Instances Location on message
page 227 • Re-assign
• Re-activate (if it was - For MT 103s, Alliance
completed in the detail Access finds the
Instance tab) related MT199 (based
on the shared UETR)
• Complete that contains the
• Move to confirmation for the
MT103.
• Cancel Emission
If you open the
• Change Expiry Date Time MT199 , then it will
• Instance Export also find the related
MT103.
• Instance Print
For more information, see
Message Instances on page
230.
Templates Search by Source and Creation on • Change View You can take the following
page 223(3) actions within all tabs in the
• Sorting
Message Details:
Refine your search for templates • Export
in the following tab: • Export
• Print
Search by ID and Content on page • Print
210
Within the Instances tab, you
also take the following
actions:
• Change View
• Re-assign
• Instance Export
• Instance Print
2. Specify search criteria by completing the fields as needed. See Specify Search Criteria on
page 209 for details. You can also use a search criteria template to perform a message search.
See Save Search Criteria as Template on page 228 for details.
Provide search criteria as needed so that the messages returned are a useful subset.
Search criteria that you specify remain until you change or clear the information, which allows
you to refresh the list without having to re-key criteria. Click Clear if you want to remove the
criteria previously provided and enter new criteria.
Click Export (next to Search ) in the Message Search Criteria to generate a report of
messages matching the search criteria that you entered. You are advised to generate a Count
report because this report function includes all messages in the Alliance Message
Management, see Generate a Message Count Report on page 261 for details.
If you have the Message File, Count permission, click Count (next to Search ) in the Message
Search Criteria to display in a pop-up the number of messages meeting the search criteria.
The associated search results are not displayed. The messages that are counted are filtered
based on your Message File, Count permission details.
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).
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 259 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
5. 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 197.
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 259 to select and generate
a report of one or more messages from this page.
6. To save a payload file for a File message, click the File tab then click Save File . Your operator
profile must have the following permission set: Message File / Open/Save File.
Note Save File is only available if at least one instance of the message has a unit in
common with the units assigned to your operator profile.
7. 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.
the column name and use the arrows to change its position in your search results. Click OK to
save your view.
Mesg Description A description of the message. For MT and MX messages, the Message
Description field contains the Display Name of the message type.
SLA ID The service type identifier (field 111 in the MT header) that is used for
services such as SWIFT gpi.
MX A user reference
MUR Message User Reference extracted from the User Header in block 3 of a
FIN message
Related Reference Contains the Related Reference of FIN messages (usually field 21 of an
MT 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.
The field is extracted based on the deployment package that is loaded for
the message/service combination.
Alliance Access only displays the value of the Value Date field if you are a
member of a unit to which at least one of the message instances is
assigned. If this requirement is not met, then the value has asterisks
(*****), and if you produce a message details report, the value is not
printed. For more information about assigning units, see the Configuration
Guide.
The Value Date field is not populated when the message is coming from a
message partner where No validation level is used.
Messages that are assigned to a unit to which you belong are displayed
first.
Messages without currency/amount are shown before those with currency/
amount.
Alliance Access only displays the value of the Currency/Amount field if
you are a member of a unit to which at least one of the message instances
is assigned. If this requirement is not met, then the value has asterisks
("*****"), and if you produce a message details report, the value is not
printed. For more information about assigning units, see the Configuration
Guide.
The Currency/Amount field is not populated when the message is coming
from a message partner where No validation level is used.
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.
Transaction Data The code that indicates the completeness of the generated message by
Result the transaction manager at SWIFT based on the central transaction data.
• Success: the translation of the ISO 20022 message was successful.
• Partial
• Truncation Non Ref: truncation or character replacement occurred in
non-reference fields.
• Truncation Ref: truncation or character replacement occurred in
reference fields.
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 225.
Netw. Status The timestamp of the network ACK or NAK in GMT for FIN and MX
Timestamp (GMT) messages. This is the same value as provided on the Message Details
page, History tab.
Orig Inst RP The queue or routing point in Alliance Access 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
Access) by a user
Interface Detected A message that Alliance Access 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
Logical File Name The value of SwLogicalName which is part of the AckMessage sent to
SWIFT by Alliance Access when it receives a file.
Payments Control
Info For Receiver
Payment Status Contains the value of the Payment Confirmation Status : Empty (no
payment confirmation status), Accepted, Pending, Rejected, Returned, or
Invalid. If you select None, then Alliance Access lists all messages without
a confirmation status.
Page example
Page description
For multi-format messages, indicates the primary and secondary format, the
translation result, and the translation result details (in case of errors).
For MX messages, the Usage Identifier field displays the RequestSubType.
For messages generated by the transaction manager, the code that indicates
the completeness of the message is displayed along with the Transaction data
version.
For subscribers to Transaction Screening, Sanctions compliance - Message
blocked indicates that the Transaction Screening service has flagged the MX
message instance as a true hit. The header also contains the field Transaction
Screening Info for Receiver provides information from the Transaction
Screening service about the decision on the screened message. Only applicable
to output messages.
For subscribers to Sanctions Screening, Sanctions compliance - Message
blocked indicates that Sanctions Screening or Transaction Screening has
flagged the MT message instance as a true hit. For more information about
configuration for Sanctions Screening, see the Configuration Guide.
You can display help for MX keywords of a message that is opened from
searching (see Help for Messages on page 64).
Sender/ Contains details of the sender and the receiver of the message.
Receiver tab
When you click Show Recipients in the Recipients field, the list of recipient
DNs to which a message or file is distributed is displayed. It also indicates
whether the list can be made public to all recipients. On the reception side, the
field Public Recipients List is always set to No. However, the list of recipient
DNs is displayed. This field is not applicable for FIN messages.
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 Message Management was able to retrieve the message
messages sent definition of the response (Deployment Packageor Universal Standards Archive
only) (USA) package installed) and the response is valid according to its 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.
For MT, MX, and File messages, the History tab shows information related to
RMA checks along with the service and the result. For example, RMA Check
for service swift.fin with result Success.
For InterAct Partial Copy, the partial copy digest result for output messages is
displayed: Success, Failure, or Bypassed.
For multi-format messages (MX and MT), this tab shows Multi Format
Message Signed with result, following by the Translation Digest Result. This
information is not displayed if the translation failed.
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.
Alliance Access automatically displays the date and time for each event. To
remove the date and time, you can change the parameter Date/Time in Msg
History. See Message in the Alliance AccessConfiguration Guide.
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. For more
information, see Cancel Message Instance Emissions on page 237
Other tab Contains further information about the message, including the following:
• For MT 103s: Payment Confirmation Status, Confirmed Amount,
Confirmed Currency, and Confirmed Date
These fields are displayed only if the Payment Confirmation Status
contains a value, that is when the payment has been confirmed to the
Tracker with an MT 199 or there is a CSV status update. If a payment has
not been confirmed by an MT 199 or a CSV, then these fields will not be
visible.
If the MT 199 sent to the Tracker is NAKed by the network, then the
Payment Confirmation Status information is emptied, and these fields are
not visible.
If the MT 199 is ACKed by the network, but it fails validation at the Tracker
level and the Tracker sends back an Alert MT 199, then the Payment
Confirmation Status is set to Invalid, Confirmed Amount and
Confirmed Currency are cleared, and the Confirmed Date is replaced by
the date included in the Alert MT 199 from the Tracker.
• The message priority
• The number of signatures required by the messageif the Enforce NRS Sign
global system security parameter is set to Yes
• For FIN and MX messages, the ACK/NAK Reception field displays the date
and time in GMT when the ACK or NAK was received from SWIFT or
SWIFTNet.
This tab also contains information related to emissions, such as:
• Expiry Date Time, which indicates the date and time after which Alliance
Access 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 Access will not attempt to send a real-time FileAct or InterAct
message to SWIFTNet. This field provides information about the Alliance
Access retry logic only, which regularly recalculates the sending interval to
maximise the chance of sending the message successfully.
You can set an emission expiry date and time in either of the following ways:
• By setting an emission expiry date and time directly in each real-time FileAct
or InterAct message submitted to Alliance Access through a message
partner. In this case, the emission expiry date and time apply only to that
specific message. This is only possible through message partners whose
connection method is based on XMLv2.
• By defining an emission expiry time in the message partner. In this case, the
emission expiry time applies to a date and time to all real-time FileAct and
InterAct messages received from that message partner. The date and time
are calculated as follows: the absolute date and time of the message
creation in the database plus the value of the Emission Expiry field at the
message partner (which is a relative value in hours and/or minutes
Properties tab This tab is displayed if a message has a message property or user-defined
routing keyword assigned to it. It contains all of the message properties defined,
the name of the message properties and user -defined routing keywords, and
their value.
Monitoring tab If a File message has any instance whose transfer over SWIFTNet is on-going,
(File messages this tab contains the same information as the File Transfer Details view (which
only) is obtained when launching the File Transfer Monitoring application and double-
clicking a row in the list of file transfers). However, only the Abort button is
available, which is subject to the same permissions as when used in the File
Transfer Monitoring application. For more information on the File Transfer
Monitoring application, see File Transfer Monitoring on page 242.
Viewing this tab requires the Monitoring permission.
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 on page 208.
messages;
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 (Export Function) on page 36.
Print Prints a report directly from the GUI. For more information, see Print a Report
Directly from the GUI on page 36.
Page description
Instances No. MX
Type MT/MX
Session
MT/MX
Number
Unit MT/MX
Input
Message Input Reference for MT MT
Reference
Input
Message Input Reference for MX MX
Reference
Message Reference
Swift
MX
Reference
Swift Request
MX
Reference
Signing DN MX
Signature
MX
Result
Signature
MX
Method
Non-
SwiftNet Options Repudiation MX
Setting
Delivery
Notification MX
Request
Receiver
MX
Delivery Status
Delivery/Cancellation Network
MX
Status Delivery Status
Sender
MX
Delivery Status
Appl/Serc
Date/Time
The opposite also applies. If you opened a message for which the value of the MX Keyword 2 field
matches the value of the MX Keyword 1 field for another message, then it is that other message
that appears on this tab.
The Find Related button appears on all tabs that display message details for an MX message sent
using store-and-forward delivery.
Procedure
1. Display an MT 103 and its related MT 199 (or an MT 199 and its related MT 103,) or an MX
message that was sent using store-and-forward delivery.
2. Click the Find Related button.
Alliance Message Management retrieves any related messages and refreshes the content of
the message that appears.
Note This refresh presents the initial view of all tabs. For example, if you were on the
Instances tab and had opened a particular message instance or an intervention
for an instance before clicking Find Related , the content of the Instances tab would
be refreshed with the instances list.
3. Click a message displayed on the Related Messages tab. Alliance Message Management
opens it and displays its details instead of the details of the message that you opened from the
list.
4. After you view details of a message or a related message, close the message or navigate
within the list.
If you click Previous or Next , then Alliance Message Management displays details of the
previous or next message in the list relative to the one that you opened from the list.
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 %.
You can select a MyStandards message standard to restrict the search to
messages associated with that particular MyStandards standard.
When you select FIN as the standard, all messages assigned to either a
FIN base or FIN MyStandards message standard are in the scope of the
search. When you select a FIN MyStandards message standard, only the
FIN messages assigned to that FIN MyStandards standard are in the
scope of the search.
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 ",".
The RequestSubType of the MX message, which contains an
identification of the validation expected to be performed by sender,
receiver and SWIFT, if Message Validation (MVal) applies.
Translation Result. To search for translated messages.
File File message only Service. You can enter a service code 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
The RequestSubType of the MX message, which contains an
may have arrived with
identification of the validation expected to be performed by sender,
an unrecognised format
receiver and SWIFT, if Message Validation (MVal) applies.
Translation Result. To search for translated messages.
Proprietary Messages in a Identifier. Enter a message identifier to filter upon. This is a free-text field
proprietary format that accepts the wildcards _ and %.
Other Standard ... Service. You can enter a service code 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 %.
The RequestSubType of the MX message, which contains an
identification of the validation expected to be performed by sender,
receiver and SWIFT, if Message Validation (MVal) applies.
Translation Result. To search for translated messages.
For Solutions that you MX messages The Service is automatically filled in to correspond to the MX message
have implemented standard that you select.
If you select a specific message from the Message Name drop-down list,
then the Identifier is automatically filled in.
When you select an MX base message standard as the standard, all
messages assigned to that base message standard, as well as any MX
MyStandards message standard corresponding to that base standard, are
in the scope of the search. When you select an MX MyStandards
message standard, only the MX messages assigned to that MX
MyStandards standard are in the scope of the search.
The RequestSubType of the MX message, which contains an
identification of the validation expected to be performed by sender,
receiver and SWIFT, if Message Validation (MVal) applies.
Translation Result. To search for translated messages. See the following
table.
Translation Result
Transaction Data
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.
Type Enter the message type that is the object of the search (for example,
103). It must be a three-digit number.
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.
Message Property A message property that has been This is a suggest field, which contains
assigned to an instance. the names of all message properties
injected by Integration Platform (IPLA)
that exist in the messages stored in the
Alliance Access database.
The field also displays user-defined
keywords in messages stored in the
Alliance Access database. Alliance
Access refreshes the user-defined
keywords when you update or modify a
message. See also Add a Routing
Keyword in the Alliance Access
Configuration Guide.
Value The value assigned to a Message Type the value of the message property.
Property. If you specify only the wildcard % in this
field, all messages that have at least one
instance of that message property are
returned, regardless of the value set for
that message property. This is a free text
field with a maximum of 512 characters
allowed.
Amount From and To A range of amounts Amount range search criteria can be
used without having to provide a
currency criteria
Search Text A string contained in the message Type a string, which must begin and end
with %.
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".
SLA ID The Service Level Agreement (SLA) The service type identifier that is used
identifier for services such as gpi (field 111 in the
MT header).
Payments Control Info For Receiver This field provides information to the Use information from field 434 (block 3).
receiver from the Payment Controls
The format of field 434 is:
service about the screened message.
/<code-word>3!a/
[<additional-information>20x]
Message Property A message property that has been This is a suggest field, which contains
assigned to an instance. the names of all message properties
injected by Integration Platform (IPLA)
that exist in the messages stored in the
Alliance Access database.
The field also displays user-defined
keywords in messages stored in the
Alliance Access database. Alliance
Access refreshes the user-defined
keywords when you update or modify a
message. See also Add a Routing
Keyword in the Alliance Access
Configuration Guide.
Value The value assigned to a Message Type the value of the message property.
Property. If you specify only the wildcard % in this
field, all messages that have at least one
instance of that message property are
returned, regardless of the value set for
that message property. This is a free text
field with a maximum of 512 characters
allowed.
Copy MX, File, or Any Messages Select the check box to include copy
messages, including SWIFTNet
Does not display for Internal
InformCopy (InterAct message only)
Requester DN The requester DN Type the requester 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.
Amount From and To A range of amounts Amount range search criteria can be
used without having to provide a
currency criteria
Search Text A string contained in the message Type a string, which must begin and end
with %.
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 Property A message property that has been This is a suggest field, which contains
assigned to an instance. the names of all message properties
injected by Integration Platform (IPLA)
that exist in the messages stored in the
Alliance Access database.
The field also displays user-defined
keywords in messages stored in the
Alliance Access database. Alliance
Access refreshes the user-defined
keywords when you update or modify a
message. See also Add a Routing
Keyword in the Alliance Access
Configuration Guide.
Value The value assigned to a Message Type the value of the message property.
Property. If you specify only the wildcard % in this
field, all messages that have at least one
instance of that message property are
returned, regardless of the value set for
that message property. This is a free text
field with a maximum of 512 characters
allowed.
Copy MX, File, or Any Messages Select the check box the include copy
messages.
Requester DN The requester DN Type the requester 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 Name The logical file name Type the logical file name. The wildcards
'_' and '%' can be used in the name.
Transfer Description The transfer description Type the transfer description. The
wildcards '_' and '%' can be 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.
Message Property A message property that has been This is a suggest field, which contains
assigned to an instance. the names of all message properties
injected by Integration Platform (IPLA)
that exist in the messages stored in the
Alliance Access database.
The field also displays user-defined
keywords in messages stored in the
Alliance Access database. Alliance
Access refreshes the user-defined
keywords when you update or modify a
message. See also Add a Routing
Keyword in the Alliance Access
Configuration Guide.
Requester DN The requester DN Type the requester 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.
Search Text A string contained in the message Type a string, which must begin and end
with %.
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 Property The value of a message property that This is a suggest field, which contains
has been assigned to an instance. This the names of all message properties
is a suggest field, which contains the injected by Integration Platform (IPLA)
name of all message properties existing that exist in the messages stored in the
in the messages stored in theAlliance Alliance Access database.
Access database. You can also enter
The field also displays user-defined
free text (up to 128 characters).
keywords in messages stored in the
Alliance Access database. Alliance
Access refreshes the user-defined
keywords when you update or modify a
message. See also Add a Routing
Keyword in the Alliance Access
Configuration Guide.
Requester DN The requester DN Type the requester 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.
Amount From and To A range of amounts Amount range search criteria can be
used without having to provide a
currency criteria
Search Text A string contained in the message Type a string, which must begin and end
with %.
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".
Related information
Search by ID and Content on page 210
Live Days Messages in the Alliance Access 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.
Archives and Live Days Messages that are either live and completed, or archived (a
combination of the Live Days and Archived options).
Complete the Creation date/time range and the Find Possible Duplicates check box. For
more information, see step 7 on page 224 and step 9 on page 225.
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
must be entered with slashes, for example, DD/MM/YY. The date format is interpreted
according to the Alliance Web Platform settings, for example European, US, or ISO
format. The maximum length is 10 characters.
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.
If no value is entered, the field is automatically filled in with a time of 00:00:00.
To Date Type the date of the latest message to be found, using numeric characters only. The
date must be entered with slashes.
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 Access has identified as duplicate by means of its
duplicate detection mechanism, or messages that have been marked as duplicate locally
(inside Alliance Access) by a user. Messages that Alliance Access 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 229.
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.
• APPLI
The Message Input
• OTHER Reference field
• SWIFT appears if you selected
SWIFT as a network.
• SWIFTNet
Enter a value for the
• IPLA reference in the
message header. You
can use wildcards in
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 Access.
If you selected OTHER, SWIFT or SWIFTNet as a
network, then enter the following in a continuous string
for the logical terminal:
• a nine-character logical terminal identifier through
which the message is sent or received
• a three-character branch code (this is always "XXX")
• a single-character code identifying the session type
(this is either "A" for APC sessions or "F" for FIN
sessions)
Example: SWHQUS33AXXXF
If you selected APPLI as a network, then type the name
of the message partner through which Alliance Access
exchanges the messages that you are searching for.
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
• OTHER
• 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
4. The search is triggered automatically when selecting the template name. While messages are
being added to the list, the text Please wait may appear.
The Message Search page displays the list of returned messages.
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 Access 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 Access) by the user
• Messages identified as duplicate by Alliance Access 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.
• When the same digest is found in the database, an extra comparison is performed on the
payload itself and if it is identical, then the routing keywords possible_duplicate and
user_duplicate are set to "True" for the message.
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.
You can perform the following actions on a message instance that you select from the Message
Search page:
• complete it
• move it to a different routing point
• reassign the unit assigned to it
• reactivate it if it was completed
• generate a report
• change the priority
• open the details of the message that contains the message instance
• cancel message instance emissions for FIN, InterAct, and FileAct messages
• change the emission expiry date/time of the selected instance(s)
For information about generating a report of an instance, see Generate a Message Instance Report
on page 260. 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.
SLA ID The service type identifier (field 111 in the MT header) that is used for
services such as SWIFT gpi.
MX A user reference
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.
Inst #
In Queue Since The date when the message instance was assigned to the queue.
Mesg Creation The date when the message to which the message instance is linked
was created.
Creating Function The name of the function responsible of the creation of the message
instance.
Application The name of the application responsible for the creation of the message
instance.
Function The name of the last function applied on the message instance.
Mesg Description A description of the message. For MT and MX messages, the Message
Description field contains the Display Name of the message type.
Status
Inst Creator Name of the operator who created the message instance.
Inst Creation The date and time when the message instance was created.
Inst Last Modifier Name of the last operator who modified the message.
Inst Last Modification The date and time of the last modification of the message instance.
2. Specify your search criteria as described in Search by Instances Location on page 227.
3. Select the relevant instance by checking the box to the left of the list.
If you want to complete a group of instances simultaneously, then select all the relevant ones.
To complete all the instances displayed on the current page, check the box in the column
heading line.
If you want to complete all of the message instances resulting from the search (including those
not displayed on the current page), do not select any instances in the list.
4. Click Complete . A confirmation window appears. Click OK to confirm or Cancel to return to the
list of instances.
Procedure
1. Select the relevant instance by checking the box on its left from a search with Message
Instance Search.
If you want to change the priority of a group of instances simultaneously, then select all the
relevant ones. To change the priority of all the instances displayed on the current page, check
the box in the column heading line.
2. Click Change Priority .
3. The Change Priority window appears.
4. Select a priority from the Available Priorities drop-down list and click Change .
A message appears in the Status area that confirms the change.
Procedure
1. In the Source & Creation tab in Message Search, select Search Type = Instances and
State = Completed.
2. Click Search .
3. Select the relevant instances by checking the boxes to the left.
4. Click Re-activate .
The Re-activate Confirmation window appears that contains the name of the queue and the
total number of message instances that will be reactivated to the selected queue.
5. Click OK .
A message appears in the Status area that confirms the reactivation.
Note • If any of the selected instances have a sender destination that is not allowed by the
Message File, Cancel Msg Emission permission, then the entire operation is
refused (also for the instances whose sender destinations are allowed by the same
permission).
• If any of the selected are either not in an emission queue (_SI_to_SWIFT or
_SI_to_SWIFTNet) or are non-File messages instances that are in Waiting ack
status, then these instances are not cancelled, but the other selected instances are
cancelled. An error popup is displayed that indicates the number and identifier of
the instances on which the operation failed or was successful.
• If one or more instances are File message instances in Waiting ack status, the
instances are aborted.
• The function result of a cancelled message instance is set to Nack'd for a FIN
message instance and to Failure for an InterAct or FileAct message instance.
Note • If there are any instances selected whose sender destination is not allowed by your
Message File, Change Expiry d/t permission, then the entire operation is refused
(including the instances whose sender destinations are allowed by the above
permission.
• If there are any instances selected that are not original instances, whose direction
is not To SWIFT/SWIFTNet output messages, or are in status 'Waiting ack' , then
the emission expiry date time of these instances is not changed. It is only changed
for the other selected instances. An error pop-up is displayed with the number and
identifier of the instances on which the operation failed or was successful.
• The Status icon (at the right bottom of the screen) shows the identifiers of the
instances for which the operation was successful.
• The next emission date time of each instance for which the emission expiry date
and time has been successfully changed is reset to 0 (which corresponds to the 1
Jan 1970).
Status
Mesg Description A description of the message. For MT and MX messages, the Message
Description field contains the Display Name of the message type.
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.
The field is extracted based on the deployment package that is loaded for the
message/service combination.
Alliance Access only displays the value of the Value Date field if you are a
member of a unit to which at least one of the message instances is assigned.
If this requirement is not met, then the value has asterisks (*****), and if you
produce a message details report, the value is not printed. For more
information about assigning units, see the Configuration Guide.
The Value Date field is not populated when the message is coming from a
message partner where No validation level is used.
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.
Orig Inst RP The queue or routing point in Alliance Access where the original instance of
the message is located. If the original instance has been completed, then no
routing point appears.
Usage Count The total number of times that the MT or MX template has been used to
manually build a message.
Last Used The timestamp (in the local time of the browser) when the MT or MX template
was used to manually build a message.
Sender/Receiver The BIC-11 address of the sender, and receiver of the message
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
Filtering criteria Enables you to filter a list of File messages according to various criteria.
I/O The file transfer direction: Input (I), which means that a file is sent to
SWIFTNet, or Output (O), which means that a file is received from
SWIFTNet
Transfer Reference A unique identifier for the file transfer that is automatically generated when
the file transfer occurs
User Reference This optional field allows you to enter your own reference information for the
transfer, for example, the date, an ID number, or a reference code
Service Name The name of the service over which the file transfer is requested
Correspondent The BIC8 address of the Responder DN for an input message or the BIC8
address of the Requestor DN for an output message
Unit The unit that is sending the file or that is assigned to the File message when
an operator initiates a file transfer
Function
Abort An operator can abort a file transfer that has the status Ongoing.
I/O The file transfer direction: Input (I), which means that a file is sent to
SWIFTNet, or Output (O), which means that a file is received from
SWIFTNet
Service Name The name of the service over which the File message is sent or the file
download is requested
Network Priority The SWIFTNet priority that was requested for the exchange
Transfer Reference A unique identifier for the file transfer that is automatically generated when
the file transfer takes place
User Reference This optional field allows you to enter your own reference information
concerning the transfer
Stored Transfer Ref. A unique transfer reference generated by the SWIFTNet store-and-forward
systems to identify a store-and-forward file transfer
Logical File Name The logical file name that is defined in the database for the payload file.
File Info This optional field displays structured data used by the receiver for
automatic processing of the file. The use of this field is agreed between
sender (you) and the receiver. For example, the field contents can start
with SwCompression= to indicate whether the file is compressed, and also
to identify the compression algorithm.
Transfer Info Data that can be used by the receiver for automatic processing of the file
transfer
Functions
Function Description
Save File Saves the payload of the File message to a local directory
Procedure
1. From the Search and Report menu, select File Transfer Monitoring.
2. Use the filtering criteria to search for a FileAct message.
3. Click a file-transfer row to view the request details and content.
The File Transfer Details window opens.
4. If needed, you can abort the file transfer, as follows:
a) Click Abort .
The Confirmation Message window opens.
b) Click OK .
5. You can save the payload file to a local directory by clicking Save File .
Alternatively, you can:
• Save the payload from the message details. Click Show Message from the File Transfer
Details window or go to the Search and Report menu > Message Search, do a search on
messages and select a file message to access the Message Details, then from the File tab,
click Save File .
• Save the payload from the file transfer details. Go to the Search and Report menu > File
Transfer Monitoring, select the File message and save the payload file from the File
Transfer Details window.
Operator permissions
The Alliance Access operator profile permission to search for messages (Message File / Search)
is required for producing the message details and message summary reports in Alliance Message
Management.
The Alliance Access operator profile permission Monitoring is required for producing the
messages in queues report.
To avoid this situation, provide a higher value for this parameter. For more information on this
parameter, see Alliance Web Platform configuration parameters in the Alliance Web Platform
Administration and Operations Guide.
Reports generated using Operational Reporting are not affected by this parameter.
more information about configuration for Sanctions Screening and Transaction Screening, see the
Configuration Guide.
The user documentation provided with Alliance Access describes the meaning of text and codes
that may be printed to indicate warning conditions for a message. For more information about eye-
catchers, see Printed Message Reports on page 250.
Message text
Depending on the value of the configuration parameter FIN User Header in Alliance Access, the
message text section shows the contents of the FIN User Header (block 3) of the message.
If you subscribe to Sanctions Screening, then block 3 contains Sanctions Screening information.
For more information about configuration for Sanctions Screening, see the Configuration Guide.
For more information about configuration for Transaction Screening, see the Configuration Guide.
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 Message Management presents summary results in the sequence that Alliance Access
provides them. You can select a value in the Sort Order field to determine the order in which
Alliance Access returns the resulting output.
Value Result
Creation Date (default) The output is sorted in descending order so that the most recent message appears
first.
Value Result
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.
Report content
The report for a message instance consists of the following sections:
• Warning header
• Transmission section
• Message Header section
• Message Text section
• Message Trailer section
• Intervention section
Eye-catcher text
When printing in ST200-like format, a warning identification, which is called eye-catcher text,
indicates an exceptional condition.
Note Eye-catchers are not printed when the option for printing to a file is used.
The eye-catcher codes in the following table are shown in order of preference. This means that if
more than one condition applies, then only the eye-catcher that is related to the first condition is
printed:
NAK NAK'd message. Message is an input message, the delivery status is Not
Acknowledged (NAK).
RTV Retrieved message. Message is an input or output message that has been retrieved.
PAI Partial Copy Message is an output InterAct message that requires Partial
Authentication Copy digest authentication in case the Partial Copy digest
Result: Incorrect verification failed or the Partial Copy digest is missing.
PAB Partial Copy Message is an output InterAct message that requires Partial
Authentication Copy digest authentication in case the IA Partial Copy digest
Result: Bypassed verification was bypassed.
*** Nacked Message *** Prints only for an input message. Appears if the
network delivery status of the related appendix
indicates that the message was not
acknowledged (NAK).
*** Authentication Result: <value> *** The following values are possible for the
authentication result message, based on
whether the message is MT, MX or a File
message, and depending on the related
appendix:
Text Description
*** Authorisation Result: <value> *** Printed only for a message that requires
authorisation.
The following values are possible:
• No Record
• Not Enabled
• Invalid Period
• Unauthorised
*** Authorisation key not present *** Prints only for an output MT message that
requires authorisation. Printed if no
authorisation key is available.
*** FIN-Copy Authentication Result: <value> Prints only for an output MT message that
*** requires proprietary authentication.
The following values are possible for an MT
message, based on the related appendix:
*** Partial Copy Authentication Result: Prints only for an output InterAct Partial Copy
<value> *** message that requires proprietary
authentication.
The following values are possible:
• Correct
• Incorrect
• Bypassed
Text Description
*** Possible duplicate information received Prints if a message was received from SWIFT
from network *** or from a back-office application as a possible
duplicate. The possible duplicate information
was set externally and received by Alliance
Access.
*** Possible duplicate indicator set locally Prints if a message was locally marked (within
*** Alliance Access, either by means of a manual
operation or otherwise) as a possible duplicate.
*** Duplicate detected by interface *** Prints if Alliance Access has detected that a
message is possibly a duplicate of another
message in the database.
*** Possible duplicate delivery *** If the original instance has one emission
appendix, prints when printing/reprinting the
original instance or when reprinting the
transmission notification instance
corresponding to the emission appendix.
If the original instance has more than one
emission appendix, prints when printing/
reprinting the original instance or when
reprinting any of the transmission notification
instances corresponding to the emission
appendices.(2)(1)
*** Possible Duplicate Emission *** If the original instance has more than one
emission appendix, prints when printing/
reprinting the second, third, or later notification
instances corresponding to the emission
appendices.(2)(1)
*** Possible Duplicate Reception *** Prints if the message is received from the
network with a possible duplicate emission or
Possible Duplicate Message trailer.
*** Test and Training Mode *** Prints if the MT message sent or received is
from/to a Test & Training destination.
(1) Applies to a 'Printing message to a Print MP' printout or a 'Printing with MXS layout from MMA" printout. A 'Printing message
to a Print MP' printout creates an additional emission appendix (but no transmission notification instance), while a 'Printing with
MXS layout from MMA' printout does not.
(2) With status other than DLV_REJECTED_LOCALLY or DLV_NACKED.
If a previous transmission attempt was made, the warning header includes transmission-related
details for the network, session holder, session number, sequence number, and delivery status.
appendix for a message. The following table explains additional content that can appear in the
Instance Type and Transmission section:
Notification / emission Indicates the notification type, and includes the type of the related
instance. Network acknowledgement information is printed. For
notification type "Transmission", the report includes Network
Delivery Status: <value>. For notification type "Delivery", the
report includes User Delivery Status: <value>, possibly
followed by NAK information.
If the instance is for an MT message that is not an APC message, then
the report includes Priority/Delivery : <value>. This
information indicates the priority (System, Urgent, or Normal) and can be
followed by the delivery status (Non-Deliv Warning or Deliv
Notif).
The message input reference prints in this part of the report.
Notification / reception Indicates the notification type, and includes the type of the related
instance. If the instance is for an MT message that is not an APC
message, then the report includes Priority: <value>.
The message output reference prints in this part of the report, along with
the correspondent input reference.
Original or Copy / emission Indicates the instance type and whether there is a related instance, and
shows network acknowledgement information. If the instance is not for a
FIN system message, then the report includes Priority/Delivery :
<value>. This information indicates the priority (System, Urgent, or
Normal) and can be followed by the delivery status (Non-Deliv
Warning or Deliv Notif).
The message input reference prints in this part of the report.
Original or Copy / reception Indicates the instance type and whether there is a related instance. If the
instance is for an MT message that is not an APC message, then the
report includes Priority: <value>.
The message output reference prints in this part of the report, along with
the correspondent input reference.
Message header
The content of this section of the report is relevant to the message itself, and not specific to the
particular instance that has been printed.
Some content is common for both MT and MX messages:
• Message format
• Message direction (input or output)
• Transmission network
• Message type and message name
Details from the reference data print for sender and receiver (MT message) or for the BIC8 that is
part of the Requestor DN and Responder DN (MX message).
Message text
The text of the message prints for any fields that contain values.
The FIN User Header (Block 3) is printed in the following conditions:
1. The value of the Display/Print - FIN User Header configuration parameter is set to Yes, and
2. The message instance is not printed through a Print message partner
Message trailer
The message trailer of an MT message prints after the message text.
Interventions
The interventions print for an instance if the Print - Skip Interventions parameter is set to No.
For an MX message sent using real-time delivery, intervention details of a Transmission Response
(containing the Business Response) are preceded by the following information:
• SWIFT Reference
• Responder Reference
• Signing DN
• Signature Result
• Non-repudiation Type
• Non-repudiation Warning
• CBT-Reference
• Possible Duplicate Indication
• Responder DN
End of message trailer
When printing reports in ST200-like format, each message is terminated by an end-of-message
trailer:
*End of Message
• Include Header/Footer: if selected, headers and footers are included in the report.
• Include Search criteria: if selected, the search criteria are included in the report.
• Include Sender/Receiver: if selected, the sender and receiver are included in the report.
• Include Instances: if selected, the message instances are included in the report. This
information is derived from the instance type and transmissions.
• Include Interventions: if selected, the message interventions are included in the report.
This option is available only if you select Include Instances and if the Skip Interventions
global parameter is set to off.
If any of the above check boxes are not selected, the corresponding section of the message
Details report is omitted.
To generate a Count report, see Generate a Message Count Report on page 261.
5. Select a format from the Output Format drop-down list.
The formats available are:
• PDF
• XLS
• CSV (only available for Summary Report)
• TXT
6. Select the orientation of the report from the Page Orientation drop-down list.
7. Select the page size of the report from the Page Format drop-down list.
8. If you selected the Summary report type then you can modify the default set of Columns used
for the report.
9. 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.
15 Operational Reporting
Overview
Alliance Access Operational Reporting is a licence option of Alliance Access. When installed on the
Alliance Access host, Reporting can be used during an evaluation period or when it is purchased.
Operational Reporting offers value-added reporting and analysis of MT and FIleAct messages in
the Alliance Access message store. It is implemented by means of the Reporting graphical user
interface (GUI), which is included in the Web Platform-based Message Management package, and
a scriptable command-line tool. It is available with Alliance Access only.
Alliance Access
Ready-to-use Web Platform
reports
Alliance Access Database Operator
Interactive t
in
Report Pr
Raw Reporting Queries
Update Reporting Execution
Message Data
Engine
Sa Dis
Data Store
ve k
on
Command
Line
Reporting Framework
D0540213
The Message Management and Configuration packages of Alliance Access provide the following
Reporting functionality:
• continuously synchronise up-to-date message data stored in Alliance Access tables to the
Reporting data store. Reporting always includes the latest version of the messages that are
present in the Alliance Access database.
• enable the configuration of the various Operational Reporting parameters, such as the selection
of BICs to be covered by the Reporting licence and the management of the Reporting
permission of operator profiles
• enable the triggering, running, and storage of reports via the Reporting GUI of the Message
Management package or the command-line tool. Based on user input, the installed reports
extract the relevant data from the Reporting data store and assemble it into reports using the
Reporting engine. These reports can be either delivered directly on-screen to the user in PDF,
XLS, or CSV format (when launched from the GUI), sent by e-mail, printed, or stored on disk for
later use.
Audience
There are two distinct types of users of Reporting:
• Alliance Access administrators, who can enable the Reporting function (using an evaluation
period or licensing option) and assign the global Reporting permission to Alliance Access
operators
• operators, who do not require IT knowledge in order to run reports and create reusable report
templates
• message reconciliation reports, which are typically used by the business applications
exchanging messages with Alliance Access. These reports help reconcile the message network
status information that is present in the back office with the information available in Alliance
Access.
• statistical reports, which provide the volume of messages grouped into various criteria. In terms
of the complete volume of traffic, these reports can provide hourly statistics on traffic, traffic
evolution, and day peaks. In terms of individual messages, they can help the administrator
understand how various systems are using Alliance Access, as well as the ratio of manually
created messages versus back-office flows.
In addition, reports can be classified by type:
• list reports: reports that list the details of one or more messages that match specific criteria.
Selected message fields are shown in a tabular format. These messages can be grouped into
different categories that are specific to the report type. Each group lists all associated
messages.
• statistical reports: reports that provide statistical information (most often, message counts) of a
set of messages that match specific criteria. These reports can group messages for further
statistics consolidation, where appropriate. For example, NAK statistics can be grouped by
either message partner, creating operator or unit, or NAK category, depending on the report.
To date, a set of ready-to-use operational management reports are provided with Reporting, as
listed in the following table. All of these ready-to-use reports handle MT messages only.
Ready-to-use report details
NAK-rate-STP This report provides the count and rate of Straight Through
Processing (STP) messages sent to SWIFT that have
been NAKed. The results are grouped by message
partner, which represents the emitting business
application.
The purpose of this report is to identify the business
applications that have created the highest number and
highest proportion of invalid messages, and that therefore
require the most intervention. This report will help you
prioritise the improvements that can be made on the STP
flows.
NAK-reason This report provides a list of all NAK codes encountered for
messages sent to SWIFT, along with their corresponding
number of occurrences. The results are grouped by NAK
category.
The purpose of this report is to identify which NAK codes
are the most frequent, and that therefore require the most
intervention. This report will help you prioritise the
improvements that can be made on message formatting.
PDE-to-STP This report provides the count and rate of Straight Through
Processing (STP) messages that have been sent to
SWIFT with a Possible Duplicate Emission (PDE) flag. The
results are grouped by message partner, which represents
the emitting business application.
The purpose of this report is to identify the business
applications that have produced the highest number and
highest proportion of PDE messages, either by explicitly
flagging the message as a PDE or by re-sending the same
message (which causes Alliance Access to automatically
flag the message as a PDE). This report will help you
prioritise the improvements that can be made on the STP
flows.
PDE-from-corr This report provides the count and rate of messages that
have been received from SWIFT with a Possible Duplicate
Emission (PDE) flag. The results are grouped by emitting
correspondent.
The purpose of this report is to identify the correspondents
that have sent the highest number and highest proportion
of PDE messages. This report will help you prioritise the
correspondent interactions that can be improved.
PDM-from-LT This report provides the count and rate of messages that
have been received from SWIFT with a Possible Duplicate
Message (PDM) flag. The results are grouped by logical
terminal.
The purpose of this report is to identify trends in the
occurrences of PDM messages in order to establish the
root cause of the problem (logical terminal, network
provider, and so on). This report will help you prioritise the
investigations that should be performed.
Excep-to-STP This report provides the count and rate of Straight Through
Processing (STP) messages sent to SWIFT that have
passed through an exception queue at some point in time.
The results are grouped by message partner, which
represents the emitting business application.
The purpose of this report is to identify the business
applications that have created the highest number and
highest proportion of invalid messages, and that therefore
require the most intervention. This report will help you
prioritise the improvements that can be made on the STP
flows.
Msg-act-list This report lists all of the FINCopy messages sent, along
with their delivery status. As a result of the reconciliation
between these FINCopy messages and MTs 019/012, the
delivery status also indicates whether the messages were
accepted or rejected by the central institution.
This report will help you identify all of the FINCopy
messages that failed to be delivered.
Msg-vol-FIN This report provides the volume of FIN messages sent and
received for each own destination.
The purpose of this report is to provide statistics on
message flows. This report will also help you cross-charge
the various destinations.
FINcopy-Status-S This report lists all of the FINCopy messages sent, along
with their delivery status. As a result of the reconciliation
between these FINCopy messages and MTs 019/012, the
delivery status also indicates whether the messages were
accepted or rejected by the central institution.
This report will help you identify all of the FINCopy
messages that failed to be delivered.
FINcopy-Status-C This report lists all of the MT096 messages received within
the specified time range, along with their reconciled status
(Accepted / Rejected / No MT097). The results are
grouped by service code.
This report will help you identify messages to be treated.
When a report is run, the output includes a cover page and the results of the query. Following is a
sample cover page of a report in PDF:
each subsequent time that you run the report the same description is used, unless you update
it.
• short name of the report (for example, NAK-reason)
• category of the report (for example, Exception Statistics - FIN)
• operator who ran the report (for example, opAll)
• output filename of the report (for example, NAK-reason-opAll-20130626-1355.pdf)
• run on, which is the date and time that the report was run (for example, 26/06/13 13:55)
• version, which is the build version information from the report definition (for example, 3.0.1)
• parameters used in the report (such as Start Date and End Date)
Following is an excerpt of typical results from the NAK Error Codes by Reason ready-to-use report:
Excerpt of report
Report rules
The following rules are common to all reports:
• In Adobe PDF, the cover page is the first page of the report. In Microsoft Excel (XLS) format, the
cover-page information is displayed at the beginning of the Report sheet.
• For table layouts (in PDF only), after each table, there are one or more summary rows
summarising the table data rows.
15.2 Terminology
Term Definition
manual messages Messages that are created manually in Alliance Access using the
message-creation application in the Message Management package
post-processing option Contains the full definition of the post-processing rules (for e-mail
distribution) of a report, namely:
• its type (either the notification of the report run by e-mail, or the
transmission of the results of the report by e-mail)
• the list of parameters for which you can or must provide a value for
the post-processing option to execute (for example, one or more e-
mail addresses in the case of e-mail distribution)
report category Indicates the general purpose of a set of reports. A report category can
contain several reports. A report belongs to only one category (for
example, audit, exception statistics, or capacity management).
report template (My Report) A "recording" of the parameters of a report run, which can be reused as-
is or partially changed before usage, if desired. By creating templates
and defining reports that use relative dates, you can perform similar
report runs without re-creating reports from scratch.
A report template is associated with a single report and optionally with a
single post-processing option. Several report templates can be
associated with the same combination of reports and post-processing
options. In the Reporting GUI and command-line tool, report templates
are referred to as "My Reports".
A report template contains:
• the name of its associated report (maximum length of 20 characters)
• the title of its associated report (maximum length of 40 characters)
• the name of its associated post-processing options
• a set of values for the parameters of its associated report and a set
of values for the parameters of its associated post-processing
option. The set of values must be complete (that is, it must at least
contains a value for each parameter of the associated report or post-
processing option that is mandatory).
Straight Through Processing All messages originating from a back office (that is, by means of a
(STP) messages message partner), including messages that are sent by a back office by
means of a manual message partner
2. Enter the activation code that SWIFT has provided. Note that the valid activation codes are not
case-sensitive. Click Save .
3. Refresh the Parameter window by clicking Submit and then returning to the window. The
Activate Reporting parameter is now visible. Note that the Start Evaluation parameter
remains visible until the next restart of the server.
Activating Reporting
Activating Reporting
When you activate Reporting (by switching on the Activate Reporting configuration parameter):
• Live message data becomes available for reporting in the Reporting data store.
• You must restore message archives in order to synchronise them with the Reporting data store.
• If you have the Reporting permission, the Alliance Access Operational Reporting GUI becomes
visible and can be used, along with the saa_report command-line tool.
Note In order to activate (or deactivate) Reporting, an operator requires System
Management permission.
Once Reporting is activated, all messages are copied to the reporting data store. When the initial
synchronisation is complete, event 32013, <today's date> daily table synchronization is
completed (from the Reporting application), will be written to the Event Log. Event 32013 is also
written to the Event Log to inform you when restored message archives are being synchronised.
Refer to "Event logging" and "Tracing and logging" in this section for more information.
Selecting BICs
2. Select the desired set of BICs by moving them from the Available list box to the Selected list
box, then click Save .
During the evaluation period, you can select any (or all) licensed live and T&T BICs.
Outside of the evaluation period, you can select any number of licensed T&T BICs (regardless of
your Reporting band), but the number of live licensed BICs that you can select is limited by your
Reporting band. For example, if you have 10 licensed live BICs and 8 licensed T&T BICs, and you
have a Reporting band for 5 BICs, you can select a maximum of 5 live BICs in addition to as many
T&T BICs as you wish.
Using the BIC Selection for Reporting application, you can change your selection of BICs
(subject to your licence) at any time, but you need to restart Alliance Access before any new BIC
selection is effective.
Deactivating Reporting
When you deactivate Reporting (by switching off the Activate Reporting configuration
parameter):
• The Reporting data store is automatically emptied of all messages.
• The Reporting component is automatically stopped and is no longer visible in the list of Alliance
Access components that you can start and stop.
• Your BIC selection is reset.
Note In order to deactivate Reporting, an operator requires System Management
permission.
You can stop or start the Reporting component for maintenance purposes when necessary.
However, the component must not be stopped when Reporting data is being initialised (that is,
when the Alliance Access database is initially copied in full to the Reporting data store). In addition,
it is recommended that you do not stop the Reporting component for extended periods when
Reporting is activated, because an excessive amount of data synchronisation could be required
upon restart.
Tip Stopping the Reporting component temporarily stops the synchronisation of data only.
Deactivating Reporting stops the component and erases all of the existing reporting
data. If you reactivate Reporting, a complete synchronisation must be performed
again, which could take a significant amount of time to complete, and you must re-
select your BICs for reporting.
Reporting on messages
When Reporting is activated, the details of all of the messages that undergo a change in the
Alliance Access database are copied to the Reporting data store. This copy overwrites any
messages in the Reporting data store if they already exist there.
The following message changes are considered for copying to the Reporting data store:
• addition (following the reception of a new message from the back office or from SWIFT/
SWIFTNet, or following manual creation)
• update (modification, verification, or approval of a message; or addition or update of an
intervention)
• completion
The restored archive data does not contain the name of the Alliance Access instance that the
restored archive comes from (namely, the Alliance Access instance in which the archives were last
backed up). The restoration of archives coming from different Alliance Access instances is not
recommended, because there is the risk of overwriting messages with the same identifier in the
Alliance Access instance in which the archive is restored.
Note When an archive is removed from Alliance Access, the messages it contains are not
removed from the Reporting data store.
Similarly, during a database recovery, reporting is automatically deactivated. If you want to continue
to use Reporting, Reporting must be reactivated (with the Activate Reporting parameter) to re-
initialise the Reporting store with all of the messages present in the Alliance Access database.
Event logging
Events related to Reporting are logged in the Event Log when:
• initial activation data or restored message archives are being synchronised
• the evaluation period starts or expires
• if there is no Reporting licence and 15 days before the expiration of the evaluation period, to
remind you to purchase a Reporting licence in order to continue Reporting after the evaluation
period expires.
• Reporting is activated or deactivated
• the BIC selection is changed
• a report template is created, updated, or deleted
• a report run is deleted or completed (either successful or failed)
• rpt_trace is set or reset
• saa_rpt -purge is started or completed
including its name (rpt.log), location (/$ALLIANCE/log/rpt), threshold level ("INFO" or higher)
and maximum size (100 MB). A maximum of 10 versions of the rpt.log file are maintained at any
one time.
The output of tracing does not include highly confidential information such as passwords. However,
trace output may contain message-payload information. Trace files, which are also added to the /
$ALLIANCE/log/rpt directory, are named rpt_trace.log.n. A maximum of 100
rpt_trace.log.n files are maintained at any one time.
Report queuing
Reports that you launch are run sequentially. When a report is running and you launch a second
report, the launch of the second report is queued until the first report completes. A maximum of 10
report launches can be queued. Once this limit is reached and you attempt to run another report,
you will receive an error message informing you to wait before launching further reports.
In the Output format field, the default output format for the ready-to-use report is initially displayed,
but you can modify this value before running or saving the report. Select the desired format, either
PDF (Adobe), .xlsx (Microsoft Excel), CSV (comma-separated value), .docx (Microsoft Word), or
Browser. The CSV format is available for List reports only. The Browser format displays the report
run results in your browser, which can be further exported to PDF, Word, XLS, or CSV format. The
Browser format is available only Accounts and Inbox/Outbox reports. The available output formats
can vary with each ready-to-use report.
Note A maximum of 65,536 rows can be displayed within a report in XLS format.
Reporting automatically provides a unique name for the report, composed of the ready-to-use
report name, the operator name, and a date-and-time timestamp, in the format
<AvailableReportName>-<OperatorName>-<YYYYMMDD>-<HHMM>.
Note When you select Notification E-mail Only?, ensure that you enter your own e-mail
address, because the only other location where the report results can be found is the
History of Reports Run window, where operators can see only the report runs that
they have personally launched. When a report run fails, no e-mail is sent.
If you select E-mail Distribution (regardless of whether you select Notification E-
mail Only? or not), then the system configuration parameter Mail Server must be
configured. For more information, see the classes of configuration parameters in the
Configuration Guide.
SWIFT does not protect the confidentiality of e-mails, which is the customer's
responsibility. If you wish avoid usage of this e-mail delivery method, do not configure
an e-mail server address in Alliance Access. For more information, see the
appropriate Installation Guide: AIX Linux Windows.
In the Output format field, the output format values stored with the report are initially displayed,
but you can modify this value before running or saving the report. Select the desired format, either
PDF (Adobe), .xlsx (Microsoft Excel), CSV (comma-separated value), .docx (Microsoft Word), or
Browser. The CSV format is available for List reports only. The Browser format displays the report
run results in your browser, which can be further exported to PDF, Word, XLS, or CSV format. The
Browser format is available only Accounts and Inbox/Outbox reports.
Note The available output formats can vary with each report.
Reporting automatically provides a unique name for the report, composed of the ready-to-use
report name, the operator name, and a date-and-time timestamp, in the format
<AvailableReportName>-<OperatorName>-<YYYYMMDD>-<HHMM>.
Close , the dialog is closed and the output of the report is displayed on screen in the format that you
have specified.
Click Save to save any changed values.
Click Save As to save the report (with any changed values) with a new name. In the dialog box that
is displayed, specify the new report name, then click Save .
Click Delete to delete the report template.
Following are some additional examples of relative dates (assuming that today is Tuesday, 22 June
2012):
• The last 2 months covers the period 1 April 2012 until 31 May 2012.
• The last 1 year covers the period 1 Jan 2011 till until 31 December 2011.
• The last 2 days covers the period 20 and 21 June 2012.
• The current month covers the period 1 June 2012 until 22 June 2012 (included).
• The current year covers the period 1 Jan 2012 until 22 June 2012 (included).
• The current day covers 22 June 2012.
currently represents are displayed next to the field for information only (and are unavailable for
editing).
When you save the report parameters in a report template (by means of the My Reports window),
any relative dates that you have specified are saved with the template. If the report template is
used at a later date, the saved relative date is displayed as a relative date, along with the absolute
date that it currently represents (for example, on 14 July 2012, the absolute start and end dates
would be 1 May 2012 and 30 June 2012).
Prerequisites
Following are the prerequisites for using this tool:
• The tool must be launched by any operating system account providing valid Alliance Access
operator credentials with the appropriate permissions in the command line.
• The Alliance Access server must be running, and the tool must be launched from the command
line accessible from the Alliance Access installation.
• Reporting must be activated (that is, the Activate Reporting system configuration parameter
must be switched on).
Description of parameters
The following table describes the parameters that are used to perform various tasks with the
Reporting command-line tool (saa_report), as outlined in the sections that follow.
Parameters of the saa_report command
Parameter Description
-purge <x> Purges messages older than <x> days from the
Reporting data store. The value of <x> must be
greater than 7 and less than 10000.
[-outputfile <Filename>] Name of the file (not including the extension) that will
contain the report run results.
This parameter can be optionally used with the -run
parameter. If present, the file name you specify will
overwrite the output file name specified in the report
template. If you provide a file extension, it will be
ignored.
If this parameter is not provided with the -run
parameter, the output file name is automatically built
as follows: <ReportName>-<OperatorName>-
<Date>-<Time>, where:
• ReportName is the report name (if the report was
run from a ready-to-use report definition) or the
report template name (if the report was run from a
report template).
• OperatorName is the name of the operator in
whose name the report was run.
• Date is the date in the format YYYYMMDD.
• Time is the time in the format HHMM.
If the Filename in the -outputfile <Filename>
parameter is present with the -run parameter and:
• it contains %d, then %d is replaced by YYMMDD in
the actual name of the generated output file.
• it contains %t, then %t is replaced by HHMM in the
actual name of the generated output file.
• it contains %u, then %u is replaced by the name of
the operator in the name of which the report is
run, in the actual name of the generated output
file.
If the output file name is not provided or does not
contain a path, then the default path is usrdata/
report/results. If a path is provided that does
not already exist, the report run is stopped and an
error message is displayed.
Syntax
To run a report from a report template that you have already created by means of the Reporting
GUI, run the following command from the command line:
saa_report -user <username> [-password <password> | -passwordfile
<[path]filename>] -run <MyReportName> [-outputfile <Filename>] [-overwrite] [-
port <portnumber>]
Note When you run a report from a template, ensure that the output file name includes
symbols such as %u, %d, and %t, so that the resulting output file name is unique.
Otherwise, the report run may fail (if the output file name already exists and the -
overwrite option was not provided).
Example
saa_report -user test -run MyReport1 -outputfile MyReport1_%u_%d%t
Following is some sample output of this command, where [ALLIANCE_HOME] is the root folder
where Alliance Access is installed:
id=123,status=SUBMITTED
start polling for report...
finished polling for report
fetching...
Report available: [ALLIANCE_HOME]\usrdata\report\results\MyReport1_all_adm_
201209041023.pdf
Syntax
To generate a list of the available ready-to-use reports, run the following command from the
command line:
saa_report [-user <username> | -application <username>] [-password <password> | -
passwordfile <[path]filename>] -listAvailableReports [-category <category>] [-
port <portnumber>]
Example
saa_report -listAvailableReports -category "Capacity Management"
Syntax
To generate a list of report templates, run the following command from the command line:
saa_report -user <username> [-password <password> | -passwordfile
<[path]filename>] -listMyReports [-port <portnumber>]
Example
saa_report -user test -passwordfile C:\temp\pwd.txt -listMyReports
Following is some sample output of this command, assuming that user test created these three
templates using the Reporting GUI:
MyReport |Based on available report
--------------------------+-----------------------------------
MyAvgProFrmSTP-PDF |Avg-pro-from-STP
MIR-list-XLS |MIR-list
TestRpt-Live1 |Live-msgs-summ
Syntax
To specify the age of messages to be purged, run the following command from the command line.
Specify a value for <x> (days) that is greater than 7 and less than 10000.
saa_report [-user <username> | -application <username>] [-password <password> | -
passwordfile <[path]filename>] -purge <x> [-port <portnumber>]
Example
saa_report -purge 30
One of two options are provided to operators when starting the session. Based on the message
partner profile, operators can either select a file located on the server of the Alliance Access
host or a file located in the user space. If using the user space, then an operator can download
a file from the desktop to the user space before starting the session. A file picker allows the
operator to browse the content of the user space and pick the appropriate file. If the files are
located on the server, then the operator must provide the name and the path of the file.
• When starting the session for the message partner, an operator can choose whether to route or
dispose messages in the file. One or both choices may be available, as determined by the
profile assigned to the message partner. If dispose is used, then a queue must be selected.
• If necessary, the operator can optionally add a Possible duplicate Emission trailer. Every
message in the file will be marked as a possible duplicate.
• 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 Access sends messages to the appropriate destination.
• The operator is responsible for removing the uploaded file when it is no longer needed.
Batch input
An input message partner configured with connection method set to File Transfer reads the
messages from a file.
With batch input sessions, the session operation and recovery principle is very similar. If anything
goes wrong with the session, then the recovery mechanism unreserves, removes, and discards the
messages in the AI inbound queue.
Automatic sessions
If an error occurs, then the batch input message file is moved into a storage location known as the
Automatic Input Error Directory (set by the system parameter Automatic - Error Dir).
If a parameter file is being used, then the parameter file is moved into this Error Directory. If the
message file and parameter file are located in the same connection point directory, then both are
moved into the Error Directory.
To avoid filename clashes, each file placed in the Error Directory is given a file extension
YYMMDDHHMMSS.
An event concerning the reason for the session failure is recorded in the Event Log.
Direction Indicates the direction that the message partner sends files relative to the
Alliance Message Management session. From Message Partner
indicates input to Alliance Access. To Message Partner indicates output
from Alliance Access.
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.
Message Count Shows the number of messages currently available for output for the
message partner. This column appears only in the File Output - 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.
Procedure
1. From the Batch File menu, select File Input.
The File Input - Choose a Message Partner page opens and displays the list of available
message partners.
2. Click the message partner to use for the batch input session then click Start Session .
The Start Session page opens.
For the File On selection, the message partner profile determines whether the file can be
selected from the server or the user space. If you select Local, you can specify one of the local
or network directories available on your desktop. The file is then generated and processed from
the user space.
3. Select the file.
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.
The file appears in the File Name field
• Click OK .
The file name selected appears in the
Connection Point field. You can use this field
to specify a different file name for the file on
Alliance Access.
The file is located on the server Type the path and file name in the Connection
Point field. You can use this field to specify a
different file name for the file on Alliance Access.
Procedure
1. From the Batch File menu, select File Output.
The File Output - Choose a Message Partner page opens and displays the list of available
message partners.
2. Click the message partner to use for the batch output session then click Run Session .
The Run Session window opens.
For the File On selection, the message partner profile determines whether the file can be
selected from the server, the userspace, or locally. If you select Local, you can select one of
the local or network directories available on your desktop as the final destination of the file. The
file is first generated in the userspace, and then downloaded from the userspace to the local/
network directory.
Once the session has ended, the file download is automatically initiated.
3. If the file is located on User Space, then type the path and file name in the Connection Point
field or click to locate and select the file to upload.
The file name selected appears in the Connection Point field. You can use this field to specify
a different file name for the file on Alliance Access.
If the file is located on Server, then you must type the path and file name in the Connection
Point field.
If the file is located on Local, click Browse to browse to the location of the file in the
Connection Point field.
4. If necessary, click the Overwrite Target File check box.
5. Click OK .
While the file is being output, the Session Details page opens. For more information, see
Session Details Page on page 310
To download the output file, see Download a File from the User Space on page 308.
Files are located on the Alliance Access server. The root path of the User Space is defined by the
Root Path for User Space security parameter. Each operator has a User Space and cannot
access folders or files which are located in the User Space of other operators.
In the User Space, the files are identified by User Space names which are not necessarily the
same as the physical names of the files.
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.
Page example
Direction Indicates the direction that the message partner sends files relative to the
Alliance Message Management session. From Message Partner indicates
input to Alliance Access. To Message Partner indicates output from
Alliance Access.
Session Status Shows the current status of the message partner session.
Field descriptions
• Closing - the session is closing down because the end of file has been
reached.
• Aborting - the session is closing down because of a failure, such as an
authentication failure, or because someone selected Abort Session .
• Recovering - the session is recovering from a sudden closure, such as
an abort or a system restart.
Last Error Shows the last error that occurred in the session. If no error occurred, then
this field contains SUCCESS.
Session Identifier The session number for the message partner. Alliance Access increments
this number for each consecutive session.
To Partner or From Displays the direction defined in the message partner profile. The
Partner perspective is that of Alliance Access: "to" means output from Alliance
Access and "from" means input from the message partner to Alliance
Access.
Sequence Number Shows the sequence number of the next message expected to be
processed during this session.
Accepted Shows the number of messages that have been accepted. During file
transfer, the entire file must be read in and processed before a number
appears here. Messages are routed after the entire file is read in.
Rejected Shows how many messages have been rejected so far in the current
session. Rejection can occur for a number of reasons, for example,
message syntax errors. The reason for the rejection of a message is logged
on the Alliance Access Event Journal.
Bypassed Appears only for output message partners . Displays the number of output
messages that were bypassed (and completed). Messages are bypassed
when the output data format selected for the exchange is one that does not
support certain types of message. For example, RJE does not support
notifications. When an unsupported type of message appears at the exit
point it is moved to the text modification queue and completed. Each
message bypass is recorded as an event in the Alliance Access Event
Journal.
Not yet Shows the number of processed messages that are waiting to be
acknowledged "Accepted". Acceptance occurs only when the entire file has been
processed.
Since Last Reset Shows the number of processed messages since the last reset.
4. Click the appropriate Reset button to reset the message counters manually.
5. Click Next or Previous to view details for other sessions.
6. When you have finished viewing the session details, click Close or click any other task.
Legal Notices
Copyright
SWIFT © 2021. 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. SC. The following are registered trademarks of SWIFT:
3SKey, Innotribe, MyStandards, Sibos, SWIFT, SWIFTNet, SWIFT Institute, the Standards Forum
logo, the SWIFT logo, SWIFT gpi with logo, the SWIFT gpi logo, and UETR. Other product, service,
or company names in this publication are trade names, trademarks, or registered trademarks of
their respective owners.