100% found this document useful (1 vote)
561 views305 pages

Stds62 Using SWIFTNet PDF

Uploaded by

Kiran P
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
100% found this document useful (1 vote)
561 views305 pages

Stds62 Using SWIFTNet PDF

Uploaded by

Kiran P
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 305

Sterling Standards Library

Using SWIFTNet
Version 6.2
Licensed Materials - Property of Sterling Commerce
Sterling Standards Library 6.2
© Copyright Sterling Commerce, an IBM Company 2000, 2010 All Rights Reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by contract with Sterling
Commerce
Additional copyright information is located on the Sterling Integrator 5.0 Documentation
http://www.sterlingcommerce.com/Documentation/SI50/CopyrightPage.htm

Sterling Commerce, Inc. 2


Contents

SWIFT and SWIFTNet with the Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Prerequisite Knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Using SWIFTNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using InterAct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using FileAct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Downloading and Installing the SWIFT Standards Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . 17
SWIFT Envelopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Enabling and Disabling Address Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configuring Inbound Address Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Configuring Outbound Address Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Maintaining the External Code Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Disabling Automatic BICPlusIBAN Validation for the SWIFT_BICPlusIBAN Code List . . . . . 23
Creating Envelopes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Using Base Envelopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Importing and Exporting Envelopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Inbound SWIFT envelope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Outbound SWIFT envelope. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Configuring the EDI Encoder Service for SWIFT Outbound Messages . . . . . . . . . . . . . . . . . . . . 67
Correlation Names to Override SWIFT Envelope Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
FIN Envelopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
XML Format 2 Envelopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
SWIFT and SWIFTNet Business Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Writing a Business Process for a StandardsTranslation Operation . . . . . . . . . . . . . . . . . . . . 73
SWIFTDeenvelope Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Before Using the SWIFTDeenvelope Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
SWIFTEnvelope Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Before Using the SWIFTEnvelope Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
SWIFTNetClient Business Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Before Using the SWIFTNetClient Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
SWIFTNetClientFA Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Before Using the SWIFTNetClientFA Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
handleSWIFTNetServerRequest Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Before Using the handleSWIFTNetServerRequest Business Process. . . . . . . . . . . . . . . . . . 89
handleSWIFTNetServerSnFRequest Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Before Using the handleSWIFTNetServerSnFRequest Business Process . . . . . . . . . . . . . . 95
handleSWIFTNetServerFARequest Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Sterling Commerce, Inc. 3


Contents

Before Using the handleSWIFTNetServerFARequest Business Process . . . . . . . . . . . . . . . 99


handleSWIFTNetServerFASnFRequest Business Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Before Using the handleSWIFTNetServerFASnFRequest Business Process . . . . . . . . . . . . 106
handleSWIFTNetServerFAEvent Business Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Before Using the handleSWIFTNetServerFAEvent Business Process . . . . . . . . . . . . . . . . . 111
SWIFTMessageEntryOutbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Before Using the SWIFTMessageEntryOutbound Business Process . . . . . . . . . . . . . . . . . . 114
Creating SWIFT Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
How SWIFT Terminology Correlates with the Map Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
SWIFT Components in the Map Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Downloading and Installing the SWIFT Standards Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Creating a File Layout from an MT or Market Practice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Creating a Custom Market Practice or Fund Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Creating a SWIFTSolutions (MX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Converting Your Map to Another SWIFT Standards Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
SWIFTNet Syntax Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
SWIFT MX Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Error Codes for MX Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Creating Extended Rules for SWIFT Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Extended Rules Used with SWIFT Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Using Autolink and Link. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Using Extended Rule Libraries with SWIFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Calling a Rule from an Extended Rule Library in a Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Truncating Number Fields When Converting Strings to Numbers . . . . . . . . . . . . . . . . . . . . . . . . 132
Using Big Decimal (BigDecimal) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
SWIFTNet Correlations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Searching for SWIFT Messages Using Correlations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Migrating Correlation Details to Version 5.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Overview of SWIFTNet Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
InterAct and FileAct Protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Additional FileAct Protocol Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Secure Sockets Layer (SSL). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
CHIPS Message Transport Using SWIFTNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
SWIFTNet MEFG Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Supported Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Client Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Synchronous Message Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Asynchronous Message Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Configuring the Client Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Server Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Configuring the Server Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
The Application Acting as Third Party . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
SWIFTNet MEFG Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Configuring SAG/SNL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Installing the SWIFTNet Remote API (RA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Configuring SSL Between the Application and the SWIFTNet MEFG Server. . . . . . . . . . . . . . . . 200
Preparing the SSL Certificates for the SWIFTNet MEFG Server . . . . . . . . . . . . . . . . . . . . . . 201
Preparing the SSL Certificates for the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Sterling Commerce, Inc. 4


Contents

Configuring the SWIFTNet Server Adapter for SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202


Configuring the SWIFTNet HTTP Server Adapter for SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Configuring the SWIFTNet Client Service or Business Process for SSL . . . . . . . . . . . . . . . . 202
Configuring the SSL Setup on the SWIFTNet MEFG Server . . . . . . . . . . . . . . . . . . . . . . . . . 203
Installing the SWIFTNet MEFG Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Configuring Fail-over Processing Using the SWIFTNet MEFG Server . . . . . . . . . . . . . . . . . 206
Starting the Command Line Adapter 2 Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Monitoring the Status of the SWIFTNet MEFG Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Starting and Stopping the SWIFTNet MEFG Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Monitoring the SWIFTNet MEFG Server Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
SWIFTNet Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
How the Application Supports the Use of Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Support for Local Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Automatic Process to Resend a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Automatic Process to Resolve a Sequence Gap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Input Channel Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Monitoring the Input Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Configuring the Application Components to Use the Input Channel . . . . . . . . . . . . . . . . . . . . . . . 212
Configuring the SWIFTNet Server Adapter and Resend Scheduler. . . . . . . . . . . . . . . . . . . . 213
Configuring the SWIFTNet Client Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Creating a New Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Deleting an Existing Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Opening an Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Automatically Opening an Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Manually Opening an Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Closing the Input Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Automatically Closing the Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Manually Closing the Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Sending an InterAct Message Using the Input Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Document Tracking for SWIFTNet Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Monitoring the SWIFTNet Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Monitoring the SWIFTNet Communication Session Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
SWIFT Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Editor Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Editing SWIFT Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Reviewer Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Searching for SWIFT Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Setting Default Configuration Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
SWIFT Message Entry Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
SWIFT Message Entry Workstation Display and Usability Features . . . . . . . . . . . . . . . . . . . . . . 247
Installing Available Message Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Installing Older MT Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
SWIFT Message Creation Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Creating a SWIFT Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Searching for a SWIFT Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Search Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Search Results Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Verifying SWIFT Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Tracking SWIFT Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Deleting a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Sterling Commerce, Inc. 5


Contents

Copying a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255


SWIFT Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Text Validation Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Specific Error Codes for MUG-textval Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Special Error Codes for Value-Added Service Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Message Syntax and Semantic Rule Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Rules 000-099 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Rules 100-199 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Rules 200-299 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Knn: Code Word Validation in Generic Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
Header Validation Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Error Codes for SWIFT MX Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
SWIFTNet Routing Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Creating a SWIFTNet Routing Rule and Associating it with a Business Process. . . . . . . . . . . . . 295
Searching for a SWIFTNet Routing Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Searching for a Routing Rule by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Searching for a Routing Rule from a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Deleting a Routing Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Exporting and Importing a SWIFTNet Routing Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
SWIFTNet Service Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Creating a SWIFTNet Service Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Searching for a SWIFTNet Request Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Searching for a Request Type by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Searching for a Request Type from a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Exporting and Importing a SWIFTNet Service Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
SWIFTNet Copy Service Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Creating a SWIFTNet Copy Service Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Searching for a SWIFTNet Copy Service Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Searching for a Copy Service Profile by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Searching for a Routing Rule from a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Configuring the WebSphere MQ Adapter/Suite to Communicate with SWIFT . . . . . . . . . . . . . . . . . . 303
Configuring the Application to Retrieve Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Configuring the Application to Send Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Configuring the UMID and Block S Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Sterling Commerce, Inc. 6


SWIFT and SWIFTNet with the Application

SWIFT and SWIFTNet with the Application

Overview
The application supports the use of Society for Worldwide Interbank Financial Telecommunications
(SWIFT), a standard for the financial industry from SWIFT™ that uses the SWIFTNet transport protocol
to enable real-time store-and-forward financial messaging through the InterAct and FileAct file protocols.
The SWIFT standards data dictionary is optionally installed from the Deployment > Standards page. It
supports all SWIFT Standards Release messages loaded in the standards database. The SWIFT standards
data dictionary also contains the special exception and code word validations, and the codes words and
qualifiers necessary for the validation of the ISO 15022 messages (500 series). This information is used to
automatically generate the translator_swift.properties.in file, which is used by the translator to perform the
validations.
Note: You can create a map for all SWIFT Standards Release messages through the Map Editor. All
messages are validated by the application for syntax (that is, field types, field lengths, and so forth).
All SWIFT message are validated for syntax and semantics.
The following messages are supported with both inbound and outbound syntax validation and semantic
validation (that is, validating the message rules) of the messages between the application and SWIFT:
✦ All SWIFTNet 2005 message types
✦ All SWIFTNet 2006 message types
✦ All SWIFTNet 2007 message types
✦ All SWIFTNet 2008 message types
✦ All SWIFTNet 2009 message types
✦ All SWIFTNet 2010 message types
✦ SWIFTNet Funds (version 1.0, 3.0, and 4.0) and Funds Rulebook Version 4.0
✦ SWIFTNet Alternative Funds version 4.1 and Alternative Funds Rulebook Version 4.1
✦ SWIFTNet Fund Processing Passport 2009 version 4.2 and Funds Rulebook Version 4.2
✦ SWIFTNet Cash Reporting (version 3.0, 3.1, 3.2, 4.0, and 5.0) and the Cash Reporting Rulebook
(versions 3.1, 4.0, and 5.0)
✦ SWIFTNet Cash Management version 4.0
✦ SWIFTNet Transaction Reporting version 1.0
✦ FpML version 1.0
✦ SWIFTNet Exceptions & Investigations (version 1.0, 1.1, and 1.2)
✦ SWIFTNet Trade Services Utility (version 1.0 and 2.0)
✦ SWIFTNet Bulk Payment version 2.0
✦ SWIFT SCORE versions 2.0, 2.3, and 2.4
✦ SWIFT Proxy Voting versions 1.0, 1.1, and 1.2
✦ SWIFTNet eMandate version 1.0

Sterling Commerce, Inc. 7


SWIFT and SWIFTNet with the Application

Additionally, the application allows you to create maps to support the translation of market practices, and
provides the following two Market Practices:
✦ Germany: MT515: Trade Confirmation (Broker to Asset Manager)
✦ United States: MT536: ISITC-IOA: Statement of Transactions
For Market Practices, the SWIFT standard validations are performed unless the Market Practice has
customized a particular validation (for example, restricting a code word validation list). Market Practice
code word and qualifier validations are maintained in property files separate from the SWIFT standard
property files. By keeping the Market Practices you create separate, we can deliver updates to the SWIFT
standard without overwriting your custom-implemented Market Practices. Similarly, semantic validation
rules for Market Practices are stored in an extended rule library separate from the library that implements
the SWIFT standard semantic validation rules. Please note that the standard property files and semantic
validation rules are used when the implemented Market Practice does not override them.
The application also supports SWIFT System Messages (MT category 0; for example, MT096 FIN Copy to
Central Institution) which relate to the sending or receiving of messages used to customize your FIN
operating environment, SWIFT user-to-user messages (MT categories 1-9), User-to-SWIFT messages (for
example, Delivery Notifications, Retrievals, and so forth), and SWIFT-to-user messages (for example,
Retrieved Messages, Non-Delivery Warnings, and so forth).
In addition, support for SWIFT requires you to create inbound and outbound SWIFT envelopes. You must
also create a business process or processes to order the flow of the application activities so you can
accomplish your business objectives with SWIFT.
For more information on the SWIFT standard, access this web site:
http://www.swift.com

Sterling Commerce, Inc. 8


SWIFT and SWIFTNet with the Application

This table describes how the application supports SWIFT:

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

SWIFT standards data Š Provides all validation for field tags and Š Populate the external codes lists:
dictionary structures for SWIFT messages. SWIFT_Addresses,
SWIFT_BaseAddresses (only
Š References a SWIFT extended rule library
needs to be populated when
that is automatically checked in so you can
address verification is enabled),
use it with your maps.
SWIFT_Currencies,
Š SWIFT_FINMessageTypes code list, SWIFT_Countries,
supplied as part of the install, which contains IBAN_Formats,
a list of valid SWIFT message types. SWIFT_BICPlusIBAN, and
SEPARouting.
Š If you purchase a Financial Services license,
you have access to XML standards once you Š If you want to use BIC+ Validation,
download them. you must also populate the
BICPlusIBAN code list.
See SWIFT Envelopes on page 18.
Š Install the SWIFT standards data
dictionary.
Note: The data dictionary is
optionally installed from the
Deployment > Standards
page. The SWIFT rule
libraries for 2008 and
forward are installed by
installing the SWIFT
Standards InstallShield
package.

SWIFT Market Practices The following two market practices are available Š Install the SWIFT standards data
in the application: dictionary.
Š Germany: MT515: Trade Confirmation The data dictionary is optionally
(Broker to Asset Manager) installed from the Deployment >
Standards page. The SWIFT rule
Š United States: MT536: ISITC-IOA:
libraries for 2008 and forward are
Statement of Transactions
installed by installing the SWIFT
You can create a new message type by Standards InstallShield package.
customizing a standard SWIFT message type
map according to the specifications of the Š You can create a new message
Market Practice. The customized map can be type by implementing the
imported into the SWIFT Market Practices data additional restrictions related to
dictionary through the SWIFTRuleImporter the desired Market Practice.
utility.

Sterling Commerce, Inc. 9


SWIFT and SWIFTNet with the Application

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

Services Š Generic Envelope service envelopes SWIFT Š Install the SWIFTNet MEFG
messages. Server on a machine running
Note: The Generic envelope service either the Sun Solaris 5.10,
assumes that SWIFT expects a Windows Server 2003 (Standard
starting CRLF (carriage return/line or Enterprise Edition), or AIX 5.3
feed) but not an ending CRLF. operating system.

Š Generic Deenvelope service deenvelopes Š Configure the SWIFTNet Client


SWIFT messages. Service.
Note: The Generic Deenvelope service Š Configure the SWIFTNet Server
assumes that SWIFT expects a adapter.
starting CRLF (carriage return/line
feed) but not an ending CRLF.
Š EDI Deenvelope service accepts SWIFT
messages.
Š SWIFTNet Server Adapter.
Š SWIFTNet Client Service.
Š SWIFTNet Reconciliation Service.
Š SWIFTNet HTTP Server Adapter.
Š An application, SWIFTNet MEFG Server,
supports FileAct and InterAct processing, as
well as failover processing.

Envelopes Š Inbound SWIFT envelope wizard to Š Create the appropriate SWIFT


implement inbound SWIFT messages. envelopes for each message type
you are sending and receiving.
Š Outbound SWIFT envelope wizard to
implement outbound SWIFT messages. Š You need to populate four code
lists to use in conjunction with the
Š The SWIFT_FINMessageTypes code list is
SWIFT_FINMessageTypes code
automatically installed with the application.
list to perform SWIFT validations.
This code list contains a list of valid
message types. Š Configure the EDI Encoder
service for use with the outbound
Š Deenvelope functionality supports SWIFT
SWIFT messages.
system messages and user-to-user
messages.

Sterling Commerce, Inc. 10


SWIFT and SWIFTNet with the Application

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

Predefined business Š SWIFTDeenvelope business process The business processes that are
processes related to the SWIFTNet workflow
Š SWIFTEnvelope business process must have the Document Tracking
Š SWIFTNetClient business process option enabled when you check in or
edit the business process.
Š SWIFTNetClientFA business process Additionally, you need to configure
Š handleSWIFTNetServerSnFRequest other parameters in the
SWIFTNetClient business process to
Š handleSWIFTNetInboundCorrelation support SWIFTNet.
Š handleSWIFTNetOutboundCorrelation
Š handleSWIFTNetServerFADelNotif
Š handleSWIFTNetServerFAEvent
Š handleSWIFTNetServerFARequest
Š handleSWIFTNetServerFASnFDelNotif
Š handleSWIFTNetServerFASnFRequest
Š handleSWIFTNetServerRequest
Š handleSWIFTNetServerSnFDelNotif
Š handleSWIFTNetServerFASnFEvent
Š handleSWIFTNetSnFInboundCorrelation
Š handleSWIFTNetSnFOutboundCorrelation
Š SWIFTMessageEntryOutbound
Š handleSWIFTNetOpenInputChannel
Š SWIFTNetOpenInputChannel
Š SWIFTMessageEntryOutbound
Š SWIFTNet3rdPartyClientForceRefusal
Š SWIFTNet3rdPartyClientNotification
Š SWIFTNetClientRenewSecContext
Š SWIFTNetClientResend
Š SWIFTNetCloseInputChannel
Š SWIFTNetCreateInputChannel
Š SWIFTNetDeleteInputChannel

Sterling Commerce, Inc. 11


SWIFT and SWIFTNet with the Application

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

Map Editor Š Map Editor wizard enables you to generate a Š Download Map Editor.
file layout using the MT or MX message that
you select. Included in the SWIFT map are
Š Create a map or maps to translate
your SWIFT messages.
groups, records, composites, and fields that
are defined by SWIFT. Š Place custom extended rule code
Š Properties dialog boxes that enable you to inside a validation block.
define and modify SWIFT map components.
Š Autolink function automatically creates links
between input and output fields that have the
same name or business name. This function
can be used with any data format.
Š Extended Rules Library function (used with
SWIFT and any other data format) contains
a list of rules in a separate file outside of the
Map Editor source. Map Editor stores the
name of the library in its source file, so when
you load a map the library is also loaded and
compiled. This enables you to create a
library of extended rules and then add it to
any other map, so you do not have to
recreate those extended rules after the first
time.
Š Extended rules are used to validate SWIFT
messages.
Š SWIFT MX validations are performed and
generated maps define the parameters used
to look up validations that are defined in a
properties file.

Sterling Commerce, Inc. 12


SWIFT and SWIFTNet with the Application

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

Extended Rule Libraries The extended rule libraries that are loaded None
automatically when you download SWIFT and
SWIFTNet Financial Services XML standards
are:
Œ SWIFT_2002.erl
Œ SWIFT_2005.erl
Œ SWIFT_2006.erl
Œ SWIFT_2007.erl
Œ SWIFT_2008.erl
Œ SWIFT_2009.erl
Œ SWIFT_2010.erl
Œ SWIFTMX_ v1-0.erl
Œ SWIFTMX_BulkPayments_v2-0.erl
Œ SWIFTMX_CashManagement_v4-0.erl
Œ SWIFTMX_CashReporting_v1-0.erl
Œ SWIFTMX_CashReporting_v3-0.erl
Œ SWIFTMX_CashReporting_v3-1.erl
Œ SWIFTMX_CashReporting_v3-2.erl
Œ SWIFTMX_CashReporting_v4-0.erl
Œ SWIFTMX_CashReporting_v5-0.erl
Œ SWIFTMX_EI_v1-0.erl
Œ SWIFTMX_EI_v1-1.erl
Œ SWIFTMX_EI_v1-2.erl
Œ SWIFTMX_e-Mandate_v1-0.erl
Œ SWIFTMX_FpML_v1-0.erl
Œ SWIFTMX_Funds_v2-0.erl
Œ SWIFTMX_Funds_v2-1.erl
Œ SWIFTMX_Funds_v2-2.erl
Œ SWIFTMX_Funds_v3-0.erl
Œ SWIFTMX_Funds_v3-1.erl
Œ SWIFTMX_Funds_v4-0.erl
Œ SWIFTMX_Funds_v4-1.erl
Œ SWIFTMX_Funds_v4-2.erl
Œ SWIFTMX_ProxyVoting_v1-0.erl

Sterling Commerce, Inc. 13


SWIFT and SWIFTNet with the Application

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

Extended Rule Libraries Œ SWIFTMX_ProxyVoting_v1-1.erl None


(continued)
Œ SWIFTMX_ProxyVoting_v1-2.erl
Œ SWIFTMX_SCORE_v2-0.erl
Œ SWIFTMX_TradeServices_v1-0.erl
Œ SWIFTMX_TradeServices_v2-0.erl
Œ SWIFTMX_TransactionReporting_v1-0.erl

SWIFTNet Correlations Š Enables you to search for SWIFTNet Š Run inbound and outbound data
messages using specific criteria. and then use the search interface
to search for messages.
Š If you are upgrading from a
previous version to the Sterling
Standards Library Version 5.3,
you must run the
SwnetCorrMigrate.cmd script to
migrate correlation detail records
to new database tables.

Document Tracking Š Support for monitoring SWIFTNet data Š Use the data flow interface to
flows. track inbound and outbound
SWIFTNet processes.
Š Support for tracking SWIFTNet messages
within the application. The tracking and Š All the business processes that
correlation functionality automatically tracks are related to the SWIFTNet
the SWIFTNet messages the same manner workflow (SWIFTNetClient,
as the other standards are tracked. handleSWIFTNetServerRequest,
and
Š Support for document repair and resend.
handleSWIFTNetServerSnfReque
st) must have the Document
Tracking option enabled when you
check in or edit the business
processes.
Š Access messages with Ready To
Edit status, repair, and resend
them.

SWIFTNet Routing Rule Š Interface to support creation, modification, Š Create a business process or
and deletion of SWIFTNet routing rules. modify the SWIFTNetClient
business process.
Š The criteria specified in the SWIFTNet
Routing Rule enables a user to set a specific Š Create a SWIFTNet routing rule
business process to process the incoming that is linked to the business
request from SWIFTNet. process you created.
Š You can also use wildcards in the SWIFTNet
routing rule.

Sterling Commerce, Inc. 14


SWIFT and SWIFTNet with the Application

Functionality Enhancements Action You Need to Take to


Implement SWIFTNet

SWIFTNet Service Enables you to associate SWIFTNet Request Š Create a new SWIFTNet Service
Profile Type with a Schema for Header Validation. Profile.

SWIFTNet Copy Service Enables you, as a third party, to specify the Š Create a SWIFTNet Copy Service
Profile relationship between a Service Name and Copy Profile if you are using T or Y
Mode (T or Y Copy). Copy.

SWIFT Message Editor Š Interface to enable a user to correct a Š Assign permissions for two
SWIFT MT or MX message that was different roles: the Editor and the
returned due to an error either in Reviewer and give appropriate
transmission or translation. permission sets to each role.
Š Support for validating messages. Š Correct appropriate messages
and notify the appropriate user
that activity is required.
Š Review change history for
messages.

SWIFT Message Entry Interface to enable manual message entry using Š Assign permissions for the three
Workstation a structured message editor. different roles (Creator, Verifier,
Tracker).
Š Create, verify, view (read-only),
and track new SWIFT messages
created through this interface.

Input Channel The SWIFTNet 6.1 release introduces the You must configure the following
concept of an input channel. Currently, the three application components to use
application only supports the use of input the input channel:
channel for InterAct messages in
store-and-forward (SnF) mode. An input channel
Š SWIFTNet Server Adapter
can be used by the messaging interface to Š Resend Scheduler
establish an input session with SWIFT. The
input session starts when the messaging
Š SWIFTNet Client Service
interface opens the input channel and ends (including configuring a predefined
when the messaging interface closes the input business process to create a new
channel. The input channel also supports input channel)
sender-to-receiver first-in-first-out (FIFO), which
means that each message is delivered only one
time and minimizes the number of possible
duplicates.

SWIFTNet Monitor Displays the status of the SWIFTNet queues View the SWIFTNet Monitor.
and channels, including the input channel.

Prerequisite Knowledge
The audience using this software should be familiar with the application, the SWIFTNet standard, and using
InterAct and/or FileAct.
Note: This documentation is not intended to explain the SWIFTNet standard.

Sterling Commerce, Inc. 15


SWIFT and SWIFTNet with the Application

Using SWIFTNet
To use SWIFTNet with the application, you must complete the following tasks:
1. Download the SWIFT standards data dictionary. See Downloading and Installing the SWIFT
Standards Data Dictionary on page 17.
2. Create inbound and outbound SWIFT envelopes. See SWIFT Envelopes on page 18.
3. Create the necessary code lists and maintain them as needed. See Maintaining the External Code Lists
on page 22.
4. Enable the document tracking option for all the business processes that are related to the SWIFTNet
workflow. See Document Tracking for SWIFTNet Transport on page 234 and SWIFT and SWIFTNet
Business Processes on page 72.
5. Configure the EDI Encoder service for use with outbound SWIFTNet messages. See Configuring the
EDI Encoder Service for SWIFT Outbound Messages on page 67.
6. Create the appropriate SWIFT maps. See Creating SWIFT Maps on page 115.
7. Configure the SWIFTNet routing rule. See Creating a SWIFTNet Routing Rule and Associating it with
a Business Process on page 295.
8. Create a SWIFTNet Service Profile.
9. Create a SWIFTNet Copy Service Profile.
10. Use SWIFT Alliance Access (SAA) for SWIFT support.
11. Use the WebSphere MQ adapter to communicate with SAA.

Using InterAct
To use InterAct with the application, you must complete the following tasks:
1. Configure the appropriate service parameters, including failover processing configuration. See
SWIFTNet Server Adapter and SWIFTNet Client Service.
2. Configure the SWIFTNet MEFG Server for InterAct processing. See SWIFTNet MEFG Server on
page 189.

Using FileAct
To use FileAct with the application, you must complete the following tasks:
1. Configure the appropriate service parameters. See SWIFTNet Server Adapter and SWIFTNet Client
Service.
2. Configure the SWIFTNet MEFG Server for FileAct processing. See SWIFTNet MEFG Server on page
189.

Sterling Commerce, Inc. 16


SWIFT and SWIFTNet with the Application

Downloading and Installing the SWIFT Standards Data Dictionary


Before you install the SWIFT standards data dictionary (standards database) on your desktop, consider these
guidelines:
✦ Download the Map Editor.
✦ For the most current version of the SWIFT standards, contact Sterling Commerce Customer Support.
✦ Be sure your desktop meets the Windows Client requirements listed in the application System
Requirements.
To download and install the standards database:
1. From the application Deployment menu, select Standards.
2. In the Download and Install section next to Download SWIFT Standards, click Go!
3. In the File Download dialog box, select a download option, then click OK.
Š If you choose to run the file click Run and the operating system downloads the files immediately.
Š If you choose to save the file, the operating system prompts you to save the file. Browse to the
location where you want to download the file and click OK. If you want to continue installing, run
the file you just saved from the location you specified.
4. In the Security Warning page, select Always trust content from Sterling Commerce (Mid
America), Inc. if you do not want to see similar security messages in the future when you download
software from Sterling Commerce. Click Yes.
5. In the Welcome window, click Next.
6. In the Choose Destination Location window, select where you want to install the standards database:
Š If you accept the default location, click Next.
Š If you want to specify a different location, click Browse, specify the path to the folder, click OK,
and click Next.
If you specify a folder name that does not exist, the application displays a message asking if you want
to create that folder.
7. In the Select Components window, verify that SWIFTStandardDatabase is selected (if you want to
use the preloaded SWIFT market practices, also ensure that SWIFTMarketPractice is selected) and
click Next.
The download wizard installs the standards database.
8. In the Setup Complete window, click Finish.

Sterling Commerce, Inc. 17


SWIFT Envelopes

SWIFT Envelopes

Overview
A document envelope consists of control information that enables organizations to effectively exchange
messages. This information is added in headers and trailers to messages. Document envelopes are specific
to the message protocol used. Creating document envelopes is necessary to use SWIFTNet with your trading
partners.
SWIFTNet has only one level of envelope, which you must modify appropriately to reflect your information
and your trading partner’s information. Envelopes specify whether the message is inbound or outbound:
✦ The Inbound SWIFT envelope identifies messages that are received by Gentran Integration Suite so
they can be properly routed. Inbound envelopes also give you the option to translate messages when
you choose to check messages for compliance. By choosing to translate messages from within the
envelope, you can reduce message processing time because you do not need to specify a separate
Translation service step in the business process. You need to create an Inbound SWIFT envelope to
configure deenveloping information for MT or MX messages. See Inbound SWIFT envelope on page
25.
✦ The Outbound SWIFT envelope identifies messages so they can be sent to and received by trading
partners. You need to configure an Outbound SWIFT envelope to configure enveloping information
for MT or MX messages. See Outbound SWIFT envelope on page 44.
When you envelope an outbound SWIFTNet message, the SWIFTNet header and trailer are created. For an
inbound message, the envelope contains the header information (the trailer information is a summary
appended to the SWIFTNet data). The header types are MX or MT messages.
MT and MX messages are included within the Body element. MT messages are base-64 encoded and MX
messages are XML.
The application also enables you to use SWIFT XML Format 2, the envelope supported by SWIFT Alliance
Access 6.
As part of SWIFTNet enveloping, the application uses code lists to validate the data. The application uses
code pairs in code lists to identify items in transactions between two or more trading partners. A trading
partner code list consists of one or many pairs of code values containing a sender code and a receiver code.
Each code pair has one description and up to four additional codes relating to the pair. Code lists are
dynamic and are stored in a database.
The SWIFT_FINMessageTypes code list is automatically installed with the application. This code list
contains a list of valid SWIFT message types. The three-digit message number is entered for sender code
and receiver code, and the description is set to SWIFT Message Type. However, you need to populate four
additional code lists to perform SWIFTNet validations:
✦ SWIFT_Addresses—used to check the sender and receiver IDs within the message. This code list is
shared with message authentication. The code list used is the same code list that is used for message
validations. You will type the address in the Sender Code, Receiver Code, and Description parameters,
and use the Text1 parameter to indicate the subtype of the address. The SWIFT_Addresses and
SWIFT_BaseAddresses code lists are used to differentiate between bad base addresses and bad branch
codes when necessary. The SWIFT_Addresses code list is also used for verification of those addresses

Sterling Commerce, Inc. 18


SWIFT Envelopes

that are contained within the body of a message. BIC and BEI addresses are validated against entries in
the SWIFT_Addresses code list
✦ SWIFT_BaseAddresses—this is a list of the 8-character address (the BIC minus the branch code) that
are valid as part of a sender address when generating a message. You will type the eight-digit code in
the Sender Code, Receiver Code, and Description parameters. The SWIFT_Addresses and
SWIFT_BaseAddresses code lists are used to differentiate between bad base addresses and bad branch
codes when necessary.
Note: You only need to populate the SWIFT_BaseAddresses code list when you have enabled address
verification. See Enabling and Disabling Address Verification on page 21.
✦ SWIFT_Currencies—this is a list of the valid currencies that can be used in a SWIFT message. You
will use the Text1 parameter to indicate the maximum number of digits after the decimal point that the
currency supports. Amount and Currency values are validated against ISO entries in the
SWIFT_Currencies code list.
✦ SWIFT_Countries—this is a list of the valid countries that can be used as part of the address when
generating a SWIFT message. IBAN values and Country codes are validated against entries in the
SWIFT_Countries code list.
✦ SWIFT_IBANFormat—this is a list of specific IBAN formats that countries may use. This code list
is used with BICPlusIBAN validation.
The details of this code list are as follows:
Note: A plus sign indicates those fields are concatenated together. Underscore and semi-colon characters
act as delimiters and are added to the code list data.

Parameter Field Name (refers to the name defined in the SWIFT data files)

SenderID IBAN Country Code 3

ReceiverID IBAN Country Code 3

Description IBAN Country Code 3

Text1 IBAN Country Code Position 4; IBAN Country Code Length 5

Text2 IBAN Check Digits Position 6; IBAN Check Digits Length 7

Text3 Bank Identifier Position 8;bank Identifier Length 9

Text4 Branch Identifier Position 10;branch Identifier Length 11

Text5 IBAN National ID Length 12;

Text6 Account Number Position 13;account Number Length 14

Text7 IBAN Total Length 15

✦ SWIFT_BICPlusIBAN and BICPlusIBAN—these are lists of the clearing codes used for validating
BICPlusIBAN combinations and clearing codes. These lists replace the older BIC+ database (and in
the application, the SWIFT_ClearingCodes code list). Depending on which application you are using,
you will use one of these lists. Financial institutions can look up any missing BICs linked to the IBANs
for every financial institution in the 31 SEPA countries. They can also validate the IBANs and BICs,
including their relationship.

Sterling Commerce, Inc. 19


SWIFT Envelopes

Note: The BICPlusIBAN directory is a replacement for the BIC+ database.


The details of this code list are as follows:
Note: A plus sign indicates those fields are concatenated together. Underscore and semi-colon characters
act as delimiters and are added to the code list data.

Parameter Field Name (refers to the name defined in the SWIFT data files)

SenderID IBAN Country Code 19 + Unique IBAN National ID, or Clearing Code 21

ReceiverID BIC Code 7 + Branch Code 8

Description Institution Name 4

Text1 Parent Bank Code 15

Text2 IBAN BIC Code 11

Text3 IBAN Branch Code 12

Text4 Routing BIC Code 13

Text5 Routing Branch Code 14

Text6 Subtype Indicator 15

Text7 Service Codes 26

Text8 CHIPS UID 24

✦ SWIFT_SEPARouting—this contains the SEPA Routing Directory. With the SEPA Routing
Directory, banks sending SEPA payments can verify whether the operational BICs of their
correspondent are SEPA-adherent and operationally ready for SEPA, and can verify the channel
through which they can be reached for routing payments. Therefore, the SEPA Routing Directory
provides the operational information necessary to exchange SEPA payments with the institutions listed
in the EPC Register of Participants. As recommended by the EPC, the directory only contains data
related to adherent institutions whose reference BIC is published in the EPC Register of Participants.
The directory contains information on receiving banks that are SEPA compliant and shows the
supported channels for each, across Clearing and Settlement Mechanisms (CSMs), Automated
Clearing Houses (ACHs), and intermediary banks. The details of this code list are as follows:
Note: A plus sign indicates those fields are concatenated together. Underscore and semi-colon characters
act as delimiters and are added to the code list data.

Parameter Description

SenderID BIC Code 4 + Branch Code 5 _ Service Level 9 _ Scheme Instrument 10

ReceiverID BIC Code 4 + Branch Code 5 _ Service Level 9 _ Scheme Instrument 10

Description Institution Name 6

Text1 Branch Code 5

Text2 Service Level 9

Text3 Scheme Instrument 10

Sterling Commerce, Inc. 20


SWIFT Envelopes

Parameter Description

Text4 Country Code 8

Text5 Operational Readiness Date 12

Text6 Valid From; Valid To 18

Text7 Adherent Institution Flag 11

Text8 Intermediary Institution BIC 16

Text9 [Payment Channel Id 13 : Reachability Type 15: Preferred Channel Flag 14]0-n

✦ NISOLanguage—Language codes are validated against ISO entries in the NISOLanguage code list.
See Maintaining the External Code Lists on page 22.
SWIFT codes list validations are applied to both SWIFT MT and MX messages for currencies, country
codes, BIC/BEI addresses, and International Bank Account Number checksum validation (IBAN). The
application allows you to define codes lists for currencies, countries, and BIC or BEI addresses (which are
validated against the SWIFT_Addresses code list). IBAN data contains a country code that is validated
against the SWIFT_Countries code list in the application, and additional IBAN validation is handled
internally by the translator.
The validation of the SWIFT special functions <CUR>, <SWIFTBIC>, <NON-SWIFTBIC>, <CC>, and
<IBAN> use these code lists. You must update and maintain these codes lists, as necessary.
For outbound SWIFTNet messages, you also need to configure the EDI Encoder service to include the
proper values for the following parameters:
✦ AccepterLookupAlias
✦ ReceiverID
✦ SenderID
✦ ReceiverIDQual
✦ SenderIDQual
See Configuring the EDI Encoder Service for SWIFT Outbound Messages on page 67.
Note: When editing a SWIFT envelope, if you skip wizard pages by clicking Save or clicking on a later
step, the final confirmation page will display unexpected values. Also, if you skip page in the
envelope wizard and then use the Back button, incorrect pages may be displayed. If you experience
this issue, save from the confirmation screen without using the Back button and the envelope is
saved correctly. However, if you use the Back button, an unexpected page may be displayed (that
is, a page that would not normally be displayed based on the envelope values), and the page may
hang or cause you to enter an improper value. If this occurs, cancel out of the envelope wizard, and
start editing the SWIFT envelope again.

Enabling and Disabling Address Verification


The application allows you to enable or disable address verification. Address verification is performed using
the SWIFT_Addresses and SWIFT_BaseAddresses code lists. See Maintaining the External Code Lists on
page 22 for more information on creating these code lists.

Sterling Commerce, Inc. 21


SWIFT Envelopes

Configuring Inbound Address Verification


The enveloping.verify_addresses_while_deenveloping.SWIFT_FIN_INBOUND property enables and
disables inbound address verification.
To enable inbound address verification, complete these steps:
1. Access the install_dir/properties/enveloping.properties.in file, and change the line
enveloping.verify_addresses_while_deenveloping.SWIFT_FIN_INBOUND to TRUE, as noted
below:
enveloping.verify_addresses_while_deenveloping.SWIFT_FIN_INBOUND=True
Note: If you want to then disable inbound address verification, you can do so by accessing the
install_dir/properties/envelope.properties.in file, and change the line
enveloping.verify_addresses_while_deenveloping.SWIFT_FIN_INBOUND=FALSE.
2. Save and close the enveloping.properties.in file.
3. Stop the application.
4. Run the setupfiles script using one of the following steps:
Š (UNIX or Linux) - From the install_dir/bin directory, run the setupfiles.sh command.
Š (Windows) - From the install_dir\bin directory, run the setupfiles.cmd command.
5. Start the application.

Configuring Outbound Address Verification


To enable or disable outbound address verification, use the Outbound SWIFT envelope parameter Validate
Sender and Receiver. This parameter allows you to enable (by choosing Yes) or disable (by choosing No)
address verification. The default is No (sender and receiver verification is disabled). See Outbound SWIFT
envelope on page 44 for more information.

Maintaining the External Code Lists


All necessary code lists are automatically installed but except for the Message Type code lists, they are not
automatically populated with codes. Therefore, you need to populate the following five external code lists
for use in conjunction with the SWIFT_MessageTypes code list (all code lists are automatically installed
with the application—the SWIFT_MessageTypes code list already contains a list of valid message types) to
perform SWIFTNet validations.
The external code lists for which you need to populate SenderID, ReceiverID, Description, and occasionally
Text1 are:
✦ SWIFT_Addresses
✦ SWIFT_BaseAddresses
✦ SWIFT_Currencies
✦ SWIFT_Countries
✦ SWIFT_BICPlusIBAN
✦ SWIFT_IBANFormats

Sterling Commerce, Inc. 22


SWIFT Envelopes

✦ SWIFT_SEPARouting
You populate these code lists automatically by using the HIPAA codelist conversion map for countries to
populate it. However, prior to using the HIPAA codelist conversion map, you need to modify the import file
created using the conversion map (the import file is used to populate the codelist). To modify the import file
you need to change the codelist name from xxx to SWIFT_xxx (for example, change BICPlusIBAN to
SWIFT_BICPlusIBAN).
To populate the each code list automatically:
1. From a command line, go to the tp_import directory.
2. Type the following command to start the conversion and import process, where <map name> is the
name of the map to use during translation (without the file extension) and <code list path and
filename> is the fully qualified name of the code list to translate, including filename extension, if any:
Š If you are using Windows, hipaaconvert.cmd [-import] <map name> <code list path and
filename>
Š If you are using UNIX, hipaaconvert.sh [-import] <map name> <code list path and filename>
Do not specify the file extension for the map name when importing a code list—just indicate the base
name of the map.
The [-import] parameter is optional. You can convert the code list file without importing it. If you do
not use the [-import] parameter during conversion, you can import the resulting XML file into the
application using the import utility.
The input files and maps for each code list are as follows:

Code List Map Input File and Directory

SWIFT_Addresses SWIFTFIFIleToSWIFT_Addresses FI file from BIC directory

SWIFT_BaseAddresses SWIFTFIFIleToSWIFT_BaseAddresses FI file from BIC directory

SWIFT_BICPlusIBAN SWIFTBIFileToSWIFT_BICPlusIBAN BI file from BICPlusIBAN directory

SWIFT_IBANFormats SWIFTISFileToSWIFT_IBANFormats IS file from BICPlusIBAN directory

SWIFT_Countries SWIFTCTFileToSWIFT_Countries CT file from BIC directory

SWIFT_Currencies SWIFTCUFileToSWIFT_Currencies CU file from BIC directory

3. Once the utility completes, a translation report (hipaaconvert.rpt) and an input file (hipaaconvert.xml)
are created. If no translation errors are reported, the code list was successfully generated (and imported
if you used the [-import] parameter). A code list will not be imported if there are translation errors.
4. To modify the import file, change the codelist name from xxx to SWIFT_xxx so it can be used for
SWIFT messages.

Disabling Automatic BICPlusIBAN Validation for the SWIFT_BICPlusIBAN Code List


The SWIFT_BICPlusIBAN code list is the only code list that uses BICPlusIBAN validation. If you want to
disable the automatic BICPlusIBAN validation, access the translator_swift_2009.properties or
translator_swift_2010.properties file and change this property to NO to turn off the validation:

Sterling Commerce, Inc. 23


SWIFT Envelopes

syntax.BICPlusIBAN=YES

Creating Envelopes
Inbound envelopes define expected header and trailer information for inbound messages. This information
helps Gentran Integration Suite route and process the messages. Outbound envelopes specify information
about messages that enables them to be sent to and received by trading partners, and they gather and provide
the appropriate data used to create the header.
To create an envelope:
1. From the Admin Console, select Trading Partner > Document Envelopes > Envelopes.
2. Under Create, next to New Envelope, click Go!
3. On the Envelope Standards page, select SWIFT and click Next.
4. Select the level of envelope you want to create, inbound or outbound, and click Next.
5. On the Base Envelope page, do you want this envelope to inherit properties from a base envelope (if
available)?
Š If Yes, select a base envelope and click Next.
Š If No (you want to create a new envelope), select Not Applicable and click Next.
6. On the Name page, type a unique name for the envelope, and a description or comments, then click
Next.
7. Complete the properties for the envelope as necessary and click Next after each page until you reach
the confirm page. Required fields are highlighted in blue. See Inbound SWIFT envelope on page 25 or
Outbound SWIFT envelope on page 44.
8. Click Finish to add the envelope.

Using Base Envelopes


A base envelope is a regular envelope that you use as a starting point to create a new envelope. The base
envelope maintains a link to the envelope that inherited its properties. If you modify the base envelope, all
related envelopes (those that inherited the base envelope properties) are also changed.
When you create an envelope using a base envelope, everything in the new envelope is the same as in the
base envelope, except the envelope name, description, and parameters such as unique identification
numbers. If you plan to create many envelopes using base envelopes, do not use the base envelopes in
production. You should also be sure to note the envelopes that are related to the base envelopes.
To use a base envelope:
1. Create the base envelope, using Creating Envelopes on page 24.
2. Specify the name and description of a new envelope.
3. Identify the base envelope that the new envelope uses.

Sterling Commerce, Inc. 24


SWIFT Envelopes

Importing and Exporting Envelopes


The Import/Export feature enables you to save time and increase the accuracy of duplicating resources on
different systems. This feature enables you to move resources and data between application environments
of the same version. The Import/Export feature enables you to:
✦ Move from a test application environment to a production application environment.
✦ Move resources from one application system to another.
The ability to import and export envelopes means that you can configure resources on one system and then
move or copy them to a different system, thereby avoiding having to recreate the resources on each system.
Even if you have resources that are going to be slightly different from one system to another, you can export
the resources from one system and import them to a different system, and then make the necessary changes
to the resource on the second system.
The Import/Export feature supports several different resource types, including envelopes.
Note: Importing an export file of envelopes always requires a passphrase, even if a passphrase was not
required during the export. The passphrase is now required because of the addition of encrypted
passwords that apply to some envelopes. When you are prompted for a passphrase for envelopes
during the import of envelopes (when you did not use a passphrase when the envelopes were
exported), you can supply any value for the passphrase.

Inbound SWIFT envelope


You only need to create an Inbound SWIFT envelope if you are receiving inbound SWIFT messages.
However, if you are receiving inbound SWIFT messages, you need to create a separate Inbound SWIFT
envelope for each SWIFT message type you will be receiving. Additionally, if you are receiving SWIFT
system messages, you may need to create an Inbound SWIFT envelope using a wildcard in the Message
Type parameter, to ensure that all valid SWIFT messages are routed to a process whether the message has
an envelope that is supported or is of a supported message type.
Note: An (*) asterisk indicates that a wildcard value can be used with that parameter (for mandatory fields,
the wildcard value is an (*) asterisk and for optional fields, the wildcard value is leaving the field
blank). For Inbound envelopes, a wildcard value in the envelope matches any value in the input

Sterling Commerce, Inc. 25


SWIFT Envelopes

document, while an empty value in the envelope matches only an empty value in the input document.
For Outbound envelopes, a wildcard value is equivalent to an empty value in the envelope.

Field or Check Box Description

* Sender ID Coded identifier of the supplier number or data sender. Valid value is eight
standard characters for BIC 8. Optional.
Note: This parameter enables you to type in a new ID or pick an ID that has
already been used. When you start typing an ID, the application
returns all matching IDs existing in the system and provides a
combo-box from which you can select an ID by double-clicking it.
There must be Sender ID Codes in the system for autocomplete to
find matches and display a selection list.
Note: It is possible to leave the Sender ID parameter blank under some
circumstances. If you leave this parameter blank, it will cause errors
during the enveloping process. You must type a valid value in the
Sender ID parameter.

Sender ID Type Type of sender identifier. Valid values are * (wildcard), BIC8 (default),
Nickname, Distinguished Name. Required.
Note: The full address for BIC8 is a BIC12, which includes the one-character
logical terminal (which is specified for the sender and is always "X" for
receiver), and the 3-character branch code. These are combined to
form the BIC12.

* Receiver ID Coded identifier of the customer number or data source number. Valid value is
eight standard characters for BIC 8. Optional.
Note: This parameter enables you to type in a new ID or pick an ID that has
already been used. When you start typing an ID, the application
returns all matching IDs existing in the system and provides a
combo-box from which you can select an ID by double-clicking it.
There must be Receiver ID Codes in the system for autocomplete to
find matches and display a selection list.
Note: It is possible to leave the Receiver ID parameter blank under some
circumstances. If you leave this parameter blank, it will cause errors
during the enveloping process. You must type a valid value in the
Receiver ID parameter.

Receiver ID Type Type of receiver identifier. Valid values are * (wildcard), BIC8 (default),
Nickname, Distinguished Name. Required.
Note: The full address for BIC8 is a BIC12, which includes the one-character
logical terminal (which is specified for the sender and is always "X" for
receiver), and the 3-character branch code. These are combined to
form the BIC12.

Envelope Format The format of the envelope. Valid values are * (wildcard), FIN (default), and SAA
XML Format 2. Required.

Sterling Commerce, Inc. 26


SWIFT Envelopes

Field or Check Box Description

Message Category The category of the message. Required. Valid values are:
Š ACK/NAK (FIN only)
Š Delivery Notification (XML Format 2)
Š Delivery Report (XML Format 2)
Š History Report (XML Format 2)
Š Message (FIN or XML Format 2) (this is the default)
Š Message Status (XML Format 2)
Š Session Status (XML Format 2)
Š Transmission Report (XML Format 2)

Enforce Message Size Limit Specifies that the application will check the size of the message, and error out if
the message exceeds it. If you select this check box, the application gives you
the option to set the Maximum Message Size (which defaults to 10,000, the
standard limit for SWIFT messages). Valid values are Yes (specify maximum
size) - which is the default, Yes (use SWIFT-specified maximum size for
message type) - which uses 2000 or 10000 as the limit, as specified in the
SWIFT documentation, and No. Required.

Validate DataPDU Signature Whether to validate the protocol data unit (PDU) for a signature. Optional. Valid
values are Yes or No (default).
Note: Only displayed if Envelope Format is set to either wildcard or SAA
XML Format 2 is selected. The signature is optional.

Key Part 1 First part of the validation signature.


Note: Each part of the key must contain at least one uppercase character,
one lowercase character, and one digit. A character cannot be
repeated more than seven times (across both parts of the key).
Required only if you select Yes for Validate DataPDU Signature.

Key Part 2 Second part of the validation signature.


Note: Each part of the key must contain at least one uppercase character,
one lowercase character, and one digit. A character cannot be
repeated more than seven times (across both parts of the key).
Required only if you select Yes for Validate DataPDU Signature.

Message Format The format of the message. You must select a Message Format of wildcard (*),
MT, MX, or Any XML. If you select a wildcard, the Message Type parameter is
not displayed because it is assumed to be wildcard as well (since there is no
reason to wildcard the format and then select a specific message). If you select
MT as the Message Format, you will be given a list of MT messages for this
Message Type parameter. If you choose MX, you receive a list of the
“categories” (SWIFTNet Funds, SWIFTNet Alternative Funds, SWIFTNet Trade
Services Utility, SWIFTNet Exceptions and Investigations, SWIFTNet Cash
Reporting) for this Message Type parameter. Once you select the subtype, you
are presented with a list of the message types for that category, in the format
camt.003.001.02 (Get Account).

Sterling Commerce, Inc. 27


SWIFT Envelopes

Field or Check Box Description

MX Message Area Transaction message type as determined by the information type in the header
of the message group, which includes the message, or determined by the
information type in the transaction message. Required.
Valid selections are:
Š * (wildcard)
Š Bulk Payments
Š Cash Management
Š Cash Reporting
Š Exceptions and Investigations
Š Funds
Š Proxy Voting
Š SCORE
Š Trade Services
Š Transaction Reporting
Š Alternative Funds
Š e-Mandate
Š Funds Processing Passport
Note: The message area for MX messages.

The lists of Message Types are generated from two property files.
The first property file (ui_swift_message_types.properties) will contain
the base lists of the types provided with the application. The second
property file (ui_swift_message_types_customer.properties) is
user-modifiable, and can also contain additional messages that you
want to add. If you add Message Types to the
ui_swift_message_types_customer.properties property file, modify it
in the customer_overrides.properties file. You are not required to
restart the application when you edit the
ui_swift_message_types_customer.properties file.

You can also select the default, which is * (wildcard).

Sterling Commerce, Inc. 28


SWIFT Envelopes

Field or Check Box Description

Message Type Transaction message type as determined by the information type in the header
of the message group, which includes the message, or determined by the
information type in the transaction message. This list includes SWIFT system
messages. Required.
Note: If you are receiving SWIFT system messages, you either need to
create an Inbound SWIFT envelope using a wildcard in the Message
Type parameter or create a separate Inbound SWIFT envelope for
each SWIFTNet system message type you will receive, to ensure that
all valid SWIFT messages are routed to a process whether the
message has an envelope that is supported or is of a supported
message type.
Note: The message type for MX messages are the full 4-component string
(for example, camt.003.001.02). You are first allowed to select a
Message Format of wildcard, MT, and MX. If you select a wildcard,
this Message Type parameter is not displayed because it is assumed
to be wildcard as well (since there is no reason to wildcard the format
and then select a specific message). If you select MT as the Message
Format, you will be given a list of MT messages for this Message Type
parameter. If you choose MX, you receive a list of the “categories”
(SWIFTNet Funds, SWIFTNet Alternative Funds, SWIFTNet Trade
Services, SWIFTNet Exceptions and Investigations, SWIFTNet Cash
Reporting) for this Message Type parameter. Once you select the
subtype, you are presented with a list of the message types for that
category, in the format camt.003.001.02 – Get Account Information.
The envelope UI code will be modified to allow us to do this while still
saving the value under a single envelope parameter.

The lists of Message Types are generated from two property files.
The first property file (ui_swift_message_types.properties) will contain
the base lists of the types provided with the application. The second
property file (ui_swift_message_types_customer.properties) is
user-modifiable, and can also contain additional messages that you
want to add. If you add Message Types to the
ui_swift_message_types_customer.properties property file, modify it
in the customer_overrides.properties file. You are not required to
restart the application when you edit the
ui_swift_message_types_customer.properties file.

You can also select the default, which is * (wildcard).

Scheme Instrument Set the scheme instrument. Valid values are SCT (SEPA Credit Transfer), SDD
(SEPA Direct Debit), or None. This parameter is only used for MX messages in
the Bulk Payments and SCORE SWIFT Solutions.

Validation Flag (tag 119) Specifies how to validate the message. Required. Default is * (wildcard).
Note: Be sure to configure your SWIFT envelopes appropriately for the
version of SWIFT that you are using.

Reconcile Message Reference Whether to reconcile the Message User Reference (MUR) against a control
against a control number number. Valid values are Yes (default) and No.
The MUR is a message identifier separate from the one SWIFT assigns.
Required.

Sterling Commerce, Inc. 29


SWIFT Envelopes

Field or Check Box Description

Use global control number Whether to use a global control number. Required. Valid values are:
Š Yes (default)
Š Yes (and generate name from data)
Note: If you select this option, you must select at least one parameter for
Primary Name Format.
Š No
Note: Only displayed if you selected Yes for Reconcile message User
Reference (MUR) against a control number.

Perform Duplicate Control Determine control number/MUR duplications. Required. Valid values:
Number (MUR) Checking
Š Yes
Š No (default)
Note: Only displayed if you selected Yes for Reconcile message User
Reference (MUR) against a control number.

Maximum age of Control Number Maximum days that Gentran Integration Suite should retain a history of control
History Records in days numbers to use for duplication determinations. Valid value is nine numerics.
Optional.
Note: Only displayed if you selected Yes for Reconcile message User
Reference (MUR) against a control number.

Assign control number Select a control number with this envelope. Optional.
Displayed only if Use Global Control Number is set to Yes

Local control number Select a local control number to associate with this envelope. Default is 1.
Required.
Displayed only if Use Global Control Number is set to No.

Sterling Commerce, Inc. 30


SWIFT Envelopes

Field or Check Box Description

Primary Name Format Check boxes to instruct what information to include when generating a name for
a primary global control number and finding the correct number to assign based
on that name. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated global control number (Use global
control number is set to Yes (and generate name from data)), the
application tries to generate and match the following control numbers:
Š First, it tries to generate and match the control number in the primary name
format (replacing the values that are selected for the corresponding value in
the message). For example, if only message type is selected, and the
message type is 100, the application checks for the control number
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing control number that matches the names
generated in steps 1-3, a control number with the name assigned in the first
step is created.

Sterling Commerce, Inc. 31


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating a global control number.
The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated global control number (Use global
control number is set to Yes (and generate name from data)), the
application tries to generate and match the following control numbers:
Š First, it tries to generate and match the control number in the primary name
format (replacing the values that are selected for the corresponding value in
the message). For example, if only message type is selected, and the
message type is 100, the application checks for the control number
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing control number that matches the names
generated in steps 1-3, a control number with the name assigned in the first
step is created.

Sterling Commerce, Inc. 32


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating a global control
number. The system allows for two alternatives if the Primary Name Format is
not found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated global control number (Use global
control number is set to Yes (and generate name from data)), the
application tries to generate and match the following control numbers:
Š First, it tries to generate and match the control number in the primary name
format (replacing the values that are selected for the corresponding value in
the message). For example, if only message type is selected, and the
message type is 100, the application checks for the control number
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing control number that matches the names
generated in steps 1-3, a control number with the name assigned in the first
step is created.

Maximum Message Size The maximum size of message that is allowed. The default is 10,000. This
parameter only accepts numeric input.
Only displayed if you selected Yes for the Enforce Message Size Limit
parameter. Required.

Compliance check message Check the message body for compliance. Required. Valid values are Yes
(default) and No.

Validate Output Whether to validate the output. Valid values are Yes (default) and No.

* Sender Branch Code Three-character code that further refines the Sender ID. For example, if the
SenderID is ROMANSFL, the branch code might be WAS to indicate the
Washington branch. This parameter acts as the Sender ID qualifier for envelope
matching. Required.
Note: Only displayed if Sender ID Type is set to BIC8. Sender Branch Code
is not used for SAA XML v2.0 and does not apply when Distinguished
Name and Nickname are used.

Sterling Commerce, Inc. 33


SWIFT Envelopes

Field or Check Box Description

* Receiver Branch Code Three-character code that further refines the Receiver ID. For example, if the
ReceiverID is ROMANSFL, the branch code might be WAS to indicate the
Washington branch. This parameter acts as the Receiver ID qualifier for
envelope matching. Required.
Note: Only displayed if Receiver ID Type is set to BIC8. Receiver Branch
Code is not used for SAA XML v2.0 and does not apply when
Distinguished Name and Nickname are used.

MX Business Area The MX business area. Valid values are * (wildcard), Funds, Trade Services
Utility, Exceptions and Investigations, Cash Reporting, Bulk Payments, Cash
Management, Proxy Voting, SCORE, Transaction Reporting, Alternative Funds,
e-Mandate, and Funds Processing Passport. Required.
Note: Only displayed if you set Message Format to MX.

Message Format The format of the message. Valid values are * (wildcard), MT (default), MX, and
Any XML. Required.

APC/FIN For an MT message using XML Format 2, this indicates whether it is a system
(APC) message or a user message (FIN). Required.
Valid values are * (wildcard—this is the default), APC, and FIN.

Scheme Instrument Set the scheme instrument. Valid values are SCT (SEPA Credit Transfer), SDD
(SEPA Direct Debit), or None. This parameter is only used for MX messages in
the Bulk Payments and SCORE SWIFT Solutions.

Closed User Group A specific set of trading partners defined within the SWIFT network. Optional.

Keep translated document after Whether to keep the translated document after the compliance check.Valid
compliance check values are Yes and No (default). Required.
Note: If you select Yes, the translated document replaces the primary
document.

Map Name Mode How to determine which map to use to perform a compliance check. Required.
Valid values are:
Š Specify (default)
Š Generate from data (this is useful if you want to share across envelopes)
Note: If you select this option, you must select at least one parameter for
Primary Name Format.

Map Name Which map to use to perform a compliance check (if Compliance Check
message set to Yes and Map Name Mode set to Yes). The map must already
be checked in to the application. Optional.

Sterling Commerce, Inc. 34


SWIFT Envelopes

Field or Check Box Description

Primary Name Format Check boxes to instruct what information to include when generating and
matching a name for the map. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated map name (Map Name Mode is set to
Generate from data), the application tries to generate and match the
following maps:
Š First, it tries to generate and match the map in the primary name format
(replacing the values that are selected for the corresponding value in the
message). For example, if only message type is selected, and the message
type is 100, the application checks for the map named
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing map that matches the names generated in
steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no matching map is found is set
to Yes.

Sterling Commerce, Inc. 35


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating a map name. The system
allows for two alternatives if the Primary Name Format is not found—checking
for the First Backup Name Format and then, if that is not found, checking for the
Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated map name (Map Name Mode is set to
Generate from data), the application tries to generate and match the
following maps:
Š First, it tries to generate and match the map in the primary name format
(replacing the values that are selected for the corresponding value in the
message). For example, if only message type is selected, and the message
type is 100, the application checks for the map named
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing map that matches the names generated in
steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no matching map is found is set
to Yes.

Sterling Commerce, Inc. 36


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating a map name. The
system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated map name (Map Name Mode is set to
Generate from data), the application tries to generate and match the
following maps:
Š First, it tries to generate and match the map in the primary name format
(replacing the values that are selected for the corresponding value in the
message). For example, if only message type is selected, and the message
type is 100, the application checks for the map named
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing map that matches the names generated in
steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no matching map is found is set
to Yes.

Generate an error if no matching Specifies whether to generate an error if the Map Name selected is not found.
map is found Valid values are Yes (default) and No.
Note: Only displayed if Map Name Mode is set to Generate from data.

Determine Error Business How to determine the business process name to use if there were errors in the
Process Name By compliance check. Required. Valid values are:
Š Specifying a Business Process name (default)
Š Generating a Business Process name from the data (this is useful if you
want to share across envelopes)
Note: If you select this option, you must select at least one parameter for
Primary Name Format.

Sterling Commerce, Inc. 37


SWIFT Envelopes

Field or Check Box Description

Primary Name Format Check boxes to instruct what information to include when generating and
matching a name for the error business process name. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated error business process name (Determine
Error Business Process Name By is set to Generating a Business
Process name from the data), the application tries to generate and
match the following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 38


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating an error business process
name. The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated error business process name (Determine
Error Business Process Name By is set to Generating a Business
Process name from the data), the application tries to generate and
match the following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 39


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating an error business
process name. The system allows for two alternatives if the Primary Name
Format is not found—checking for the First Backup Name Format and then, if
that is not found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated error business process name (Determine
Error Business Process Name By is set to Generating a Business
Process name from the data), the application tries to generate and
match the following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Generate an error if no generated Specify whether to generate an error if there is no match to the generated
business process name exists in business process name in the system. Valid values are Yes (default) and No.
the system Note: Only displayed if Determine the Error Business Process By is set
to Generating the business process name from the data.

Business Process List Select a previously created business process to associate with this envelope.
Optional.
Displayed only if Determine Error Business Process Name By is set to
Specifying the business process.

Determine the Business Process How to determine the business process name to use if there were no errors in
By the compliance check. Required.Valid values are:
Š Specifying a business process
Š Generating the business process name from the data
Note: If you select this option, you must select at least one parameter for
Primary Name Format.

Sterling Commerce, Inc. 40


SWIFT Envelopes

Field or Check Box Description

Primary Name Format Check boxes to instruct what information to include when generating and
matching a name for the business process. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated business process name (Determine the
Business Process By is set to Generating the business process
name from the data), the application tries to generate and match the
following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the first Backup Name.
Š Third, it tries to generate and match the second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 41


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating a business process name.
The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated business process name (Determine
Business Process Name By is set to Generating a Business
Process name from the data), the application tries to generate and
match the following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 42


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating a business process
name. The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated business process name (Determine
Error Business Process Name By is set to Generating a Business
Process name from the data), the application tries to generate and
match the following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Inbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Generate an error if no generated Specify whether to generate an error if there is no match to the generated
business process name exists in business process name in the system. Valid values are Yes (default) and No.
the system Note: Only displayed if Determine the Business Process By is set to
Generating the business process name from the data.

Business Process List Select a previously created business process to associate with this envelope
Optional.
Displayed only if Determine the Business Process Name is set to Specifying
the business process.

Extraction Options Business process data extraction. Required.


Valid values:
Š Determined by business process (default)
Š Extract to a file system directory
Š Extract to a mailbox

Sterling Commerce, Inc. 43


SWIFT Envelopes

Field or Check Box Description

Data Extraction Directory Directory for data extraction. Displayed only if Extraction Options set to Extract
to a file system directory. Optional

Data Extraction Filename Filename for data extraction. Displayed only if Extraction Options set to Extract
to a file system directory. Optional.

Data Extraction Mailbox Mailbox for data extraction. Displayed only if Extraction Options set to Extract
to a mailbox. Optional.

Data Extraction Mailbox Message Mailbox message name for data extraction. Displayed only if Extraction Options
Name set to Extract to a mailbox. Optional.

Outbound SWIFT envelope


You only need to create an Outbound SWIFT envelope if you are sending outbound SWIFT messages.
However, if you are sending outbound SWIFT messages, you need to create a separate Outbound SWIFT
envelope for each SWIFT message type you will be sending. The following table describes Outbound
SWIFT envelope properties:
Note: An (*) asterisk indicates that a wildcard value can be used with that parameter. For Inbound
envelopes, a wildcard value in the envelope matches any value in the input document, while an
empty value in the envelope matches only an empty value in the input document. For Outbound
envelopes, a wildcard value is equivalent to an empty value in the envelope.

Field or Check Box Description

Envelope Format The format of the envelope. Required. Valid values are FIN (default) and SAA
XML Format 2.

* Sender ID Coded identifier of the supplier number or data sender. Valid value is eight
standard characters for BIC 8. Required.
Note: This parameter enables you to type in a new ID or pick an ID that has
already been used. When you start typing an ID, the application
returns all matching IDs existing in the system and provides a
combo-box from which you can select an ID by double-clicking it.
There must be Sender ID Codes in the system for autocomplete to
find matches and display a selection list.
Note: It is possible to leave the Sender ID parameter blank under some
circumstances. If you leave this parameter blank, it will cause errors
during the enveloping process. You must type a valid value in the
Sender ID parameter.

Sender ID Type Type of sender identifier. Valid values are * (wildcard), BIC8 (default), and
Distinguished Name. Required.
Note: The full address for BIC8 is a BIC12, which includes the one-character
logical terminal (which is specified for the sender and is always "X" for
receiver), and the 3-character branch code. These are combined to
form the BIC12.

Sterling Commerce, Inc. 44


SWIFT Envelopes

Field or Check Box Description

* Receiver ID Coded identifier of the customer number or data source number. Valid value is
eight standard characters for BIC 8. Required.
Note: This parameter enables you to type in a new ID or pick an ID that has
already been used. When you start typing an ID, the application
returns all matching IDs existing in the system and provides a
combo-box from which you can select an ID by double-clicking it.
There must be Receiver ID Codes in the system for autocomplete to
find matches and display a selection list.
Note: It is possible to leave the Receiver ID parameter blank under some
circumstances. If you leave this parameter blank, it will cause errors
during the enveloping process. You must type a valid value in the
Receiver ID parameter.

Receiver ID Type Type of receiver identifier. Valid values are * (wildcard), BIC8 (default), and
Distinguished Name. Required.
Note: The full address for BIC8 is a BIC12, which includes the one-character
logical terminal (which is specified for the sender and is always "X" for
receiver), and the 3-character branch code. These are combined to
form the BIC12.

Accepter Lookup Alias Identifying string used with the Sender ID and the Receiver ID to look up this
envelope with the EDI Encoder service. This alias associates a message with
the service it requires. Valid value must be at least one limited standard
character. Required. Default is FIN.

Use Correlation Overrides When to use correlation overrides (when a SWIFT Reviewer chooses not to
validate a message on resend). Required. Valid values are:
Š Never (default)
Š Only when the envelope field has a wildcard value (*) - this is the default
Š Always
Š Use the default specified in enveloping.properties

Batching Options When the EDI Encoder is used to prepare multiple messages for enveloping,
you can either choose to process each message individually or concatenate
them into a single file, with the messages separated by a ‘$’. Required.
Valid values are:
Š Use FileAct batching ("$" between messages) (default)
Š Do not batch messages

Enforce Message Size Limit Specifies that the application will check the size of the message, and error out if
the message exceeds it. If you select this check box, gives you the option to set
the Maximum Message Size (which defaults to 10,000, the standard limit for
SWIFT messages). Valid values are Yes (default) and No. Required.

Sterling Commerce, Inc. 45


SWIFT Envelopes

Field or Check Box Description

User Reference (MT Message Indicates how to process the message user reference. The message user
User Reference/MX Message reference block is an optional section in the SWIFT envelope that the SWIFT
Reference) network tracks for acknowledgement purposes. Valid values are:
Š Don't include a message user reference (default)
Š Use control number
Š Use value from process data
Note: You should only select Use value from process data if you are using
immediate enveloping. With deferred enveloping, the process data
values from the encoding step are not passed on to the enveloping
step, so using a process data element will not work with deferred
enveloping.

Revision Field The revision field. Values are 2.0.0. (default) and 2.0.1.
Note: This parameter is displayed on the SAA XML Format 2 Options screen
when you select Envelope Format as SAA XML Format 2 when
creating an outbound envelope.

Message Format The format of the message. Valid values are MT (default), MX, and Any XML.
Required.

Validate Sender and Receiver Specify whether to validate the sender and receiver. Required. Valid values are
Yes and No (default).
Note: This parameter allows you to enable (Yes) or disable (No, which is the
default) address verification. Address verification is performed using
the SWIFT_Addresses and SWIFT_BaseAddresses code lists. See
Maintaining the External Code Lists on page 22 for more information
on creating these code lists.

MX Business Area The MX business area. Valid values are * (wildcard), Funds, Trade Services
Utility, Exceptions and Investigations, Cash Reporting, Bulk Payments, Cash
Management, Proxy Voting, SCORE, Transaction Reporting, Alternative Funds,
e-Mandate, and Funds Processing Passport. Required.
Note: Only displayed if you set Message Format to MX.

FIN/APC For an MT message using XML Format 2, this indicates whether it is a system
(APC) message or a user message (FIN). Required.
Valid values are * (wildcard—this is the default), APC, and FIN.

Sterling Commerce, Inc. 46


SWIFT Envelopes

Field or Check Box Description

MX Message Area Transaction message type as determined by the information type in the header
of the message group, which includes the message, or determined by the
information type in the transaction message. Required.
Valid selections are:
Š * (wildcard)
Š Bulk Payments
Š Cash Management
Š Cash Reporting
Š Exceptions and Investigations
Š Funds
Š Proxy Voting
Š SCORE
Š Trade Services
Š Transaction Reporting
Š Alternative Funds
Š e-Mandate
Š Funds Processing Passport
Note: The message area for MX messages.

The lists of Message Types are generated from two property files.
The first property file (ui_swift_message_types.properties) will contain
the base lists of the types provided with the application. The second
property file (ui_swift_message_types_customer.properties) is
user-modifiable, and can also contain additional messages that you
want to add. If you add Message Types to the
ui_swift_message_types_customer.properties property file, modify it
in the customer_overrides.properties file. You are not required to
restart the application when you edit the
ui_swift_message_types_customer.properties file.

You can also select the default, which is * (wildcard).

Sterling Commerce, Inc. 47


SWIFT Envelopes

Field or Check Box Description

Message Type Transaction message type as determined by the information type in the header
of the message group, which includes the message, or determined by the
information type in the transaction message. Required for both MT and MX
messages.
Note: The message type for MX messages are the full 4-component string
(for example, camt.003.001.02). You are first allowed to select a
Message Format of wildcard, MT, and MX. If you select a wildcard,
this Message Type parameter is not displayed because it is assumed
to be wildcard as well (since there is no reason to wildcard the format
and then select a specific message). If you select MT as the Message
Format, you will be given a list of MT messages for this Message Type
parameter. If you choose MX, you receive a list of the “categories”
(SWIFT Funds, SWIFT Trade Services, SWIFT Exceptions and
Investigations, SWIFT Cash Reporting) for this Message Type
parameter. Once you select the subtype, you are presented with a list
of the message types for that category, in the format camt.003.001.02
– Get Account Information.

The lists of Message Types are generated from two property files.
The first property file (ui_swift_message_types.properties) will contain
the base lists of the types provided with the application. The second
property file (ui_swift_message_types_customer.properties) is
user-modifiable, and can also contain additional messages that you
want to add. If you add Message Types to the
ui_swift_message_types_customer.properties property file, modify it
in the customer_overrides.properties file. You are not required to
restart the application when you edit the
ui_swift_message_types_customer.properties file.

Validate Sender and Receiver Specify whether to validate the sender and receiver. Required. Valid values are
Yes and No (default).
Note: This parameter allows you to enable (Yes) or disable (No, which is the
default) address verification. Address verification is performed using
the SWIFT_Addresses and SWIFT_BaseAddresses code lists. See
Maintaining the External Code Lists on page 22 for more information
on creating these code lists.

MX Business Area The MX business area. Valid values are * (wildcard), Funds, Trade Services
Utility, Exceptions and Investigations, Cash Reporting, Bulk Payments, Cash
Management, Proxy Voting, SCORE, Transaction Reporting, Alternative Funds,
e-Mandate, and Funds Processing Passport. Required.
Note: Only displayed if you set Message Format to MX.

FIN/APC For an MT message using XML Format 2, this indicates whether it is a system
(APC) message or a user message (FIN). Required.
Valid values are * (wildcard—this is the default), APC, and FIN.

Closed User Group A specific set of trading partners defined within the SWIFT network. Optional.

Include sender full name Whether to include the full name of the sender. Valid values are Yes and No
(default). Required.

Sterling Commerce, Inc. 48


SWIFT Envelopes

Field or Check Box Description

Service Identifier A two-character numeric field indicating the type of data. The default is 01 for all
the application and user-to-user messages, 21 for acknowledgements, and 03
for SELECT commands. Required.

X1 (Institution BIC11) The name of the sending institution. Optional.


Note: Only displayed for SAA XML Format 2.

X2 (Department or Application The name of the sending department or application name. Optional.
Name) Note: Only displayed for SAA XML Format 2.

X3 (Routing Information/Last The routing information or last name of the sender. Optional.
Name) Note: Only displayed for SAA XML Format 2.

X4 (First Name) The first name of the sender. Optional.


Note: Only displayed for SAA XML Format 2.

Financial Institution The financial institution for the sender. Optional.


Note: Only displayed for SAA XML Format 2.

Branch Information The branch information for the sender. Optional.


Note: Only displayed for SAA XML Format 2.

City Name The name of the city for the sender. Optional.
Note: Only displayed for SAA XML Format 2.

Location The location code for the sender. Optional.


Note: Only displayed for SAA XML Format 2.

Country Code The country code for the sender. Optional.


Note: Only displayed for SAA XML Format 2.

Include receiver full name Whether to include the full name of the receiver. Valid values are Yes and No
(default). Required.

X1 (Institution BIC11) The name of the receiving institution. Optional.


Note: Only displayed for SAA XML Format 2.

X2 (Department or Application The name of the receiving department or application name. Optional.
Name) Note: Only displayed for SAA XML Format 2.

X3 (Routing Information/Last The routing information or last name of the receiver. Optional.
Name) Note: Only displayed for SAA XML Format 2.

X4 (First Name) The first name of the receiver. Optional.


Note: Only displayed for SAA XML Format 2.

Financial Institution The financial institution for the receiver. Optional.


Note: Only displayed for SAA XML Format 2.

Branch Information The branch information for the receiver. Optional.


Note: Only displayed for SAA XML Format 2.

Sterling Commerce, Inc. 49


SWIFT Envelopes

Field or Check Box Description

City Name The name of the city for the receiver. Optional.
Note: Only displayed for SAA XML Format 2.

Location The location code for the receiver. Optional.


Note: Only displayed for SAA XML Format 2.

Country Code The country code for the receiver. Optional.


Note: Only displayed for SAA XML Format 2.

Routing Code The routing code. Optional.


Note: Only displayed for SAA XML Format 2.

Validation level The level of validation. Required. Valid values are None (use SAA default),
Minimum, Intermediate, Maximum.
Note: Only displayed for SAA XML Format 2.

Allow modification in SAA Whether to allow modification in SAA. Required. Valid values are SAA Default
(this is the default), Yes, and No.
Note: Only displayed for SAA XML Format 2.

Include routing instructions Whether to include routing instructions. Required. Valid values are Yes and No
(default).
Note: Only displayed for SAA XML Format 2.

Routing Function The routing function. Required. Valid values are Route (default),
DisposeToRoutingPoint, and DisposeToRoutingStep.
Note: Only displayed for SAA XML Format 2, if Include routing instructions
is set to Yes.

Routing Point The routing point. Optional.


Note: Only displayed for SAA XML Format 2, if Include routing instructions
is set to Yes.

Routing Step The routing step. Optional. Valid values are None (default), Verify, Authorize,
Modify, and ReadyToSend.
Note: Only displayed for SAA XML Format 2, if Include routing instructions
is set to Yes.

Network Priority The network priority. Optional. Valid values are None (default), Normal, System,
and Urgent.
Note: Only displayed for SAA XML Format 2.

Is Possible Duplicate Whether the trailer is a possible duplicate. Required. Valid values are Don't
Include (default), False, and True. Only displayed for SAA XML Format 2.

Request Notification Whether delivery notification is requested. Required. Valid values are Don't
Include (default), False, and True.
Note: Only displayed for SAA XML Format 2.
Note: The application does not mark a message as accepted until the
delivery notification or report has been received. Therefore, the
Delivery Notification information is stored until the Transmission
Report associating the SenderReference with the appropriate
Reconciliation information is received.

Sterling Commerce, Inc. 50


SWIFT Envelopes

Field or Check Box Description

Service The network service used. Optional.


Note: Only displayed for SAA XML Format 2.

User Priority (FIN only; header The user priority. Optional.


field 113) Note: Only displayed for SAA XML Format 2.

Value Added Service ID (FIN only) The value-added network service used. Optional.
Note: Only displayed for SAA XML Format 2.

Standard Year (Version) The SWIFT version (year of release). Optional.

Validation Identifier (FIN only; The validation identifier. Optional.


header field 119) Note: Only displayed for SAA XML Format 2.

IsSigningRequested flag (ignored Whether or not a signature is requested as a security option. Optional. Valid
for FIN) values are None (use SAA emission profile configuration—this is the default),
True, and False.
Note: Only displayed for SAA XML Format 2.

Request non-repudiation Whether or not non-repudiation is requested as a security option. Optional. Valid
(SWIFTNet only) values are None (use SAA emission profile configuration—this is the default),
True, and False.
Note: Only displayed for SAA XML Format 2.

PAC Value ??? Optional


Note: Only displayed for SAA XML Format 2.

Sign the DataPDU Whether to sign the protocol data unit (PDU) for a signature. Optional. Valid
values are Yes or No (default).
Note: Only displayed if Envelope Format is set to either wildcard or SAA
XML Format 2 is selected. The signature is optional.

Key Part 1 First part of the validation signature.

Key Part 2 Second part of the validation signature.

Message Priority Specify the priority of the message delivery. Optional. Valid values are:
Š Normal (default)
Š Urgent
Š System

Sterling Commerce, Inc. 51


SWIFT Envelopes

Field or Check Box Description

Delivery Monitoring One digit that indicates how monitoring will be performed by the SWIFT network.
Optional.
Valid values are:
Š No Delivery Monitoring (default)
Š 1 (Warning Message) indicates that a warning message will be given if the
message is not delivered within a reasonable period
Š 2 (Delivery Notification) indicates notification when the message is delivered
Š 3 (Non-Delivery Warning and Delivery Notification) indicates that both the
non-delivery warning and delivery notification will be given
Note: The allowable options are tied to the Message Priority: priority Urgent
requires that the user select 1 or 3, priority Normal enables the user to
select 2 or No Delivery Monitoring.

Obsolescence Period Indicates the time after which a Delayed Message trailer will be added to the
message by the SWIFT network if it has not yet been delivered. This is also the
period after which a non-delivery warning will be generated by the SWIFT
network, if the appropriate choice for the Delivery Monitoring parameter.
Optional.
Note: This parameter must be three numerics. Each unit represents five
minutes (so, for example, 003 equates to 15 minutes). SWIFT
requires leading zeros, so the if the number of minutes is less than 3
digits, you must include leading zeroes.

FIN Copy Service Code (tag 103): A typical configuration requires that the FIN Copy Service Code tag be included
in the envelope (usually set to COP). Optional.
The SWIFT network support the FIN Copy mode, in which a message is sent to
an intermediary for approval before it goes to its final destination (or is just
copied to the intermediary without requiring approval).

Banking Priority (tag 113): A four-character optional tag indicating the banking priority. The allowed values
are agreed on by you and your trading partner or partners. Optional.

Validation Flag (tag 119): Specifies the validation flag. Required.


This is an optional part of the header that can contain a code word to indicate
that certain types of validations should be performed on the enveloped
message.
The valid values for this tag vary depending on the message type.
Note: Be sure to configure your SWIFT envelopes appropriately for the
version of SWIFT that you are using.

Payment Release Information (tag Specifies the payment release information. Optional.
115): This is an envelope component used in FIN Copy that contains information from
the central institution to the receiver of the payment message. The information
from this parameter will be placed by the SWIFT network into the MT 097 FIN
Copy Message Authorization/Refusal Notification in Y-copy mode.

Sterling Commerce, Inc. 52


SWIFT Envelopes

Field or Check Box Description

Include Possible Duplicate Indicates whether to include a trailer specifying that this message may be a
Emission (PDE) Trailer duplicate. Required.
This is an optional component of the envelope that indicates that this message
may already have been sent. For example, if the system crashes during the
delivery of a message, another copy of the message could be sent, with this
trailer included to indicate that it may be a duplicate.
Valid values are Yes and No (default).

Include Training (TNG) Trailer Specifies whether to include a training (TNG) trailer. Required.
This is an optional component of the envelope that indicates the message
contained is being sent for system testing purposes.
Valid values are Yes and No (default).

Sender Logical Terminal Specifies the logical terminal for outbound FIN. This is a single alphanumeric
character Required.
Note: This parameter is necessary to send messages through the
WebSphere MQ adapter using the FileAct protocol.

* Sender Branch Code Three-character code that further refines the Sender ID. For example, if the
SenderID is ROMANSFL, the branch code might be WAS to indicate the
Washington branch. This parameter acts as the Sender ID qualifier for envelope
matching. Required.

* Receiver Branch Code Three-character code that further refines the Receiver ID. For example, if the
ReceiverID is ROMANSFL, the branch code might be WAS to indicate the
Washington branch. This parameter acts as the Receiver ID qualifier for
envelope matching. Required.

Maximum Message Size The maximum size of message that is allowed. The default is 10,000. This
parameter only accepts numeric input.
Only displayed if you selected Yes for the Enforce Message Size Limit
parameter. Required.

Expect an acknowledgement for Whether to expect an acknowledgement for messages that are sent using this
messages sent using this envelope. Valid values are Yes and No (default). Required.
envelope

Acknowledgement overdue after Amount of time, in hours, within which you must receive an acknowledgement.
(hours) Valid value is four numeric characters. Optional.

Acknowledgement overdue after Amount of time, in minutes, within which you must receive an
(minutes) acknowledgement. Valid value is four numeric characters. Optional.

Use global control number Whether to use a global control number. Required. Valid values are:
Š Yes (default)
Š Yes (and generate from data)
Note: If you select this option, you must select at least one parameter for
Primary Name Format.
Š No
Displayed only if Message User Reference is set to Use Control Number.

Sterling Commerce, Inc. 53


SWIFT Envelopes

Field or Check Box Description

Primary Name Format Check boxes to instruct what information to include when generating a name for
a primary global control number and finding the correct number to assign based
on that name. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated global control number (Use global
control number is set to Yes (and generate name from data)), the
application tries to generate and match the following control numbers:
Š First, it tries to generate and match the control number in the primary name
format (replacing the values that are selected for the corresponding value in
the message). For example, if only message type is selected, and the
message type is 100, the application checks for the control number
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing control number that matches the names
generated in steps 1-3, a control number with the name assigned in the first
step is created.

Sterling Commerce, Inc. 54


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating a global control number.
The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated global control number (Use global
control number is set to Yes (and generate name from data)), the
application tries to generate and match the following control numbers:
Š First, it tries to generate and match the control number in the primary name
format (replacing the values that are selected for the corresponding value in
the message). For example, if only message type is selected, and the
message type is 100, the application checks for the control number
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing control number that matches the names
generated in steps 1-3, a control number with the name assigned in the first
step is created.

Sterling Commerce, Inc. 55


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating a global control
number. The system allows for two alternatives if the Primary Name Format is
not found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated global control number (Use global
control number is set to Yes (and generate name from data)), the
application tries to generate and match the following control numbers:
Š First, it tries to generate and match the control number in the primary name
format (replacing the values that are selected for the corresponding value in
the message). For example, if only message type is selected, and the
message type is 100, the application checks for the control number
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing control number that matches the names
generated in steps 1-3, a control number with the name assigned in the first
step is created.

Global Message User Reference Select the control number with which to start generating control numbers.
(MUR) Control Number Optional.
Displayed only if Message User Reference is set to Use Control Number.

Process Data element from which Specify the process data element from which the MUR will be set.
to set the Message User Displayed only if Message User Reference is set to Use value from process
Reference data. Required.

Local Message User Reference The message user reference block is an optional section in the SWIFT envelope
(MUR) that the SWIFT network tracks for acknowledgement purposes. If you choose to
use a local control number as the user reference, type the starting value of that
control number in this parameter.

Translate documents prior to Whether to translate the documents prior to enveloping them. Valid values are
enveloping Yes or No (default). Required.

Sterling Commerce, Inc. 56


SWIFT Envelopes

Field or Check Box Description

Map Name Mode How to determine which map to use to translate the message. Required. Valid
values are:
Š Specify (default)
Š Generate from data (this is useful if you want to share across envelopes)
Note: If you select this option, you must select at least one parameter for
Primary Name Format. This parameter is displayed only if Translate
document prior to enveloping set to Yes.

Map Name Which map to use to perform a compliance check (if Translate document prior
to enveloping set to Yes and Map Name Mode set to Yes). The map must
already be checked in to the application. Optional.

Primary Name Format Check boxes to instruct what information to include when generating and
matching a name for the map. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated map name (Map Name Mode is set to
Generate from data), the application tries to generate and match the
following maps:
Š First, it tries to generate and match the map in the primary name format
(replacing the values that are selected for the corresponding value in the
message). For example, if only message type is selected, and the message
type is 100, the application checks for the control number
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing map that matches the names generated in
steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no matching map is found is set
to Yes.

Sterling Commerce, Inc. 57


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating a map name. The system
allows for two alternatives if the Primary Name Format is not found—checking
for the First Backup Name Format and then, if that is not found, checking for the
Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated map name (Map Name Mode is set to
Generate from data), the application tries to generate and match the
following maps:
Š First, it tries to generate and match the map in the primary name format
(replacing the values that are selected for the corresponding value in the
message). For example, if only message type is selected, and the message
type is 100, the application checks for the control number
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing map that matches the names generated in
steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no matching map is found is set
to Yes.

Sterling Commerce, Inc. 58


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating a map name. The
system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated map name (Map Name Mode is set to
Generate from data), the application tries to generate and match the
following maps:
Š First, it tries to generate and match the map in the primary name format
(replacing the values that are selected for the corresponding value in the
message). For example, if only message type is selected, and the message
type is 100, the application checks for the control number
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing map that matches the names generated in
steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no matching map is found is set
to Yes.

Generate an error if no matching Specifies whether to generate an error if the Map Name selected is not found.
map is found Valid values are Yes (default) and No.
Note: Only displayed if Map Name Mode is set to Generate from data.

Sterling Commerce, Inc. 59


SWIFT Envelopes

Field or Check Box Description

On a translation error, determine How to determine the business process name to use if there were errors in the
the Business Process by translation process. Required. Valid values are:
Š Specifying a Business Process name (default)
Š Generating a Business Process name from the data (this is useful if you
want to share across envelopes)
Note: If you select this option, you must select at least one parameter for
Primary Name Format.
Note: If you select a translation error business process, when a document
with compliance errors is encountered an instance of the error
business process is generated, using the non-compliant document as
the primary document. The processing of that document within the
enveloper is halted at that point, and the next document starts
processing. If you do not specify a translation error business process,
the enveloper continues to process the non-compliant document. In
either case, the status report containing the translation errors is
created.

If HALT_ON_TRANS_ERROR is set to Yes or True in ProcessData,


no more documents are processed after a non-compliant document is
encountered. If HALT_ON_TRANS_ERROR is set to No or False in
ProcessData, the rest of the documents will be processed after a
non-compliant document is encountered. If
HALT_ON_TRANS_ERROR is not defined, the behavior depends on
the enveloping mode; IMMEDIATE mode behaves as if
HALT_ON_TRANS_ERROR is set to True, and DEFERRED mode
behaves as if HALT_ON_TRANS_ERROR is set to False.

Sterling Commerce, Inc. 60


SWIFT Envelopes

Field or Check Box Description

Primary Name Format Check boxes to instruct what information to include when generating and
matching a name for the error business process name. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated error business process name (On a
translation error, determine Error Business Process Name By is
set to Generating a Business Process name from the data), the
application tries to generate and match the following business
process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 61


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating an error business process
name. The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated error business process name (On a
translation error, determine Error Business Process Name By is
set to Generating a Business Process name from the data), the
application tries to generate and match the following business
process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 62


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating an error business
process name. The system allows for two alternatives if the Primary Name
Format is not found—checking for the First Backup Name Format and then, if
that is not found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated error business process name (On a
translation error, determine Error Business Process Name By is
set to Generating a Business Process name from the data), the
application tries to generate and match the following business
process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Generate an error if no generated Specify whether to generate an error if there is no match to the generated
business process name exists in business process name in the system. Valid values are Yes (default) and No.
the system Note: Only displayed if On a translation error, determine the Error
Business Process By is set to Generating the business process
name from the data.

Business Process List Select a previously created business process to associate with this envelope.
Displayed only if On a translation error, determine the Business Process by
is set to Specifying a business process names. Optional.

Sterling Commerce, Inc. 63


SWIFT Envelopes

Field or Check Box Description

Determine the Business Process How to determine the business process name to use if there were no errors in
By the compliance check. Required. Valid values are:
Š Specify a Business Process (default)
Š Generate Business Process Name (from the data)
Note: If you select this option, you must select at least one parameter for
Primary Name Format.

Primary Name Format Check boxes to instruct what information to include when generating and
matching a name for the business process. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated business process name (Determine the
Business Process By is set to Generating the business process
name from the data), the application tries to generate and match the
following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 64


SWIFT Envelopes

Field or Check Box Description

First Backup Name Format The first backup name format to use when generating a business process name.
The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated business process name (Determine the
Business Process By is set to Generating a Business Process name
from the data), the application tries to generate and match the
following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Sterling Commerce, Inc. 65


SWIFT Envelopes

Field or Check Box Description

Second Backup Name Format The second backup name format to use when generating a business process
name. The system allows for two alternatives if the Primary Name Format is not
found—checking for the First Backup Name Format and then, if that is not
found, checking for the Second Backup Name Format. Optional.
Select from:
Š Sender ID
Š Sender Branch Code
Š Receiver ID
Š Receiver Branch Code
Š Message Format (MT/MX/Any XML)
Š Message Type
Š Validation Flag (MT only)
Š Envelope Format (FIN/XML2)
Note: If you are using a generated business process name (Determine the
Business Process By is set to Generating a Business Process name
from the data), the application tries to generate and match the
following business process:
Š First, it tries to generate and match the business process in the primary
name format (replacing the values that are selected for the corresponding
value in the message). For example, if only message type is selected, and
the message type is 100, the application checks for the business process
SWIFT_100_Outbound_FIN.
Š Second, it tries to generate and match the First Backup Name.
Š Third, it tries to generate and match the Second Backup Name.
Š Fourth, if there is not an existing business process that matches the names
generated in steps 1-3, an error is generated.
Note: Only occurs if Generate an error if no generated business process
name exists in the system is set to Yes.

Generate an error if no generated Specify whether to generate an error if there is no match to the generated
business process name exists in business process name in the system. Required. Valid values are Yes (default)
the system and No.
Note: Only displayed if Determine the Business Process By is set to
Generate Business Process Name.

Business Process List Select a previously created business process to associate with this envelope.
Optional.
Displayed only if Determine the Business Process Name is set to Specify
Business Process.

Sterling Commerce, Inc. 66


SWIFT Envelopes

Field or Check Box Description

Extraction Options Business process data extraction. Required.


Valid values:
Š Determined by business process (default)
Š Extract to a file system directory
Š Extract to a mailbox

Data Extraction Directory Directory for data extraction. Displayed only if Extraction Options set to Extract
to a file system directory. Optional.

Data Extraction Filename Filename for data extraction. Displayed only if Extraction Options set to
Extract to a file system directory. Optional.

Data Extraction Mailbox Mailbox for data extraction. Displayed only if Extraction Options set to Extract
to a mailbox. Optional.

Data Extraction Mailbox Message Mailbox message name for data extraction. Displayed only if Extraction
Name Options set to Extract to a mailbox. Optional.

Configuring the EDI Encoder Service for SWIFT Outbound Messages


The EDI Encoder service determines which envelope will be used on the document. If translations are
specified in an envelope, the service determines which map to use. For SWIFT outbound messages you need
to configure five parameters to allow the outbound message to be sent correctly. See EDI Encoder Service
for more information.

To configure the EDI Encoder service, you must specify settings for the following fields in the GPM that
match the values you configured in the outbound envelope:
✦ AccepterLookupAlias
✦ ReceiverID
✦ SenderID
✦ ReceiverIDQual
✦ SenderIDQual
You need to set the sender and receiver variables based on the desired source and destination for the
outbound message. These variables also match the corresponding values in the envelope, except that the
envelope allows wildcards (which will match documents encoded with any value for that variable), whereas
the value used in the EDI encoder must always be the full eight-character identifier and three-character
branch code of the desired source and destination.
Or, if you are editing the EDI Encoder BPML, you need to include these parameters and values, where for
xxx you substitute the values set up in the outbound envelope:
<operation name="EDI Encode">
<participant name="EDIEncoder"/>
<output message="EDIEnc_In">
<assign to="AccepterLookupAlias">xxx</assign>
<assign to="ReceiverID">xxx</assign>
<assign to="SenderID">xxx</assign>

Sterling Commerce, Inc. 67


SWIFT Envelopes

<assign to="ReceiverIDQual">xxx</assign>
<assign to="SenderIDQual">xxx</assign>
<assign to="." from="*"/>
</output>
<input message="EDIEnc_Out">
<assign to="." from="*"/>
</input>
</operation>

Correlation Names to Override SWIFT Envelope Values


Overrides are used (typically in conjunction with wildcard values in envelopes) to reduce the number of
envelopes that you need to create. For example, if you send several types of messages to the same receiver,
you can set up a single envelope for this receiver and use an override for the message type, rather than
creating a different envelope for each message type you wish to send.
To use an override, you need to set the appropriate correlation on the document prior to running it through
the EDI Encoder service. For example, you can set the correlation Out_MessageType to 999 if you want
to override the message type.
For Inbound envelopes, a wildcard value in the envelope matches any value in the input document, while
an empty value in the envelope matches only an empty value in the input document. For Outbound
envelopes, a wildcard value is equivalent to an empty value in the envelope. You can override wildcards
with specific EDI values in outbound processing. You must supply the EDI data to the business process and
the data must be in the correct format (that is, name/value pairs).
When setting up your outbound processing, consider the following:
✦ If an envelope field contains a wildcard, you must supply a correlation value for it or the service halts
with an error.
✦ You can override wildcard values in an envelope by using the Correlation service to pass name/value
pairs from the primary document to the EDI Encoder service.
✦ If an envelope contains specific values in the Sender ID, Sender ID Qualifier, Receiver ID, or Receiver
ID Qualifier fields (that is, values other than a wildcard), the values passed from the Correlation
service to the EDI Encoder service do not overwrite the values in the fields.
✦ If you are using the same envelope for inbound processing and acknowledgements, supply the Sender
ID, Receiver ID, and Qualifiers in the envelope so that they are not overwritten by the correlation
values.

FIN Envelopes
This section contains the override values for FIN envelopes. The values are organized by the envelope
section in which they are located.
The basic header block overrides are as follows:
✦ Out_ServiceIdentifier
✦ Out_SenderID
Note: This is the BIC8 of the sender.
✦ Out_SenderLogicalTerminal

Sterling Commerce, Inc. 68


SWIFT Envelopes

✦ Out_SenderIDQual
Note: This is the branch code of the sender.
✦ Out_SessionNumber
✦ Out_SequenceNumber
The application header overrides are as follows:
✦ Out_MessageType
✦ Out_ReceiverID
Note: This is the BIC8 of the receiver.
✦ Out_ReceiverIDQual
Note: This is the branch code of the receiver.
✦ Out_MessagePriority
✦ Out_DeliveryMonitoring
✦ Out_ObsolesencePeriod
The user header overrides are as follows:
✦ Out_ServiceCode: Block 103
✦ Out_BankingPriority: Block 113
✦ Out_ControlNumber: Block 108
Note: This is the message user reference.
✦ Out_ValidationFlag: Block 119
✦ Out_PaymentReleaseInfo: Block 115
The TNG trailer override is as follows:
✦ Out_IncludeTNG
Note: Set this to Yes to include the TNG trailer.
The PDE trailer overrides are as follows:
✦ Out_SWIFTPDEMessageInputTime
✦ Out_SWIFTPDEMessageInputDate
✦ Out_SWIFTPDEInputAddress
✦ Out_SWIFTPDEInputSessionNumber
✦ Out_SWIFTPDEInputSequenceNumber

XML Format 2 Envelopes


This section contains the override values for XML Format 2 envelopes. The values are organized by the
envelope section in which they are located.
Out_MessageFormat: Value for the Format element within the Message element
The Sender element overrides are as follows:
✦ Out_SenderID

Sterling Commerce, Inc. 69


SWIFT Envelopes

Note: The BIC8 of the sender (for BIC12 senders), or the DN or Nickname for the sender.
✦ Out_SenderLogicalTerminal
Note: This is the logical terminal (for BIC12 senders).
✦ Out_SenderIDQual
Note: This is the branch code of the sender (for BIC12 senders).
✦ Out_SenderX1
✦ Out_SenderX2
✦ Out_SenderX3
✦ Out_SenderX4
✦ Out_SenderFinancialInstitution
✦ Out_SenderBranchInformation
✦ Out_SenderCityName
✦ Out_SenderLocation
✦ Out_SenderCountryCode
The Receiver element overrides are as follows:
✦ Out_ReceiverID
✦ This is the BIC8 of the receiver (for BIC12 receivers), or the DN or Nickname for the receiver.
✦ Out_ReceiverIDQual
Note: This is the branch code of the receiver (for BIC12 receivers).
✦ Out_ReceiverX1
✦ Out_ReceiverX2
✦ Out_ReceiverX3
✦ Out_ReceiverX4
✦ Out_ReceiverFinancialInstitution
✦ Out_ReceiverBranchInformation
✦ Out_ReceiverCityName
✦ Out_ReceiverLocation
✦ Out_ReceiverCountryCode
The InterfaceInfo overrides are as follows:
✦ Out_ControlNumber
✦ Out_XML2RoutingCode
✦ Out_XML2ValidationLevel
✦ Out_XML2AllowModification
✦ Out_XML2RoutingFunction
✦ Out_XML2RoutingPoint
✦ Out_XML2RoutingStep

Sterling Commerce, Inc. 70


SWIFT Envelopes

The NetworkInfo overrides are as follows:


✦ Out_XML2Priority
✦ Out_XML2IsPossibleDuplicate
✦ Out_XML2IsNotificationRequested
✦ Out_XML2Service
✦ Out_XML2UserPriority
✦ Out_XML2CopyService
✦ Out_ValidationFlag
✦ Out_XML2IsSigningRequested
✦ Out_XML2PACValue
✦ Out_XML2IsNRRequested
The Application Header (AppHdr) overrides are as follows:
✦ Out_AppHdrFromType
✦ Out_AppHdrFromID
✦ Out_AppHdrToType
✦ Out_AppHdrToID
✦ Out_AppHdrSvcName
✦ Out_AppHdrMsgName
✦ Out_AppHdrDupRef
✦ Out_AppHdrDupInfo

Sterling Commerce, Inc. 71


SWIFT and SWIFTNet Business Processes

SWIFT and SWIFTNet Business Processes

Overview
To help you accomplish your business goals, the application provides two predefined enveloping business
processes, which are used by the application to implement SWIFT and SWIFTNet processing:
SWIFTEnvelope and SWIFTDeenvelope. These predefined business processes are initiated by other
processes/services during SWIFT processing and do not require you to modify them.
The application also provides predefined business processes, which are used by the application to
implement SWIFT transport, including the SWIFTNetClient business process (using for InterAct transport),
and the SWIFTNet ClientFA (used for FileAct transport) business process. These predefined business
processes are initiated by other processes/services during SWIFT processing but do require you to modify
them.
The following table lists business goals for some of the predefined SWIFT business processes:

Business Process Business Goals

SWIFTDeenvelope Extracts SWIFT message types from a message and translates and
processes them, according to the content of the envelopes.

SWIFTEnvelope Applies a SWIFT envelope to one or more SWIFT message types and then
uses the envelope data to translate and process them.

SWIFTNetClient Used for InterAct processing. Contains the necessary parameters so the
SWIFTNet Client service can prepare the request and send it (outbound) to
the SWIFTNet MEFG Server. The client application on the SWIFTNet MEFG
Server processes this request, performs the necessary communication
exchange with the SWIFTNet SAG/SNL instance, and sends the request to
the SWIFTNet Network.

SWIFTNetClientFA Used for FileAct processing. Contains the necessary parameters so the
SWIFTNet Client service can prepare the request and send it (outbound) to
the SWIFTNet MEFG Server. The client application on the SWIFTNet MEFG
Server processes this request, performs the necessary communication
exchange with the SWIFTNet SAG/SNL instance, and sends the request to
the SWIFTNet Network.

handleSWIFTNetServerRequest Used for InterAct processing. Enables the application to receive SWIFTNet
messages. This is the bootstrap business process used by the inbound
SWIFTNet request through the SWIFTNet MEFG Server. It is a system
business process used by the SWIFTNet Server Adapter, which
pre-processes the incoming request, searches the SWIFTNet Routing Rule
table, and routes the request payload to the business process for processing.

Sterling Commerce, Inc. 72


SWIFT and SWIFTNet Business Processes

Business Process Business Goals

handleSWIFTNetServerSnFRequest Used for InterAct processing. Enables the application to receive SWIFTNet
store-and-forward messages. This is a bootstrap business process used by
the inbound SWIFTNet request that includes a store-and-forward option. For
the store-and-forward option, an incoming request is not processed
immediately, but instead is stored in the responder mailbox in the application
to be responded to later. The application then sends an acknowledgement
that the request has been successfully stored to the requestor through the
SWIFTNet MEFG Server.

handleSWIFTNetServerFARequest Used for FileAct processing. Enables the application to receive SWIFTNet
messages. This is the bootstrap business process used by the inbound
SWIFTNet request through the SWIFTNet MEFG Server. It is a system
business process used by the SWIFTNet Server Adapter, which
pre-processes the incoming request, searches the SWIFTNet Routing Rule
table, and routes the request payload to the business process for processing.

handleSWIFTNetServerFASnF Used for FileAct processing. Enables the application to receive SWIFTNet
Request store-and-forward messages. This is a bootstrap business process used by
the inbound SWIFTNet request that includes a store-and-forward option. For
the store-and-forward option, an incoming request is not processed
immediately, but instead is stored in the responder mailbox in the application
to be responded to later. The application then sends an acknowledgement
that the request has been successfully stored to the requestor through the
SWIFTNet MEFG Server.

handleSWIFTNetServerFAEvent The handleSWIFTNetServerFAEvent business process is used by the


SWIFTNet MEFG Server. It is a system business process called by the
SWIFTNet Server adapter that preprocesses the incoming FileAct Event with
a COMPLETED status, searches the SWIFTNet routing rule table and
bootstraps the business process for processing

SWIFTMessageEntryOutbound This is the default business process used to look up the correct envelope,
based on information provided by the user while configuring the Send
information in the SWIFT Message Entry Workstation. This business process
uses the EDI Encoder service, Envelope service, and then invokes the
business process specified in the SWIFT Outbound Envelope.

Writing a Business Process for a StandardsTranslation Operation


Assigning the SWIFT_ValidationFlag as a parameter to the StandardsTranslation operation within a
business process does not perform the expected validation, and the validation is not performed by the
translator because the workflow context returns the parameter as a string object instead of a NodeList. To
define the SWIFT_ValidationFlag parameter, the assign statement should be made in process data outside
of the StandardsTranslation operation. For example:
<process name="TEST_2008_574IRSLST">
<sequence>
<assign to="SWIFT_ValidationFlag">IRSLST</assign>
<operation name="StandardsTranslation">
<participant name="StandardsTranslation"/>
<output message="Xout">
<assign to="." from="*"></assign>
<assign to="map_name">SWIFT_2008_574_IRSLST</assign>
</output>

Sterling Commerce, Inc. 73


SWIFT and SWIFTNet Business Processes

<input message="Xin">
<assign to="." from="*"></assign>
</input>
</operation>
</sequence>
</process>

SWIFTDeenvelope Business Process


The SWIFTDeenvelope business process is used to deenvelope SWIFT data. A typical scenario is one in
which SWIFT data must be received from a trading partner. The data must be deenveloped to extract
identifying batch and interchange data, and the SWIFTDeenvelope business process helps to provide the
deenveloping services.
The SWIFTDeenvelope business process is initiated as part of the following inbound process flow:
1. You create a business process that calls the EDI Deenveloping service.
2. The EDI Deenveloping service parses the whole document and extracts messages from it so it can be
further processed by the application.
3. Passes the SWIFT messages to the SWIFTDeenvelope business process. The Generic Deenvelope
service runs as a subprocess.
4. The SWIFTDeenvelope business process looks up the envelope, based on the data found in the header.
5. The envelope specifies what to do with the deenveloped messages.
6. Starts the Invoke Business Process service or a subprocess service to initiate the appropriate business
process to handle each deenveloped message.
If exceptions occur when running an EDI Deenveloping business process, the application generates an EDI
Compliance Report.
This table lists the configuration parameters for the SWIFTDeenvelope business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Sterling Commerce, Inc. 74


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the SWIFTDeenvelope business process:

<process name="SWIFTDeenvelope">
<rule name="contract">
<condition>CONTRACT_FOUND = &quot;YES&quot;</condition>
</rule>
<sequence>
<assign to="RunInValidationMode">FALSE</assign>
<sequence>
<operation>

Sterling Commerce, Inc. 75


SWIFT and SWIFTNet Business Processes

<participant name="DeenvelopeGeneric"/>
<output message="Xout">
<assign to="break_processor">SWIFT</assign>
<assign to="." from="*"></assign>
</output>
<input message="Xin">
<assign to="." from="*"></assign>
</input>
</operation>
<onFault code="Interchange-Non-Compliant">
<!-- Just catch the error, so that the BP will continue. -->
<!-- Dummy assign, since we need something here. -->
<assign to="BREAK">YES</assign>
</onFault>
<onFault code="Transaction-Non-Compliant">
<!-- Just catch the error, so that the BP will continue. -->
<!-- Dummy assign, since we need something here. -->
<assign to="BREAK">YES</assign>
</onFault>
<onFault>
<operation>
<participant name="BPExceptionService"/>
<output message="Xout" >
<assign to="exceptionCode" from="Prev_NotSuccess_Adv_Status/text()"/>
</output>
<input message="Xin"/>
</operation>
</onFault>
</sequence>
<choice>
<select>
<case ref="contract" activity="invoke_contract_workflow"/>
</select>
<sequence name="invoke_contract_workflow">
<operation>
<participant name="InvokeBusinessProcessService"/>
<output message="Xout">
<assign to="INVOKE_MODE">ASYNC</assign>
<assign to="." from="*"></assign>
</output>
<input message="Xin">
<assign to="." from="*"></assign>
</input>
</operation>
</sequence>
</choice>
</sequence>
</process>

Before Using the SWIFTDeenvelope Business Process


Before you use the SWIFTDeenvelope business process, you must complete the following task:
1. Create a SWIFT inbound envelope for each SWIFT message type that you are receiving. See Inbound
SWIFT envelope on page 25.

Sterling Commerce, Inc. 76


SWIFT and SWIFTNet Business Processes

SWIFTEnvelope Business Process


The SWIFTEnvelope business process is initiated when it is called by another business process. The
SWIFTEnvelope business process envelopes the SWIFT messages contained in the business process
context with outbound SWIFT envelopes that you have preconfigured. You must have created one outbound
SWIFT envelope for each SWIFT message type that you are sending.
A typical scenario is one in which SWIFT data must be sent to a trading partner. To prepare for this, the data
must be enveloped to provide identifying batch and interchange data. The SWIFTEnvelope business process
helps to provide these enveloping services.
The SWIFTEnvelope business process is initiated as part of the following outbound process flow:
1. You create a business process that calls the EDI Encoder service or Document Extraction service.
2. The EDI Encoder service or Document Extraction service looks up the envelope to apply and prepares
the document to be enveloped.
3. Either the business process calls the EDI Enveloping service or the Document Extraction service is
configured to perform enveloping.
4. The EDI Enveloping service or Document Extraction service starts the SWIFTEnvelope business
process (which runs the Generic Envelope service as a subprocess to extract the name of the business
process).
5. The SWIFTEnvelope business process searches the envelope definition to retrieve information to
envelope each message.
Note: The Sender ID, Receiver ID, and Lookup Alias in your Outbound Envelope definition must match
the parameters that you define for this outbound business process.
This table lists the configuration parameters for the SWIFTEnvelope business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates that previously allocated queue level that you
want for this business process model for processing.

Sterling Commerce, Inc. 77


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the SWIFT Envelope business process:
<process name="SWIFTEnvelope">

<rule name="contract">
<condition>CONTRACT_FOUND = &quot;YES&quot;</condition>
</rule>

<sequence>
<operation>
<participant name="EnvelopeGeneric" />
<output message="Xout" >
<assign to="." from="*"></assign>
</output>
<input message="Xin" >
<assign to="." from="*"></assign>

Sterling Commerce, Inc. 78


SWIFT and SWIFTNet Business Processes

</input>
</operation>

<choice>
<select>
<case ref="contract" activity="invoke_contract_workflow" />
</select>
<sequence name="invoke_contract_workflow">
<operation>
<participant name="InvokeBusinessProcessService" />
<output message="Xout">
<assign to="INVOKE_MODE">ASYNC</assign>
<assign to="." from="*"></assign>
</output>
<input message="Xin" >
<assign to="." from="*"></assign>
</input>
</operation>
</sequence>
</choice>

</sequence>
</process>

Before Using the SWIFTEnvelope Business Process


Before you use the SWIFTEnvelope business process, you must complete the following task:
1. Create a SWIFT outbound envelope for each SWIFT message type that you are sending. See Outbound
SWIFT envelope on page 44.

SWIFTNetClient Business Process


The SWIFTNet Client service enables you to use Secure Sockets Layers (SSL), but to do so you must also
upgrade the SWIFTNetClient business process if you have not already done so. The upgrade BPML differs
based on whether you are using InterAct or FileAct. See the SWIFTNet Client Service documentation for
more information on how to upgrade the SWIFTNetClient business process if you are using SSL.
Note: If you previously installed an earlier version of the Standards Library, you do not need to upgrade
the SWIFTNetClient business process again. However, you will need to reinstall the SWIFTNet
MEFG Server (see SWIFTNet MEFG Server on page 189 for more information).
The SWIFTNetClient business process contains the necessary parameters so the SWIFTNet Client service
can prepare the request and send it to the SWIFTNet MEFG Server. The client application on the SWIFTNet
MEFG Server processes this request, performs the necessary communication exchange with the SWIFTNet
SAG/SNL instance, and sends the request to the SWIFTNet Network.
Note: This business process is used for InterAct processing only. It takes the default parameters configured
in the SWIFTNet Client service. If a parameter defined in the SWIFTNet Client Service is specified
in this business process, the value in the business process overrides the parameter in the SWIFTNet
Client service.
The SWIFTNetClient business process is initiated as part of the following outbound process flow:

Sterling Commerce, Inc. 79


SWIFT and SWIFTNet Business Processes

1. The SWIFTNetClient business process invokes the SWIFTNet Client service and passes it all the
necessary parameters to send a request.
2. The client application on the SWIFTNet MEFG Server processes the request.
This table lists the configuration parameters for the SWIFTNetClient business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard for application processing,
wherein the business process is placed in queue and
processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Sterling Commerce, Inc. 80


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the SWIFTNetClient business process:


Note: The bold lines indicate information that you need to modify to match your installation.

<process name="SWIFTNetClient">
<sequence name="SWIFTNetClientService">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<!-- build SWIFTNET request -->
<operation>
<participant name="SWIFTNetClientService"/>
<output message="handleClientRequest">
<assign to="." from="*"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</process>

Sterling Commerce, Inc. 81


SWIFT and SWIFTNet Business Processes

Before Using the SWIFTNetClient Business Process


Before you use the SWIFTNetClient business process, you must complete the following tasks:
1. Configure the SWIFTNet Client service (or create a new instance of it) to reflect your installation. See
SWIFTNet Client Service.
2. Enable Document Tracking in the Business Process Manager.
Then you can execute the SWIFTNetClient business process as part of your SWIFTNet processing.

SWIFTNetClientFA Business Process


This is a client business process to send requests to SWIFTNet using FileAct.
Note: This business process is used with FileAct processing only. It takes the default parameters
configured in the SWIFTNet Client service. If a parameter defined in the SWIFTNet Client Service
is specified in this business process, the value in the business process overrides the parameter in the
SWIFTNet Client service.
The SWIFTNetClientFA business process is initiated as part of the following outbound process flow:
1. The SWIFTNetClientFA business process invokes the SWIFTNet Client service and passes it all the
necessary parameters to send a request.
2. The client application on the SWIFTNet MEFG Server processes the request.
This table lists the configuration parameters for the SWIFTNetClientFA business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Sterling Commerce, Inc. 82


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the SWIFTNetClientFA business process:


Note: The bold lines indicate information that you need to modify to match your installation.

Sterling Commerce, Inc. 83


SWIFT and SWIFTNet Business Processes

<process name="SWIFTNetClientFA">
<sequence name="SWIFTNetClientService">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<!-- build SWIFTNET request -->
<operation>
<participant name="SWIFTNetClientService"/>
<output message="handleClientRequest">
<assign to="." from="*"/>
<assign to="physicalFilename" from="''"/>
<assign to="logicalFilename" from="''"/>
<assign to="transferInfo" from="''"/>
<assign to="transferDesc" from="''"/>
<assign to="fileInfo" from="''"/>
<assign to="fileDesc" from="''"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</process>

Before Using the SWIFTNetClientFA Business Process


Before you use the SWIFTNetClientFA business process, you must complete the following tasks:
1. Configure the SWIFTNet Client service (or create a new instance of it) to reflect your installation. See
SWIFTNet Client Service.
2. Enable Document Tracking in the Business Process Manager.
Then you can execute the SWIFTNetClientFA business process as part of your SWIFTNet processing.

handleSWIFTNetServerRequest Business Process


The handleSWIFTNetServerRequest business process enables the application to receive SWIFTNet
messages. This is the bootstrap business process used by the inbound SWIFTNet request through the
SWIFTNet MEFG Server. It is a system business process used by the SWIFTNet Server adapter, which
pre-processes the incoming request, search the SWIFTNet Routing Rule table, and route the request payload
to the business process for processing.
Note: This business process is used with InterAct processing only.
The handleSWIFTNetServerRequest business process is initiated as part of the following inbound process
flow:

Sterling Commerce, Inc. 84


SWIFT and SWIFTNet Business Processes

1. The SWIFTNet Server adapter invokes the handleSWIFTNetServerRequest business process and
passes it all the necessary parameters to send a request.
2. The handleSWIFTNetServerRequest business process invokes the SOAP Inbound service.
3. The SOAP Inbound service:
Š Pre-processes the incoming request.
Š Searches the SWIFTNet Routing Rule table.
Š Routes the request payload to the business process for processing.
4. Then the SOAP Outbound service invokes the HTTP Response service.
5. The HTTP Response service sends a response to the request.

Sterling Commerce, Inc. 85


SWIFT and SWIFTNet Business Processes

This table lists the configuration parameters for the handleSWIFTNetServerRequest business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Sterling Commerce, Inc. 86


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the handleSWIFTNetServerRequest business process:


<process name="handleSWIFTNetServerRequest">
<sequence>
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapIn">
<participant name="SOAPInbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="bootstrap">false</assign>
<assign to="SOAP_INTERMEDIATE_NODE">false</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerRequest">
<assign to="." from="*"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<!-- internal processing by invoking a subprocess -->
<!-- business-specific processing that will return a response for InterAct -->

Sterling Commerce, Inc. 87


SWIFT and SWIFTNet Business Processes

<operation>
<participant name="InvokeSubProcessService"/>
<output message="Xout">
<assign to="INVOKE_MODE">SYNC</assign>
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
<!-- this is to construct the server response message back to GIS Server
application -->
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interface" from="SwiftServerRequest/interface/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Accepted</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
<onFault>
<!-- On Fault, we will clear PrimDoc, construct Rejected response and
soap-envelope it -->
<sequence>
<operation name="ReleasePrimDoc">
<participant name="ReleaseService"/>
<output message="outmsg">
<assign to="TARGET">/ProcessData/PrimaryDocument</assign>
<assign to="." from="*"/>

Sterling Commerce, Inc. 88


SWIFT and SWIFTNet Business Processes

</output>
<input message="inmsg"/>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interface"
from="SwiftServerRequest/interface/text()"/>
<assign to="messageID"
from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Rejected</assign>
<assign to="Description">Unable to get the Server
Response</assign>
<assign to="Info">Failure in getting the Server Response</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</onFault>
</sequence>
</process>

Before Using the handleSWIFTNetServerRequest Business Process


Before you use the handleSWIFTNetServerRequest business process, you must complete the following
tasks:
1. Configure the SWIFTNet Server adapter to reflect your installation. See SWIFTNet Server Adapter.

Sterling Commerce, Inc. 89


SWIFT and SWIFTNet Business Processes

2. Enable Document Tracking in the Business Process Manager for the handleSWIFTNetServerRequest
business process.

handleSWIFTNetServerSnFRequest Business Process


The handleSWIFTNetServerSnFRequest business process enables the application to receive SWIFTNet
store-and-forward messages. This is a bootstrap business process used by the inbound SWIFTNet request
that includes a store-and-forward option. For the store-and-forward option, an incoming request is not
processed immediately, but instead is stored in the responder mailbox in the application to be responded to
later. The application then sends an acknowledgement that the request has been successfully stored to the
requestor through the SWIFTNet MEFG Server.
Note: This business process is used with InterAct processing only.
The handleSWIFTNetServerSnFRequest business process is initiated as part of the following inbound
process flow:
1. The SWIFTNet Server adapter invokes the handleSWIFTNetServerSnFRequest business process and
passes it all the necessary parameters to send a request.
2. The handleSWIFTNetServerSnFRequest business process invokes the SOAP Inbound service.
3. The SOAP Inbound service:
Š Pre-processes the incoming request.
Š Searches the SWIFTNet Routing Rule table.
4. The Mailbox Add service Routes the request payload to the responder mailbox to be responded to
later.
5. Then the SOAP Outbound service invokes the HTTP Response service.
6. The HTTP Response service sends an acknowledgement to the requestor that the request has been
successfully stored.

Sterling Commerce, Inc. 90


SWIFT and SWIFTNet Business Processes

This table lists the configuration parameters for the handleSWIFTNetServerSnFRequest business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Sterling Commerce, Inc. 91


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the handleSWIFTNetServerSnFRequest business process:


<process name="handleSWIFTNetServerSnFRequest">
<rule name="IsAuthNotification">
<condition>SwiftServerRequest/AuthResponse = 'TRUE'</condition>
</rule>
<sequence>
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapIn">
<participant name="SOAPInbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="bootstrap">false</assign>
<assign to="SOAP_INTERMEDIATE_NODE">false</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerRequest">
<assign to="." from="*"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>

Sterling Commerce, Inc. 92


SWIFT and SWIFTNet Business Processes

</operation>
<choice name="AddToMailbox">
<select>
<case ref="IsAuthNotification" negative="true" activity="Mailbox Add
Service"/>
</select>
<!-- internal processing for SnF is to put into a Mailbox so that it can
bootstrap internal business process later-->
<!-- Mailbox path is based on SwiftServerRequest/responderDN/requestorDN/for
InterAct -->
<operation name="Mailbox Add Service">
<participant name="MailboxAdd"/>
<output message="AddRequest">
<assign to="." from="*"/>
<assign to="MailboxPath" from="concat('/',
SwiftServerRequest/responderDN/text(),'/',SwiftServerRequest/requestorDN/text())"/>
<assign to="ContentType">ascii</assign>
</output>
<input message="inmsg">
<assign to="AddResults" from="*"/>
</input>
</operation>
</choice>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode" from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Accepted</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>

Sterling Commerce, Inc. 93


SWIFT and SWIFTNet Business Processes

</input>
</operation>
<onFault>
<sequence>
<operation name="ReleasePrimDoc">
<participant name="ReleaseService"/>
<output message="outmsg">
<assign to="TARGET">/ProcessData/PrimaryDocument</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg"/>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Rejected</assign>
<assign to="Description">Unable to get the Server Response</assign>
<assign to="Info">Failure in getting the Server Response</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</onFault>
</sequence>
</process>

Sterling Commerce, Inc. 94


SWIFT and SWIFTNet Business Processes

Before Using the handleSWIFTNetServerSnFRequest Business Process


Before you use the handleSWIFTNetServerSnFRequest business process, you must complete the following
tasks:
1. Configure the SWIFTNet Server adapter to reflect your installation. See SWIFTNet Server Adapter.
2. Enable Document Tracking in the Business Process Manager for the
handleSWIFTNetServerSnFRequest business process.
3. Create a Responder Mailbox (/Responder DN) and Requestor Mailbox (/Responder DN/Requestor
DN) where the request payload can be saved.

handleSWIFTNetServerFARequest Business Process


The handleSWIFTNetServerFARequest business process enables the application to receive SWIFTNet
messages. This is the bootstrap business process used by the inbound SWIFTNet request through the
SWIFTNet MEFG Server. It is a system business process used by the SWIFTNet Server adapter, which
pre-processes the incoming request, search the SWIFTNet Routing Rule table, and route the request payload
to the business process for processing.
Note: This business process is used with InterAct processing only.
The handleSWIFTNetServerFARequest business process is initiated as part of the following inbound
process flow:
1. The SWIFTNet Server adapter invokes the handleSWIFTNetServerFARequest business process and
passes it all the necessary parameters to send a request.
2. The handleSWIFTNetServerRequest business process invokes the SOAP Inbound service.
3. The SOAP Inbound service:
Š Pre-processes the incoming request.
Š Searches the SWIFTNet Routing Rule table.
Š Routes the request payload to the business process for processing.
4. Then the SOAP Outbound service invokes the HTTP Response service.
5. The HTTP Response service sends a response to the request.

Sterling Commerce, Inc. 95


SWIFT and SWIFTNet Business Processes

This table lists the configuration parameters for the handleSWIFTNetServerFARequest business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Sterling Commerce, Inc. 96


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the handleSWIFTNetServerFARequest business process:


<process name="handleSWIFTNetServerFARequest">
<sequence>
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapIn">
<participant name="SOAPInbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="bootstrap">false</assign>
<assign to="SOAP_INTERMEDIATE_NODE">false</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerRequest">
<assign to="." from="*"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<!-- this is to construct the server response message back to GIS Server
application -->

Sterling Commerce, Inc. 97


SWIFT and SWIFTNet Business Processes

<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Accepted</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
<onFault>
<!-- On Fault, we will clear PrimDoc, construct Rejected response and
soap-envelope it -->
<sequence>
<operation name="ReleasePrimDoc">
<participant name="ReleaseService"/>
<output message="outmsg">
<assign to="TARGET">/ProcessData/PrimaryDocument</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg"/>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID"
from="SwiftServerRequest/messageID/text()"/>

Sterling Commerce, Inc. 98


SWIFT and SWIFTNet Business Processes

<assign to="Status">Rejected</assign>
<assign to="Description">Unable to get the Server
Response</assign>
<assign to="Info">Failure in getting the Server Response</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</onFault>
</sequence>
</process>

Before Using the handleSWIFTNetServerFARequest Business Process


Before you use the handleSWIFTNetServerFARequest business process, you must complete the following
tasks:
1. Configure the SWIFTNet Server adapter to reflect your installation. See SWIFTNet Server Adapter.
2. Enable Document Tracking in the Business Process Manager for the
handleSWIFTNetServerFARequest business process.

handleSWIFTNetServerFASnFRequest Business Process


The handleSWIFTNetServerFASnFRequest business process enables the application to receive SWIFTNet
store-and-forward messages. This is a bootstrap business process used by the inbound SWIFTNet request
that includes a store-and-forward option. For the store-and-forward option, an incoming request is not
processed immediately, but instead is stored in the responder mailbox in the application to be responded to

Sterling Commerce, Inc. 99


SWIFT and SWIFTNet Business Processes

later. The application then sends an acknowledgement that the request has been successfully stored to the
requestor through the SWIFTNet MEFG Server.
Note: This business process is used for FileAct processing only.
The handleSWIFTNetServerFASnFRequest business process is initiated as part of the following inbound
process flow:
1. The SWIFTNet Server adapter invokes the handleSWIFTNetServerFASnFRequest business process
and passes it all the necessary parameters to send a request.
2. The handleSWIFTNetServerFASnFRequest business process invokes the SOAP Inbound service.
3. The SOAP Inbound service:
Š Pre-processes the incoming request.
Š Searches the SWIFTNet Routing Rule table.
4. The Mailbox Add service Routes the request payload to the responder mailbox to be responded to
later.
5. Then the SOAP Outbound service invokes the HTTP Response service.
6. The HTTP Response service sends an acknowledgement to the requestor that the request has been
successfully stored.

Sterling Commerce, Inc. 100


SWIFT and SWIFTNet Business Processes

This table lists the configuration parameters for the handleSWIFTNetServerFASnFRequest business
process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Sterling Commerce, Inc. 101


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the handleSWIFTNetServerFASnFRequest business process:


<process name="handleSWIFTNetServerFASnFRequest">
<rule name="UndefinedCopyOrForceReject">
<condition>SwiftServerRequest/AuthRequest = 'N' or
SwiftServerRequest/FileInfoForceMode = 'Rejected'</condition>
</rule>
<rule name="AuthorizationNeeded">
<condition>SwiftServerRequest/AuthRequest = 'Y' and
SwiftServerRequest/FileInfoForceMode != 'Refused'</condition>
</rule>
<rule name="ForceRefusal">
<condition>SwiftServerRequest/FileInfoForceMode = 'Refused'</condition>
</rule>
<sequence>
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapIn">
<participant name="SOAPInbound"/>
<output message="output">

Sterling Commerce, Inc. 102


SWIFT and SWIFTNet Business Processes

<assign to="." from="*"/>


<assign to="bootstrap">false</assign>
<assign to="SOAP_INTERMEDIATE_NODE">false</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerRequest">
<assign to="." from="*"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<choice name="NeedAuthorization">
<select>
<case ref="AuthorizationNeeded" activity="Mailbox Add Service"/>
</select>
<!-- Put into a Mailbox so that it can bootstrap internal authorization business
process later -->
<!-- Mailbox path is based on SwiftServerRequest/recipientDN/requestorDN/ -->
<operation name="Mailbox Add Service">
<participant name="MailboxAdd"/>
<output message="AddRequest">
<assign to="." from="*"/>
<assign to="PrimaryDocument" from="HeaderInfo/@SCIObjectID"/>
<assign to="MessageName" from="concat('ThirdParty_',
SwiftServerRequest/copySnFReference/text())"/>
<assign to="MailboxPath" from="concat('/',
SwiftServerRequest/recipientDN/text(),'/',SwiftServerRequest/requestorDN/text())"/>
<assign to="ExtractableCount">1</assign>
<assign to="ContentType">ascii</assign>
</output>
<input message="inmsg">
<assign to="AddResults" from="*"/>
</input>
</operation>
</choice>
<choice name="IsUndefinedCopyOrForceReject">
<select>
<case ref="UndefinedCopyOrForceReject" negative="true"
activity="AcceptRequest"/>
<case ref="UndefinedCopyOrForceReject" activity="RejectRequest"/>
</select>
<operation name="AcceptRequest">
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode" from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Accepted</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>

Sterling Commerce, Inc. 103


SWIFT and SWIFTNet Business Processes

<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>


</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<sequence name="RejectRequest">
<operation name="ReleasePrimDoc">
<participant name="ReleaseService"/>
<output message="outmsg">
<assign to="TARGET">/ProcessData/PrimaryDocument</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg"/>
</operation>
<operation name="Form Reject Response">
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Rejected</assign>
<assign to="Description">Copy Profile is undefined or Responder forced to
reject</assign>
<assign to="Info">Unable to determine copy mode or FileInfo force
responder's rejection</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</choice>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>

Sterling Commerce, Inc. 104


SWIFT and SWIFTNet Business Processes

</operation>
<choice name="IsThirdPartyForceRefusal">
<select>
<case ref="ForceRefusal" activity="InvokeForceRefusalProcess"/>
</select>
<operation name="InvokeForceRefusalProcess">
<participant name="InvokeBusinessProcessService"/>
<output message="Invoke_In">
<assign to="." from="*"/>
<assign to="INVOKE_MODE">ASYNC</assign>
<assign to="WFD_NAME">SWIFTNet3rdPartyClientForceRefusal</assign>
</output>
<input message="Invoke_Out">
<assign to="." from="*"/>
</input>
</operation>
</choice>
<onFault>
<sequence>
<operation name="ReleasePrimDoc">
<participant name="ReleaseService"/>
<output message="outmsg">
<assign to="TARGET">/ProcessData/PrimaryDocument</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg"/>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Rejected</assign>
<assign to="Description">Unable to get the Server Response</assign>
<assign to="Info">Failure in getting the Server Response</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>

Sterling Commerce, Inc. 105


SWIFT and SWIFTNet Business Processes

<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</onFault>
</sequence>
</process>

Before Using the handleSWIFTNetServerFASnFRequest Business Process


Before you use the handleSWIFTNetServerFASnFRequest business process, you must complete the
following tasks:
1. Configure the SWIFTNet Server adapter to reflect your installation. See SWIFTNet Server Adapter.
2. Enable Document Tracking in the Business Process Manager for the
handleSWIFTNetServerFASnFRequest business process.

handleSWIFTNetServerFAEvent Business Process


The handleSWIFTNetServerFAEvent business process is used by the SWIFTNet MEFG Server. It is a
system business process called by the SWIFTNet Server adapter that preprocesses the incoming FileAct
Event with a COMPLETED status, searches the SWIFTNet routing rule table and bootstraps the business
process for processing.
Note: This business process is used for FileAct processing only.
The handleSWIFTNetServerFAEvent business process is initiated as part of the following inbound process
flow:
1. The SWIFTNet Server adapter invokes the handleSWIFTNetServerFAEvent business process and
passes it all the necessary parameters to send a request.
2. The handleSWIFTNetServerFAEvent business process preprocesses the incoming FileAct event.
3. The handleSWIFTNetServerFAEvent business process searches the SWIFTNet Routing Rule table.
4. Then the business process bootstraps the appropriate business process for processing.

Sterling Commerce, Inc. 106


SWIFT and SWIFTNet Business Processes

This table lists the configuration parameters for the handleSWIFTNetServerFAEvent business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Sterling Commerce, Inc. 107


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the handleSWIFTNetServerFAEvent business process:


<process name="handleSWIFTNetServerFAEvent">
<rule name="Backend_Workflow">
<condition>DoFABackendProcess= 'workflow'</condition>
</rule>
<rule name="Backend_MailBox">
<condition>DoFABackendProcess= 'mailbox'</condition>
</rule>
<sequence>
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapIn">
<participant name="SOAPInbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="bootstrap">false</assign>
<assign to="SOAP_INTERMEDIATE_NODE">false</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerRequest">
<assign to="." from="*"/>
</output>

Sterling Commerce, Inc. 108


SWIFT and SWIFTNet Business Processes

<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<!-- Process Completed FA Event with incoming, put or get request-->
<!-- non SnF - bootstrap Workflow -->
<!-- SnF - put in MailBox -->
<choice>
<select>
<case ref="Backend_Workflow" activity="processBackend_Workflow"/>
<case ref="Backend_MailBox" activity="processBackend_MailBox"/>
</select>
<sequence name="processBackend_Workflow">
<operation>
<participant name="InvokeSubProcessService"/>
<output message="Xout">
<assign to="INVOKE_MODE">SYNC</assign>
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
<sequence name="processBackend_MailBox">
<operation name="Mailbox Add Service">
<participant name="MailboxAdd"/>
<output message="AddRequest">
<assign to="." from="*"/>
<assign to="MailboxPath" from="concat('/',
SwiftServerRequest/responderDN/text(),'/',SwiftServerRequest/requestorDN/text())"/>
<assign to="ContentType">ascii</assign>
</output>
<input message="inmsg">
<assign to="AddResults" from="*"/>
</input>
</operation>
</sequence>
</choice>
<!-- this is to construct the server response message back to GIS Server
application -->
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID" from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Accepted</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>

Sterling Commerce, Inc. 109


SWIFT and SWIFTNet Business Processes

</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>
<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
<onFault>
<!-- On Fault, we will clear PrimDoc, construct Rejected response and
soap-envelope it -->
<sequence>
<operation name="ReleasePrimDoc">
<participant name="ReleaseService"/>
<output message="outmsg">
<assign to="TARGET">/ProcessData/PrimaryDocument</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg"/>
</operation>
<operation>
<participant name="SWIFTNetServerAdapter"/>
<output message="handleServerResponse">
<assign to="." from="*"/>
<assign to="interfaceMode"
from="SwiftServerRequest/interfaceMode/text()"/>
<assign to="messageID"
from="SwiftServerRequest/messageID/text()"/>
<assign to="Status">Rejected</assign>
<assign to="Description">Fail in Backend Process and unable to
get the Server Response</assign>
<assign to="Info">Failure in Backend Process and getting the
Server Response</assign>
<assign to="deliveryNotification"
from="SwiftServerRequest/deliveryNotification/text()"/>
<assign to="SnF" from="SwiftServerRequest/SnF/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SoapOut">
<participant name="SOAPOutbound"/>

Sterling Commerce, Inc. 110


SWIFT and SWIFTNet Business Processes

<output message="output">
<assign to="." from="*"/>
<assign to="SOAP_MODE">respond</assign>
</output>
<input message="input">
<assign to="." from="*"/>
</input>
</operation>
<assign to="doc-has-headers">true</assign>
<operation name="HttpResponse">
<participant name="HttpRespond"/>
<output message="Xout">
<assign to="." from="*"/>
</output>
<input message="Xin">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</onFault>
</sequence>
</process>

Before Using the handleSWIFTNetServerFAEvent Business Process


Before you use the handleSWIFTNetServerFAEvent business process, you must complete the following
tasks:
1. Configure the SWIFTNet Server adapter to reflect your installation. See SWIFTNet Server Adapter.
2. Enable Document Tracking in the Business Process Manager for the handleSWIFTNetServerFAEvent
business process.

SWIFTMessageEntryOutbound
The SWIFTMessageEntryOutbound business process is the default business process used to look up the
correct envelope, based on the information provided by the user while configuring the Send information in
the SWIFT Message Entry Workstation.
The SWIFTMessageEntryOutbound business process is initiated as part of the following outbound process
flow:
1. Create a SWIFT message using the SWIFT Message Entry Workstation.
2. Validate the message and mark it Ready to Send.
3. Do not change the default business process and send the SWIFT message you created.
4. The SWIFTMessageEntryOutbound business process invokes the EDI Encoder service.
5. The EDI Encoder service includes the Generic Envelope service.
6. The Generic Envelope service invokes the business process configured in the SWIFT Outbound
Envelope to send the SWIFT message.

Sterling Commerce, Inc. 111


SWIFT and SWIFTNet Business Processes

This table lists the configuration parameters for the SWIFTMessageEntryOutbound business process:

Parameter Default Description

Document Tracking False When document tracking is enabled for a business process,
tracking information is carried with the message throughout the
process, and the tracking information is persisted about the
message regardless of the persistence level you configured
globally for the application.

Set onfault processing False Onfault processing allows the process to immediately execute
the on-fault activity specified in the process, even if the process
has not yet reached that step in the process.
For example, if a process fails at step 3, but the on-fault activity
is specified in step 7, if onfault processing is enabled, the
process proceeds to the step 7 on-fault rather than halting at
step 3.

Start mode async Asynchronous initiation is selected by default. Starting


business processes asynchronously is recommended.
Asynchronous mode is standard processing, wherein the
business process is placed in queue and processed.

Transaction False This option instructs the application to treat the entire process
as a single transaction so that either all of the steps complete,
or, in the event of an error, none of them do. When an error
occurs, no data is committed; data returns to its pre-process
state.
By default, this transaction mode is not enabled.

Queue 4 The application enables you to set performance optimizations


by queue, defining queue levels to allocate resources. This
number indicates the previously allocated queue level that you
want for this business process model for processing.

Persistence Level System Default The level of data to retain for generating a status report that
describes each step that the business process completes.
System default indicates that, for the data, configuration is
already defined in the application to retain data.

Recovery Level Manual The level of recovery for this business process if the business
process should halt during execution. Manual requires you to
resume or restart the business process manually.

Document Storage Type System Default The level of document storage for messages that process
when the business process runs. System Default specifies to
store messages in the file system or database, according to
how you configured archiving and purging in the application.

Life Span Life Span Days — 2 The length of time, in days and hours, to retain the data in the
Life Span Hours — 0 application, along with the life span type and removal method.
Life Span Type —
System Level
Removal Method —
Archive

Sterling Commerce, Inc. 112


SWIFT and SWIFTNet Business Processes

Parameter Default Description

Complete by Deadline None Available Complete by – The deadline time, in hours and minutes, by
Note: To set a which the business process must complete process once it
deadline you starts.
must change Š First Notification: Hours and Minutes – Whether to receive
it in the notification before a business process deadline.
business
process. Š Second Notification: Hours and Minutes – Whether to
receive another notification before a business process
deadline.

Event Reporting Level Full The level of event reporting that is retrieved for this business
process when it runs. Full specifies to generate events for the
business process, including the business process start and
end time, start and end times for all services or services
running as a result of this business processes, and any
resulting errors and exceptions.

The following BPML code makes up the SWIFTMessageEntryOutbound business process:


<process name="SWIFTMessageEntryOutbound">
<sequence>
<assign to="PrimaryDocument"
from="//ProcessData/DOC/DOC-1/@SCIObjectID"></assign>

<operation name="EDI Encoder">


<participant name="EDIEncoder"/>
<output message="EDIEncoderTypeInputMessage">
<assign to="AccepterLookupAlias" from
="//ProcessData/AccepterLookupAlias/text()" />
<assign to="EDIStandard">SWIFT</assign>
<assign to="ReceiverID" from ="//ProcessData/ReceiverID/text()" />
<assign to="SenderID" from ="//ProcessData/SenderID/text()"/>
<assign to="MODE">IMMEDIATE</assign>
<assign to="." from="*"></assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>

<operation name="EDI Envelope">


<participant name="EDIEnvelope"/>
<output message="EDIEnvelopeTypeInputMessage">
<assign to="MODE">IMMEDIATE</assign>
<assign to="." from="*"></assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>

<operation name="Invoke Business Process Service">


<participant name="InvokeBusinessProcessService"/>

Sterling Commerce, Inc. 113


SWIFT and SWIFTNet Business Processes

<output message="Xout">
<assign to="INVOKE_MODE">SYNC</assign>
<assign to="." from="*"></assign>
</output>
<input message="Xin">
<assign to="." from="*"></assign>
</input>
</operation>

</sequence>
</process>

Before Using the SWIFTMessageEntryOutbound Business Process


Before you use the SWIFTMessageEntryOutbound business process, you must enable Document Tracking
in the Business Process Manager for the SWIFTMessageEntryOutbound business process.

Sterling Commerce, Inc. 114


Creating SWIFT Maps

Overview
The Map Editor enables you to map SWIFT documents. The Map Editor generates a file layout for you
using the components and message types that you select. The Map Editor-generated SWIFT map consists
of groups, records, composites, and fields that are comparable to parameters that are defined by SWIFT. See
How SWIFT Terminology Correlates with the Map Editor on page 116.
Note: You need to download the Map Editor component from the application to use it.
Map Editor allows you to modify the map components by using the Deactivate, Promote, Split, Copy, Cut,
and Paste functions.
You can create a map for all SWIFT Standards Release messages loaded into the standards database through
the Map Editor. All messages are validated by the application for syntax (for example, field types, field
lengths, and so forth). See Overview on page 7 for information on which messages are validated by the
application for syntax and semantics. If you create a map for a message that is not currently validated by the
application, when the Map Editor is capable of updating your existing map with message validation rules in
a future release, any extended rules you have created will exist outside the validation block (and thus will
always run regardless of whether validation is enabled).
When you create a map, for both the input and output sides, you choose whether you want to use a preloaded
standard, an existing file format, or wants to create a new file format for that side of the map (including
selecting from standards that you have previously downloaded to the standards database. The preloaded
standards are automatically loaded when you download the Map Editor to your machine. You must install
the SWIFT Financial Services XML Standards to be able to select SWIFTNet Bulk Payments, SWIFTNet
Transaction Reporting, SWIFTNet Funds, SWIFTNet Trade Services Utility, SWIFTNet Exceptions and
Investigations, SWIFTNet Proxy Voting, SWIFTNet SCORE, SWIFTNet FpML, SWIFTNet Cash
Management, or SWIFTNet Cash Reporting.
However, if you want to use a specialized version of a message that is not available in the application
SWIFT data dictionary, it may be appropriate for you to define the SWIFT map yourself. Alternatively, you
could use an MT or MX that is similar to what is required and customize it yourself.
The application also performs SWIFT MX validations. Validations are defined in the
translator_swift_mx.properties property file and generated maps define the parameters used to look up
validates in this property file. Changes to validations are also applied to SWIFT MX messages for
currencies, BICPlusIBAN, BIC/BEI addresses, and International Bank Account Number checksum
validation (IBAN). You can define code lists for currencies, countries, ,BIC or BEI addresses (that are
validated against the SWIFT_Addresses code list) BICPlusIBAN, and SEPARouting. IBAN data contains

Sterling Commerce, Inc. 115


Creating SWIFT Maps

a country code that is validated against the SWIFT_Countries code list in the application, and additional
IBAN validation is handled internally by the translator.
The application supplies you with the following statements to be used with SWIFT maps and any other data
format:
✦ cerror
✦ exist
✦ occurrencetotal
✦ resetoccurrencetotal
✦ sum
✦ sumtotal
See Alphabetic Language Reference for all the available extended rules.
To ensure that extended rules for SWIFT maps are only run when validation is enabled, place your custom
extended rule code in a validation block. See Creating Extended Rules for SWIFT Maps on page 127.

How SWIFT Terminology Correlates with the Map Editor


The terminology used by SWIFT differs from that used in the Map Editor. This table lists the SWIFT terms
and how they correspond to map components in the Map Editor:

SWIFT Terminology Corresponding Map Editor Terminology

MT or MX (File) SWIFT file format (the top map component on the input
and output sides of a map)

Sequence or an implicit group of repeating field tags Group

Field tag SWIFT Record

Subfield that is an “OR” option or a group of related Composite


subfields that occur in a sequence, and they are also
groups of related subfields that occur in a sequence (for
example, each SWIFTBIC address is defined as a
“composite” consisting of a number of subfields such as
branch code, location, and so forth)

Subfield Field

Component or a group of SWIFT components that define Field


a SWIFT subfield

SWIFT Components in the Map Editor

Sterling Commerce, Inc. 116


Creating SWIFT Maps

The following table lists the components that make up the SWIFT layout in the Map Editor, the icons that
represent the components, and descriptions of the components. For information about adding a map
component to a layout, see Map Editor Basics.

Component Icon Description

SWIFT root The SWIFT root element represents the MT or MX that the application is mapping. At
element the SWIFT file root element, you define the message type and encoding. It is a group and
can contain groups and SWIFT records.

Group A group is a looping structure that contains a sequence or an implicit group of repeating
field tags (in Map Editor a group is related records and groups that repeat in sequence
until either the group data ends, or the maximum number of times that the loop is
permitted to repeat is exhausted).
A group that is subordinate to another group is a subgroup (and corresponds to a nested
looping structure, a loop within a loop).
When a group contains an extended rule or a standard rule, an asterisk appears to the
right of the group icon.

SWIFT Record A SWIFT record contains a field tag (in Map Editor a SWIFT record is a group of related
fields or composite data elements that combine to communicate useful data). A SWIFT
record can occur once or can repeat multiple times.
Note: If a SWIFT record occurs more than once in a map, it is identified by its name
<ID>. The second and subsequent occurrences are identified by <ID>:n, where
n is the number of the occurrence in the map.

Composite A composite is a subfield that is an “OR” option or a group of related subfields that occur
in a sequence (in Map Editor a composite is a data element that contains two or more
component data elements or subelements). They are also groups of related subfields that
occur in a sequence. For example, each SWIFTBIC address is defined as a “composite”
consisting of a number of subfields (e.g. branch code, location).
A composite can occur once or repeat multiple times.
For example, each SWIFTBIC address is defined in the Map Editor as a composite that
consists of a number of fields (SWIFT subfields) such as branch code, location, and so
forth.
Note: If a composite occurs more than once in a map, it is identified by its name <ID>.
The second and subsequent occurrences are identified by <ID>:n, where n is
the number of the occurrence in the map.
A repeating composite is a related group of fields that have the ability to loop as a whole
(occur more than once) within a particular SWIFT record. To enable a composite to
repeat multiple times within a SWIFT record, each occurrence of the composite must be
separated by a start and end delimiter.

Note: SWIFT does not use the repeating option, although it is available to you.

Sterling Commerce, Inc. 117


Creating SWIFT Maps

Component Icon Description

Field A field is a subfield or a group of SWIFT components (the smallest piece of information
defined by the SWIFT standard) that define a SWIFT subfield. A field can have different
meanings depending on the context. In other data formats in the Map Editor, a field is not
considered to have useful meaning except in the larger context of the record that contains
it. However, fields used in the Map Editor to represent SWIFT subfields and components
contain useful and discrete information.
Note: If a field occurs more than once in a map it is identified by its name <ID>. The
second and subsequent occurrences are identified by <ID>:n, where n is the
number of the occurrence in the map.
A repeating field is a field with the ability to loop (occur more than once) within a particular
SWIFT record. To enable a single field to repeat multiple times within a SWIFT record,
each occurrence of the field must be separated by a start and end delimiter. The use of
start and end delimiters help the translator determine where subfields and components
are defined within a field tag.
When a field has a link performed against it, a red check mark appears over the field icon.
When a field contains an extended rule or a standard rule, an asterisk appears to the right
of the field icon.

Downloading and Installing the SWIFT Standards Database


Before you install the SWIFT standards database on your desktop, consider these guidelines:
✦ Download the Map Editor.
✦ For the most current version of the SWIFT standard, contact Sterling Commerce Customer Support.
✦ Be sure your desktop meets the Windows Client requirements listed in the System Requirements.
To download and install the standards database:
1. From the application Deployment menu, select Standards.
Note: You must download and install both the Map Editor and the desired SWIFT Standards Database
from the same application release.
2. In the Download and Install section next to Download SWIFT Standards, click Go!
3. In the File Download dialog box, select a download option, then click OK.
Š If you choose to run the file click Run and the operating system downloads the files immediately.
Š If you choose to save the file, the operating system prompts you to save the file. Browse to the
location where you want to download the file and click OK. If you want to continue installing, run
the file you just saved from the location you specified.
4. In the Security Warning page, select Always trust content from Sterling Commerce (Mid
America), Inc. if you do not want to see similar security messages in the future when you download
software from Sterling Commerce. Click Yes.
5. In the Welcome window, click Next.
6. In the Choose Destination Location window, select where you want to install the standards database:
Š If you accept the default location, click Next.

Sterling Commerce, Inc. 118


Creating SWIFT Maps

Š If you want to specify a different location, click Browse, specify the path to the folder, click OK,
and click Next.
If you specify a folder name that does not exist, the application displays a message asking if you want
to create that folder.
7. In the Select Components window, verify that SWIFTStandardDatabase is selected and click Next.
The download wizard installs the standards database.
8. In the Setup Complete window, click Finish.

Creating a File Layout from an MT or Market Practice


When you create a new map, you typically use the map wizard that creates a layout for you based on an MT
or Market Practice from the standards database. The wizard saves you the time and effort to create the
SWIFT side of the map yourself, and minimizes the risk of having an invalid standard format for a message.
When you create a map, for both the input and output sides, you choose whether you want to use a preloaded
standard, an existing file format, or wants to create a new file format for that side of the map (including
selecting from standards that you have previously downloaded to the standards database.
Note: You can create a map for all SWIFT messages through the Map Editor, and all messages are
validated by the application for syntax (that is, field types, field lengths, and so forth).
To create a file layout from an MT, MX, or Market Practice:
1. From the Map Editor File menu, select New.
2. In the New Map Wizard, complete the questions in the first window and click Next.
Note: Be sure that Sterling Integrator is selected in the What type of map are you creating list.
3. If you are translating from SWIFT, in the Input Format window, Create a new data format using this
standards, select SWIFT (Society for Worldwide Interbank Financial Telecommunications) and
click Messages.
Note: The Create a new data format using this selection allows you to use a preloaded standard (that is,
you do not have to download the standard to the application database) or use the standards that were
downloaded through the standards database.
4. Click Next.
5. Select the type of message to auto-generate:
Š Standard SWIFT Message Type
Š Market Practice or Fund message
Š Custom Market Practice or Fund message
Note: If you select Custom Market Practice or Fund message, you must have already created a custom
Market Practice or Fund message to have it listed as an available option.
6. If you are translating an MT, select the GIS SWIFT Standard ODBC data source (which contains the
SWIFT standards database) and click Next.

Sterling Commerce, Inc. 119


Creating SWIFT Maps

7. If you are translating a Market Practice, select the GIS SWIFTMP Customer ODBC data source
(which contains the SWIFT preloaded market practices) and click Next.
8. If you are translating from an MT, select the MT that you want to use and select the version, and click
Next.
9. If you are translating from a preloaded Market Practice or fund message, select the MT you want to
modify and click Next.
10. If you are translating from SWIFT, click Finish to load the MT you selected.
11. Click Next.
12. If you are translating to SWIFT, in the Output Format window, select SWIFT (Society for
Worldwide Interbank Financial Telecommunications) and click Customize. If you are translating
from another format, select that format and continue to the next screen.
13. Click Next.
14. If you are translating to SWIFT, select the GIS SWIFT Standard ODBC data source (which contains
the SWIFT standards database) and click Next.
15. If you are translating to SWIFT, select the MT that you want to use and select the version, and click
Next.
16. If you are translating to SWIFT, click Finish to load the MT you selected.
17. Click Next.
18. If you are translating to SWIFT, click Finish. The Map Editor displays the new map in the Map Editor
window.
19. Use Autolink to link your fields prior to using the Link function or creating standard or extended rules.
20. Use the Rule Library Manager to add a reusable extended rule library that can then be added to any
map so you do not have to redefine extended rules for each map you create.
Note: The SWIFT extended rules libraries that are installed with the application, contain all the extended
rules necessary to carry out the business logic for SWIFT messages. Extended Rule Libraries from
2008 and forward are delivered in the SWIFT Standards Install.

Creating a Custom Market Practice or Fund Message


You have the capability to create a custom market practice or fund message by using the Map Editor to
create a message of the same message type you want, modifying it accordingly, and using the SWIFT Rule
Importer to import the map into the application.
To create a custom Market Practice or Fund message:
1. From the Map Editor File menu, select New.
2. In the New Map Wizard, complete the questions in the first window and click Next.
Note: Be sure that Sterling Integrator is selected in the What type of map are you creating list.
3. In the Input Format window, Create a new data format using this standards, select SWIFT (Society
for Worldwide Interbank Financial Telecommunications) and click Messages.
4. Click Next.

Sterling Commerce, Inc. 120


Creating SWIFT Maps

5. Select Standard SWIFT Message Type as the type of message to auto-generate.


6. Select the GIS SWIFT Standard ODBC data source (which contains the SWIFT standards database)
and click Next.
7. Select the MT that you want to use and select the version, and click Next.
8. If you are translating from SWIFT and have selected a common group MT, select the MT for copy
fields and click Next.
9. If you are translating from SWIFT, click Finish to load the MT you selected.
10. Click Next.
11. In the Output Format window, select SWIFT (Society for Worldwide Interbank Financial
Telecommunications) and click Customize. If you are translating from another format, select that
format and continue to the next screen.
12. Click Next.
13. Select the GIS SWIFT Standard ODBC data source (which contains the SWIFT standards database)
and click Next.
14. Select the same MT that you selected for the Input Format and select the version, and click Next.
Note: By selecting the same MT on both the input and output sides of the map, you are creating a
“passthrough” map.
15. If you are translating to SWIFT and have selected a common group MT, select the MT for copy fields
and click Next.
16. Click Finish to load the MT you selected.
17. Click Next.
18. Click Finish. The Map Editor displays the new map in the Map Editor window.
19. On the Output side of the map, right-click the SWIFT Properties icon and select Properties.
20. Select the Message Type tab.
21. In Market Practice ID, type the unique identifier for the market practice. This identifier distinguishes
the map from the standard SWIFT message type.
Note: This identifier must be 6 upper-case alphanumerics with no spaces. You create the unique Market
Practice ID.
22. Use the Save As function to save the modified map under a new name.
23. Open a command window and change to the directory where you installed the SWIFT Standards
Database.
24. Then, from the Map Editor File menu, select New so you can use the customer Market Practice or
Fund message to create a new map.
25. In the New Map Wizard, complete the questions in the first window and click Next.
Note: Be sure that Sterling Integrator is selected in the What type of map are you creating list.
26. In the Input Format window, Create a new data format using this standards, select SWIFT (Society
for Worldwide Interbank Financial Telecommunications) and click Messages.
27. Click Next.

Sterling Commerce, Inc. 121


Creating SWIFT Maps

28. Select Custom Market Practice or Fund Template as the type of message to auto-generate.
29. Select the GIS SWIFT Standard ODBC data source (which contains the SWIFT standards database)
and click Next.
30. Select the custom Market Practice or Fund message and click Next.
31. Follow the prompts to complete the map selection.
32. Click Finish. The Map Editor displays the new map in the Map Editor window.
33. Use Autolink to link your fields prior to using the Link function or creating standard or extended rules.
34. Modify the map to implement the additional restrictions related to the desired Market Practice or Fund
message.
35. Use the Rule Library Manager to add a reusable extended rule library that can then be added to any
map so you do not have to redefine extended rules for each map you create.
Note: The SWIFT extended rule libraries that are installed with the application contain all the extended
rules necessary to carry out the business logic for SWIFT messages. Extended Rule Libraries from
2008 and forward are delivered in the SWIFT Standards Install.
36. For the SWIFT Rule Importer command script, set the Java_home variable.
37. Run the SWIFT Rule Importer from the command prompt using the following syntax:
SWIFTRuleImporter MapName.mxl
38. Save your map using the following naming convention:
SWIFT_<version>_<messageType>[_<messageExtension>]_<marketPracticeID>.mxl
Note: In this syntax, version is synonymous with year. For Market Practices, you do not need a
messageExtension since all market practice maps are in the 5xx series. The map must be saved in
MXL format.
39. Compile the map.
40. If necessary, update your property files with code word and qualifier validations that are specific to the
Market Practice.
Note: The properties file to update is translator_swift_mp_customer_year.properties, located in the
<install_dir>/properties directory.

Creating a SWIFTSolutions (MX)


When you create a SWIFTSolutions (MX) map, for both the input and output sides, you choose whether you
want to use a preloaded standard, an existing file format, or wants to create a new file format for that side
of the map (including selecting from standards that you have previously downloaded to the standards
database. The preloaded standards are downloaded when you download the Map Editor to your machine and
include SWIFTNet Funds, SWIFT eMandate, SWIFTNet Funds Passport, SWIFTNet Trade Services
Utility, SWIFTNet Exceptions and Investigations, SWIFTNet Cash Reporting, Bulk Payments, Cash
Management, Cash Reporting Proxy Voting, FpML, SCORE, and Transaction Reporting.
For a complete list of the preloaded standards consult the Map Editor New Map Wizard.
Note: If the map you are creating contains greater than 20,000 objects, you will receive a message noting
that this map contains a very large number of objects. For best performance, it is recommended that

Sterling Commerce, Inc. 122


Creating SWIFT Maps

you consider whether any unnecessary objects in the map can be removed, do not expand the entire
object tree—expand only the section of the tree you are currently mapping, consider using the “Show
links to or from the currently selected element” option instead of the “Show links to or from all
visible elements” option, and save the map using the.MAP file format (using the Save As function).
Note: For the ContractCreated and ContractNovated SWIFTNet FpML messages, all conditional elements
are disabled by default but a tree list is displayed to allow you to select the elements that you want
to be generated.

To create a map using a preloaded SWIFTNet Fund message:


1. From the Map Editor File menu, select New.
2. In the New Map Wizard, complete the questions on the first screen.
Note: To use XML schemas, the map type must be Sterling Integrator.
3. If you are translating from a SWIFTNet Fund message, from the Create a new format using this
standard list, select SWIFTNet Funds (or SWIFTNet Bulk Payments,SWIFTNet Trade Services
Utility, SWIFTNet Exceptions and Investigations, SWIFTNet Funds Passport, SWIFTNet Transaction
Reporting, SWIFT eMandate, SWIFTNet Proxy Voting, SWIFTNet SCORE, SWIFTNet FpML,
SWIFTNet Cash Management, or SWIFTNet Cash Reporting) and click Messages. If you are
translating from another format, select that format and continue to the next screen.
4. Complete the Map Wizard by selecting the version of the standard, the desired message, the maximum
length of the data elements, and whether to build codelists for enumerated attributes, and click Next.
Note: The default for the Build code lists for enumerations check box is cleared because using code lists
may be redundant and thus your map is smaller and more efficient without them.
5. Click Next.
6. If you chose to import an XML schema, do not modify any of the subelements selected in the display.
This list is included for your information only. Click Next.
If you are using an XML schema and the XML parser detects any errors, the messages are displayed in
an error window.
7. Click Finish.
8. If you are translating to a SWIFTNet Fund message, on the Output screen (from the Create a new
format using this standard list), select select SWIFTNet Funds (or SWIFTNet Bulk Payments,
SWIFTNet Trade Services Utility, SWIFTNet Funds Passport, SWIFTNet Transaction Reporting,
SWIFT eMandate, SWIFTNet Exceptions and Investigations, SWIFTNet Proxy Voting, SWIFTNet
SCORE, SWIFTNet FpML, SWIFTNet Cash Management, or SWIFTNet Cash Reporting) and click
Messages. If you are translating from another format, select that format and continue to the next
screen.
9. Complete the Map Wizard by selecting the version of the standard, the desired message, the maximum
length of the data elements, and whether to build codelists for enumerated attributes, and click Next.
Note: The default for the Build code lists for enumerations check box is cleared because using code lists
may be redundant and thus your map is smaller and more efficient without them.
10. Click Next.

Sterling Commerce, Inc. 123


Creating SWIFT Maps

11. If you chose to import an XML schema, do not modify any of the subelements selected in the display.
This list is included for your information only. Click Next.
If you are using an XML schema and the XML parser detects any errors, the messages are displayed in
an error window.
12. Click Finish.
The XML Load Warnings dialog box opens if there are any errors. If the Map Editor made changes to
the DTD to make it compliant with the application, it indicates the changes. Click OK.
13. Continue with the New Map Wizard as directed. When you click Finish, the Map Editor displays the
new map in the Map Editor window.

Converting Your Map to Another SWIFT Standards Version


The Update SWIFT Version features enable you to convert the SWIFT MT format side of your map to the
most recent standards version from the standards database, and to save it to a new map.
Note: Prior to this version of the Map Editor, SWIFT numeric fields were generated with a maximum of
nine decimal places (R9 format). However, SWIFT special functions allow for greater precision. For
example, AMOUNT<15> can have a maximum of 13 decimal positions, and with this version the
Map Editor supports numeric formats greater than R9. Therefore, the numeric fields have been
upgraded for SWIFT and any previously generated map that is updated through the SWIFT Update
feature will have the numeric fields updated to support the greater precision. These changes will be
reported as “standard fixes” in the report.
The Update Version feature:
✦ Migrates the old map to the new SWIFT standard version.
✦ Identifies the differences between the required (mandatory) map components in the old version as
compared with the new version and reports the following changes:
Š STANDARD Change: A change from the old map that was made by the new SWIFT standard.
Š STANDARD Fix: A change from the old map that was made by a fix to the Map Editor.
Š CUSTOM Change: A change from the old map that was made by you (the customer).
Š CONFLICT Change: A change from the old map that was made by you (the customer), but the
change conflicts with a change made by the new SWIFT Standard.
✦ Inserts the new required map components into the newly created version of the map.
✦ Ignores any “temporary” map components you have created to use as work areas for calculations and
so forth. You can use temporary records and fields when you cannot use a simple link or if you must
extract only specific occurrences of a record from your data file. A simple link enables you to join data
from the Input and Output sides of the map in either a one-to-one relationship (map components that
both do not repeat) or a many-to-many relationship (map components that repeat the same number of
times). See the Map Editor Guide for more information.
✦ Provides you with a report that denotes the differences between the two standard versions and lists the
segments and elements that are added as part of new standard version and were not in the old map. It
will also list custom changes carried forward to the new version of the map.

Sterling Commerce, Inc. 124


Creating SWIFT Maps

Note: If a field and record is no longer used in the new standard, it is deleted from the map and a note of
the deletion is included in the report. If a link is broken as a result of a deletion, that is also noted in
the report.
To upgrade to a newer SWIFT standards version:
1. In Map Editor, open the map.
2. Select a map component on the side of the map you want to upgrade.
3. Select Functions > Update > SWIFT Version.
4. Select the ODBC data source that contains the SWIFT standards database or the ODBC data source
that contains the customer Market Practices. Click Next.
5. Type the name of the new map or accept the default, and click Next.
6. Click Finish to start the standard version upgrade process and create the new map.
The upgrade process reads in the new version of the SWIFT standard and the old version of the
standard specified by the map. The upgrade procedure consists of a three-way comparison between
the new SWIFT standard, the customer map, and the old SWIFT standard (that is, the version defined
by your map).

SWIFTNet Syntax Validation


SWIFT field tag syntax validation is defined in the Map Editor and stored in the
translator_swift_2008.properties file, the translator_swift_2009.properties, and the
translator_swift_2010.properties file. This properties file contains the validation syntax for the field tags, as
defined by the SWIFT standards (for example, field 73 is 35x[‘CRLF’35x]0-5), and may not be edited. The
validation syntax for any given record is displayed in the Field Syntax parameter on the SWIFT Record
Properties dialog box (SWIFT Validation tab). This parameter is automatically populated when you create
a map using the SWIFTNet standards data dictionary. The convention of the syntax conforms exactly to the
SWIFT documentation.
SWIFT also uses special validation functions such as <CUR>, <SWIFTBIC>, and <NON-SWIFTBIC>,
which are components of a field tag. Each of these special functions has an expanded syntax that is validated
by the translator. When these special validation functions are used, the special function syntax is displayed
in the Field Syntax text box on the SWIFT Record Properties dialog box. The currency (<CUR>) and
sender/receiver addresses (<SWIFTBIC>, <NON-SWIFTBIC>) must also be validated against legal code
word lists. These code lists are defined in the SWIFT standards data dictionary and used by the application.
Note: You will need to maintain these code lists in the application (not in the Map Editor). See Creating
and Using Code Lists for more information.

SWIFT MX Validation
The application performs SWIFT MX validations. Validations are defined in the
translator_swift_mx.properties property file and generated maps define the parameters used to lookup
validates in this property file.
The following is an example entry from the translator_swift_mx.properties property file for Currency
validation. In this example, currency validation is performed on the XML element Amt, attribute Ccy.

Sterling Commerce, Inc. 125


Creating SWIFT Maps

swiftMX.tsmt.009.001.02.Amt.Ccy=CUR
Note: There are also currency validation functions: CURACTIVE (active currency) and CURACTHIST
(active or historic currency).
The following is an example entry from the translator_swift_mx.properties property file for Country
validation. In this example, country validation is performed on the XML element PdctOrgn.
swiftMX.tsmt.009.001.02.PdctOrgn=CC

The following is an example entry from the translator_swift_mx.properties property file for IBAN
validation. In this example, IBAN validation is performed on the XML element IBAN.
swiftMX.tsmt.009.001.02.IBAN=IBAN

The following is an example entry from the translator_swift_mx.properties property file for BIC
validation. In this example, BIC validation is performed on the XML element BIC.
swiftMX.tsmt.009.001.02.BIC=BIC

When you create a SWIFT MX map, the parameters used to look up validations in the property file are
defined on the Map Details dialog box. This table describes the Map Details parameters and their function
in MX validation:

Map Details Parameter Description of MX Validation Function

Agency (description field) SWIFT-MX identifies the map as requiring SWIFT MX validation.

Version The version of the SWIFT solution (for example, 1-0).

Transaction (description The schema name is used as a unique key to lookup validation entries. For example,
field) tsmt.009.001.02 is a unique key for a Trade Services Baseline Amendment Request in
which:
Š tsmt is the SWIFT solution (for example, Trading Services)
Š 009.001.02 is the schema name

Error Codes for MX Validation


The following error codes are logged when MX validation errors occur. These errors are logged in the
translator report and in the SWIFT Message Editor when you are using the Document Repair function:

Error Code Description

Sw.Stds.D00001 Invalid BIC code

Sw.Stds.D00002 Invalid BEI code

Sw.Stds.D00003 Invalid IBAN code

Sw.Stds.D00004 Invalid country code

Sw.Stds.D00005 Invalid active currency code

Sw.Stds.D00006 Invalid active or historic currency code

Sw.Stds.D00007 Invalid currency code or too many decimal digits

Sterling Commerce, Inc. 126


Creating SWIFT Maps

Error Code Description

Sw.Stds.D00008 Invalid BIC or BEI code

Creating Extended Rules for SWIFT Maps


In the next release of SWIFT there will be support to update existing maps to include or add any message
rule validation changes. This future update feature will impact you only if you want custom code in the
extended rules (in existing maps) included in the validation block that only runs when validation is enabled.
The update feature places custom extended rule code outside of the validation block. Thus, if you want to
create custom rules used only during validation, then you need to follow the example below when you write
extended rules for SWIFT maps to ensure they are only run when validation is enabled:
if validation = 1 then
begin
{type your custom validation extended rule code}
end

Extended Rules Used with SWIFT Maps


The following new extended rules are used with SWIFT maps, though they can also be used with any other
data format:
✦ cerror
✦ occurrencetotal
✦ resetoccurrencetotal
✦ sum
✦ sumtotal
See Alphabetic Language Reference for information on all the available extended rules.

Using Autolink and Link


The Autolink function automatically creates links between input and output fields that have the same name
or which contain logically equivalent business data. This functionality can be used regardless of which
format you have selected for the input and output sides of your map. See Using Autolink with the Map Editor
for more information on using this function. You can choose to link by either Field Name or Business Name.
Note: To increase the likelihood that the links in your maps are valid, in the Preferences dialog box
Confirmations tab, select the link objects at different levels and link objects with different maximum
usages confirmations. See Using Autolink with the Map Editor for more information on using this
function.
Just like with the Link function, the link between two map components is represented visually with a
connecting line. See Creating Simple Links for more information on the Link function.

Sterling Commerce, Inc. 127


Creating SWIFT Maps

Note: An erroneous message is displayed when you deactivate a group that contains linked fields in the
Map Editor. The message displayed is: “The object is part of one or more links. Deleting the object
will remove the links. Do you want to continue?” This message should read “The object is part of
one or more links. Deactivating the object will remove the links...” If you receive this message when
deactivating a linked map component, be assured that the group object is not deleted, and you should
ignore the erroneous message.

Using Extended Rule Libraries with SWIFT


This section describes how to use the extended rule library and the properties of the dialog boxes that
comprise its functionality. A rules library (used with SWIFT and any other data format) contains a list of
rules in a separate file outside of the Map Editor source. Map Editor stores the name of the library in its
source file, so when you open a map the library is also loaded. When you compile a map, the library rules
that are referenced in the map are also compiled. This enables you to create a library of extended rules and
then add it to any other map, so you do not have to recreate those extended rules after the first time. You
can use this functionality with any data format.
Note: The SWIFT extended rules libraries from 2008 and forward are delivered in the SWIFT Standards
install. These contain all the extended rules necessary to carry out the business logic for SWIFT
messages.
Note: Please note that for all application versions 4.3 and higher, changes have been made to the extended
rule library for SWIFT_2007 to report field errors more accurately in the Message Entry
Workstation. For this reason, many SWIFT_2007.erl methods were modified and are no longer
compatible with maps that were created prior to this change. If you encounter this issue, you can
recreate your map using the latest version of the standard. Alternatively, you can install the 4.2
version of the SWIFT_2007.erl file (this is installed when the Map Editor from application version
4.2 is installed), save that .ERL file in a different location, and then reinstall the latest version of the
Map Editor. Once the latest Map Editor is installed, replace the existing SWIFT_2007.erl with the
one you obtained from 4.2 and then compile using that library with the latest Map Editor.
Semantic validation rules for Market Practices are stored in an extended rule library separate from the
library that implements the SWIFT standard semantic validation rule
Only the extended rule libraries referenced by a map are compiled into the TXO translation object.
This functionality minimizes the impact to users when, for example, SWIFT updates their
messages—without the rule library you would need to update the extended rules for each updated map
(correlating to the updated messages), but using the extended rule library you just update the library and
then use the library with all the applicable maps.
When you view the checked in libraries through the Extended Rule Library check in interface, you are also
able to obtain a list of all the maps that use each library.
The extended rules library can contain many rules. An extended rule consists of a declarations section
followed by a statements section. The declarations section is required only if you use additional variables.
The declarations section is where you declare the names and types of any variables you use either in the
extended rule. The statements section is where you define the actions that you want the extended rule to run.
When calling a rule library function, you can pass parameters.

Sterling Commerce, Inc. 128


Creating SWIFT Maps

You must declare any variables that are not already defined as part of the input or output specification of
the map before you use those variables in an extended rule. For the extended rule libraries, you typically use
global variables that are passed as parameters.
Rule libraries are versioned resources. When you create a new rule library you need to check it in to the
application just like you need to check in maps. This also enables you to check out, version, and delete
extended rule libraries. Furthermore, when you view the checked in libraries through the Extended Rule
Library check in interface, you can also see all the maps that use each library. This is very important because
it enables you to easily view a list of the maps that will need to be recompiled if you change an extended
rule in a library (you would recompile all the maps that use that particular library).
Additionally, you can import and export extended rule libraries into the application using the Resource
Manager.
You can call an extended rule from a library in any extended rule in a map.
See Extended Rule Libraries for more information on this functionality.
The extended rule libraries that are preloaded for use with SWIFT are as follows:

Library ERL File Name Description

SWIFT_2002 SWIFT_2002.erl Contains rules to validate SWIFT


2002 MT and MX messages

SWIFT_2005 SWIFT_2005.erl Contains rules to validate SWIFT


2005 MT and MX messages

SWIFT_2006 SWIFT_2006.erl Contains rules to validate SWIFT


2006 MT and MX messages.

SWIFT_2007 SWIFT_2007.erl Contains rules to validate SWIFT


2007 MT and MX messages.

SWIFT_2008 SWIFT_2008.erl Contains rules to validate SWIFT


2008 MT and MX messages.

SWIFT_2009 SWIFT_2009.erl Contains rules to validate SWIFT


2009 MT and MX messages.

SWIFT_2010 SWIFT_2010.erl Contains rules to validate SWIFT


2010 MT and MX messages.

SWIFT_IOA001_2005 SWIFT_IOA001_2005.erl Contains rules to validate 2005


Market Practice U.S. MT536

SWIFT_IOA001_2006 SWIFT_IOA001_2006.erl Contains rules to validate 2006


Market Practice U.S. MT536

SWIFT_IOA001_2007 SWIFT_IOA001_2007.erl Contains rules to validate 2007


Market Practice U.S. MT536

SWIFT_IOA001_2008 SWIFT_IOA001_2008.erl Contains rules to validate 2008


Market Practice U.S. MT536

SWIFT_DeenvelopeLib_2008 SWIFT_DeenvelopeLib_2008.erl Contains rules to deenvelope 2008


SWIFT messages.

Sterling Commerce, Inc. 129


Creating SWIFT Maps

Library ERL File Name Description

SWIFTMX SWIFTMX_v1-0.erl (generic rule Contains rules to validate MX


library for MX) messages.

SWIFTMX_BulkPayments_v2-0 SWIFTMX_BulkPayments_v2-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_CashManagement_v4-0 SWIFTMX_CashManagement_v4-0. Contains rules to validate SWIFT


erl Cash Management 4.0 messages.

SWIFTMX_CashReporting_v1-0 SWIFTMX_CashReporting_v1-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_CashReporting_v3-0 SWIFTMX_CashReporting_v3-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_CashReporting_v3-1 SWIFTMX_CashReporting_v3-1.erl Contains rules to validate SWIFT


Cash Reporting 3.1 messages.

SWIFTMX_CashReporting_v3-2 SWIFTMX_CashReporting_v3-2.erl Contains rules to validate SWIFT


Cash Reporting 3.2 messages.

SWIFTMX_CashReporting_v4-0 SWIFTMX_CashReporting_v4-0.erl Contains rules to validate SWIFT


Cash Reporting 4.0 messages.

SWIFTMX_CashReporting_v5-0 SWIFTMX_CashReporting_v5-0.erl Contains rules to validate SWIFT


Cash Reporting 5.0 messages.

SWIFTMX_EI_v1-0 SWIFTMX_EI_v1-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_EI_v1-1 SWIFTMX_EI_v1-1.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_EI_v1-2 SWIFTMX_EI_v1-2.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_e-Mandate_v1-0 SWIFTMX_e-Mandate_v1-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_FpML_v1-0 SWIFTMX_FpML_v1-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

Sterling Commerce, Inc. 130


Creating SWIFT Maps

Library ERL File Name Description

SWIFTMX_Funds_v2-0 SWIFTMX_Funds_v2-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_Funds_v2-1 SWIFTMX_Funds_v2-1.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_Funds_v2-2 SWIFTMX_Funds_v2-2.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_Funds_v3-0 SWIFTMX_Funds_v3-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_Funds_v3-1 SWIFTMX_Funds_v3-1.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_Funds_v4-0 SWIFTMX_Funds_v4-0.erl Contains rules to validate SWIFT


Funds 4.0 messages.

SWIFTMX_Funds_v4-1 SWIFTMX_Funds_v4-1.erl Contains rules to validate SWIFT


Funds 4.1 messages.

SWIFTMX_Funds_v4-2 SWIFTMX_Funds_v4-2.erl Contains rules to validate SWIFTNet


Alternative Funds 4.2 messages.

SWIFTMX_ProxyVoting_v1-0 SWIFTMX_ProxyVoting_v1-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_ProxyVoting_v1-1 SWIFTMX_ProxyVoting_v1-1.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_ProxyVoting_v1-2 SWIFTMX_ProxyVoting_v1-2.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_TradeServices_v1-0 SWIFTMX_TradeServices_v1-0.erl This rule library contains no rules, but


you can implement and store rules
for the SWIFTSolution indicated in
the library.

SWIFTMX_TransactionReporting_v1 SWIFTMX_TransactionReporting_v1 Contains rules to validate SWIFT


-0 -0.erl Transaction Report 1.0 messages.

Sterling Commerce, Inc. 131


Creating SWIFT Maps

Calling a Rule from an Extended Rule Library in a Map


You can call a rule from any extended rule library (that is currently checked in to the application) in any
extended rule in your map. The syntax you use to call a rule from a library is:
call library_name.rule_name(parameter1, parameter2, parameter3)
In this syntax, library_name is the name of the extended rule library. For example, if the library is
SWIFT_2006.erl, the library_name is SWIFT. The rule_name is the name of the rule that you defined in
the Library Rule dialog box. There is no limit on the number of parameters you can use.
Note: You can have multiple rule libraries with the same name and different version numbers, but you can
only use one rule library of the same name in a map (the last version of that rule library that was
checked in to the system).
The syntax you use to call a rule with a return value set is:
integer i;
i = call library_name.rule_name parameter1

In this syntax, i is the return value set.

Truncating Number Fields When Converting Strings to Numbers


By default, the translator trims all trailing zeros from output values. For example, 80000.0100 will be output
as 8000.01. This behavior is not desirable for financial standards such as SWIFT, for which trailing zeros
represent a specific amount for a particular currency.
Therefore, the storage.keepTrailingZeros property in the translator.properties file enables you to specify
whether or not trailing zeros are kept on any numeric field on the output side of the map (numeric fields that
have been converted to strings).
By default trailing zeros are trimmed (storage.keepTrailingZeros=false). If you set this property to True, this
will preserve trailing zeroes. Therefore, by default the value 3.142000 is truncated to 3.142, but if you set
the storage.keepTrailingZeros property to True, the resulting string value is 3.142000.
To set the storage.keepTrailingZeros property to True:
1. In the install_dir/properties directory, locate (or create, if necessary) the
customer_overrides.properties file.
2. Open the customer_overrides.properties file in a text editor.
3. Add the property that you want to override, using the following format:
translator.storage.keepTrailingZeros=True
4. Save and close the customer_overrides.properties file.
5. Restart the application to use the new values.

Using Big Decimal (BigDecimal)


The application allows you to use either Java double primitive or BigDecimal data types for real numbers.
BigDecimal can be used regardless of the standard you are using, but if you are using a financial standard
like SWIFT we highly recommend that you use BigDecimal. See Big Decimal (BigDecimal) Support for

Sterling Commerce, Inc. 132


Creating SWIFT Maps

Real Numbers for more information on using this functionality. When processing SWIFT messages with
BigDecimal mode turned off, real values (such as amounts) may be rounded when those messages are
processed through the SWIFT Message Editor. When rounding occurs, the changed values are not reported.
If you are using BigDecimal mode on a per map basis for the SWIFT standard, you also need to enable
BigDecimal (turn it on) for any validation pass-through maps you are using. It is also possible to use double
primitive mode by default, but to enable BigDecimal mode on a per-map basis. Validation pass-through
maps should have BigDecimal mode enabled (turned on).
The validation pass-through maps used with Application are as follows:
MT Maps
✦ SWIFT_2002_100.mxl
✦ SWIFT_2005_097.mxl
✦ SWIFT_2005_101.mxl
✦ SWIFT_2005_102.mxl
✦ SWIFT_2005_102_STP.mxl
✦ SWIFT_2005_103.mxl
✦ SWIFT_2005_103_STP.mxl
✦ SWIFT_2005_104.mxl
✦ SWIFT_2005_105.mxl
✦ SWIFT_2005_106.mxl
✦ SWIFT_2005_107.mxl
✦ SWIFT_2005_110.mxl
✦ SWIFT_2005_111.mxl
✦ SWIFT_2005_112.mxl
✦ SWIFT_2005_190.mxl
✦ SWIFT_2005_191.mxl
✦ SWIFT_2005_192.mxl
✦ SWIFT_2005_195.mxl
✦ SWIFT_2005_196.mxl
✦ SWIFT_2005_198.mxl
✦ SWIFT_2005_199.mxl
✦ SWIFT_2005_200.mxl
✦ SWIFT_2005_201.mxl
✦ SWIFT_2005_202.mxl
✦ SWIFT_2005_203.mxl
✦ SWIFT_2005_204.mxl
✦ SWIFT_2005_205.mxl
✦ SWIFT_2005_206.mxl

Sterling Commerce, Inc. 133


Creating SWIFT Maps

✦ SWIFT_2005_207.mxl
✦ SWIFT_2005_210.mxl
✦ SWIFT_2005_256.mxl
✦ SWIFT_2005_290.mxl
✦ SWIFT_2005_291.mxl
✦ SWIFT_2005_292.mxl
✦ SWIFT_2005_295.mxl
✦ SWIFT_2005_296.mxl
✦ SWIFT_2005_298.mxl
✦ SWIFT_2005_299.mxl
✦ SWIFT_2005_300.mxl
✦ SWIFT_2005_303.mxl
✦ SWIFT_2005_304.mxl
✦ SWIFT_2005_305.mxl
✦ SWIFT_2005_306.mxl
✦ SWIFT_2005_307.mxl
✦ SWIFT_2005_308.mxl
✦ SWIFT_2005_320.mxl
✦ SWIFT_2005_321.mxl
✦ SWIFT_2005_330.mxl
✦ SWIFT_2005_340.mxl
✦ SWIFT_2005_341.mxl
✦ SWIFT_2005_350.mxl
✦ SWIFT_2005_360.mxl
✦ SWIFT_2005_361.mxl
✦ SWIFT_2005_362.mxl
✦ SWIFT_2005_364.mxl
✦ SWIFT_2005_365.mxl
✦ SWIFT_2005_380.mxl
✦ SWIFT_2005_381.mxl
✦ SWIFT_2005_390.mxl
✦ SWIFT_2005_391.mxl
✦ SWIFT_2005_392.mxl
✦ SWIFT_2005_395.mxl
✦ SWIFT_2005_396.mxl
✦ SWIFT_2005_398.mxl

Sterling Commerce, Inc. 134


Creating SWIFT Maps

✦ SWIFT_2005_399.mxl
✦ SWIFT_2005_400.mxl
✦ SWIFT_2005_405.mxl
✦ SWIFT_2005_410.mxl
✦ SWIFT_2005_412.mxl
✦ SWIFT_2005_416.mxl
✦ SWIFT_2005_420.mxl
✦ SWIFT_2005_422.mxl
✦ SWIFT_2005_430.mxl
✦ SWIFT_2005_450.mxl
✦ SWIFT_2005_455.mxl
✦ SWIFT_2005_456.mxl
✦ SWIFT_2005_490.mxl
✦ SWIFT_2005_491.mxl
✦ SWIFT_2005_492.mxl
✦ SWIFT_2005_495.mxl
✦ SWIFT_2005_496.mxl
✦ SWIFT_2005_498.mxl
✦ SWIFT_2005_499.mxl
✦ SWIFT_2005_500.mxl
✦ SWIFT_2005_501.mxl
✦ SWIFT_2005_502.mxl
✦ SWIFT_2005_503.mxl
✦ SWIFT_2005_504.mxl
✦ SWIFT_2005_505.mxl
✦ SWIFT_2005_506.mxl
✦ SWIFT_2005_507.mxl
✦ SWIFT_2005_508.mxl
✦ SWIFT_2005_509.mxl
✦ SWIFT_2005_510.mxl
✦ SWIFT_2005_513.mxl
✦ SWIFT_2005_514.mxl
✦ SWIFT_2005_515.mxl
✦ SWIFT_2005_515_SMPG02.mxl
✦ SWIFT_2005_516.mxl
✦ SWIFT_2005_517.mxl

Sterling Commerce, Inc. 135


Creating SWIFT Maps

✦ SWIFT_2005_518.mxl
✦ SWIFT_2005_519.mxl
✦ SWIFT_2005_524.mxl
✦ SWIFT_2005_526.mxl
✦ SWIFT_2005_527.mxl
✦ SWIFT_2005_528.mxl
✦ SWIFT_2005_529.mxl
✦ SWIFT_2005_535.mxl
✦ SWIFT_2005_536_IOA001.mxl
✦ SWIFT_2005_536.mxl
✦ SWIFT_2005_537.mxl
✦ SWIFT_2005_538.mxl
✦ SWIFT_2005_540.mxl
✦ SWIFT_2005_541.mxl
✦ SWIFT_2005_542.mxl
✦ SWIFT_2005_543.mxl
✦ SWIFT_2005_544.mxl
✦ SWIFT_2005_545.mxl
✦ SWIFT_2005_546.mxl
✦ SWIFT_2005_547.mxl
✦ SWIFT_2005_548.mxl
✦ SWIFT_2005_549.mxl
✦ SWIFT_2005_558.mxl
✦ SWIFT_2005_559.mxl
✦ SWIFT_2005_564.mxl
✦ SWIFT_2005_565.mxl
✦ SWIFT_2005_566.mxl
✦ SWIFT_2005_567.mxl
✦ SWIFT_2005_568.mxl
✦ SWIFT_2005_569.mxl
✦ SWIFT_2005_574_IRSLST.mxl
✦ SWIFT_2005_574.mxl
✦ SWIFT_2005_574_W8BENO.mxl
✦ SWIFT_2005_575.mxl
✦ SWIFT_2005_576.mxl
✦ SWIFT_2005_577.mxl

Sterling Commerce, Inc. 136


Creating SWIFT Maps

✦ SWIFT_2005_578.mxl
✦ SWIFT_2005_579.mxl
✦ SWIFT_2005_581.mxl
✦ SWIFT_2005_582.mxl
✦ SWIFT_2005_584.mxl
✦ SWIFT_2005_586.mxl
✦ SWIFT_2005_587.mxl
✦ SWIFT_2005_588.mxl
✦ SWIFT_2005_589.mxl
✦ SWIFT_2005_590.mxl
✦ SWIFT_2005_591.mxl
✦ SWIFT_2005_592.mxl
✦ SWIFT_2005_595.mxl
✦ SWIFT_2005_596.mxl
✦ SWIFT_2005_598.mxl
✦ SWIFT_2005_599.mxl
✦ SWIFT_2005_600.mxl
✦ SWIFT_2005_601.mxl
✦ SWIFT_2005_604.mxl
✦ SWIFT_2005_605.mxl
✦ SWIFT_2005_606.mxl
✦ SWIFT_2005_607.mxl
✦ SWIFT_2005_608.mxl
✦ SWIFT_2005_609.mxl
✦ SWIFT_2005_643.mxl
✦ SWIFT_2005_644.mxl
✦ SWIFT_2005_645.mxl
✦ SWIFT_2005_646.mxl
✦ SWIFT_2005_649.mxl
✦ SWIFT_2005_690.mxl
✦ SWIFT_2005_691.mxl
✦ SWIFT_2005_692.mxl
✦ SWIFT_2005_695.mxl
✦ SWIFT_2005_696.mxl
✦ SWIFT_2005_698.mxl
✦ SWIFT_2005_699.mxl

Sterling Commerce, Inc. 137


Creating SWIFT Maps

✦ SWIFT_2005_700.mxl
✦ SWIFT_2005_701.mxl
✦ SWIFT_2005_705.mxl
✦ SWIFT_2005_707.mxl
✦ SWIFT_2005_710.mxl
✦ SWIFT_2005_711.mxl
✦ SWIFT_2005_720.mxl
✦ SWIFT_2005_721.mxl
✦ SWIFT_2005_730.mxl
✦ SWIFT_2005_732.mxl
✦ SWIFT_2005_734.mxl
✦ SWIFT_2005_740.mxl
✦ SWIFT_2005_742.mxl
✦ SWIFT_2005_747.mxl
✦ SWIFT_2005_750.mxl
✦ SWIFT_2005_752.mxl
✦ SWIFT_2005_754.mxl
✦ SWIFT_2005_756.mxl
✦ SWIFT_2005_760.mxl
✦ SWIFT_2005_767.mxl
✦ SWIFT_2005_768.mxl
✦ SWIFT_2005_769.mxl
✦ SWIFT_2005_790.mxl
✦ SWIFT_2005_791.mxl
✦ SWIFT_2005_792.mxl
✦ SWIFT_2005_795.mxl
✦ SWIFT_2005_796.mxl
✦ SWIFT_2005_798.mxl
✦ SWIFT_2005_799.mxl
✦ SWIFT_2005_800.mxl
✦ SWIFT_2005_801.mxl
✦ SWIFT_2005_802.mxl
✦ SWIFT_2005_810.mxl
✦ SWIFT_2005_812.mxl
✦ SWIFT_2005_813.mxl
✦ SWIFT_2005_820.mxl

Sterling Commerce, Inc. 138


Creating SWIFT Maps

✦ SWIFT_2005_821.mxl
✦ SWIFT_2005_822.mxl
✦ SWIFT_2005_823.mxl
✦ SWIFT_2005_824.mxl
✦ SWIFT_2005_890.mxl
✦ SWIFT_2005_891.mxl
✦ SWIFT_2005_892.mxl
✦ SWIFT_2005_895.mxl
✦ SWIFT_2005_896.mxl
✦ SWIFT_2005_898.mxl
✦ SWIFT_2005_899.mxl
✦ SWIFT_2005_900.mxl
✦ SWIFT_2005_910.mxl
✦ SWIFT_2005_920.mxl
✦ SWIFT_2005_935.mxl
✦ SWIFT_2005_940.mxl
✦ SWIFT_2005_941.mxl
✦ SWIFT_2005_942.mxl
✦ SWIFT_2005_950.mxl
✦ SWIFT_2005_960.mxl
✦ SWIFT_2005_961.mxl
✦ SWIFT_2005_962.mxl
✦ SWIFT_2005_963.mxl
✦ SWIFT_2005_964.mxl
✦ SWIFT_2005_965.mxl
✦ SWIFT_2005_966.mxl
✦ SWIFT_2005_967.mxl
✦ SWIFT_2005_970.mxl
✦ SWIFT_2005_971.mxl
✦ SWIFT_2005_972.mxl
✦ SWIFT_2005_973.mxl
✦ SWIFT_2005_985.mxl
✦ SWIFT_2005_986.mxl
✦ SWIFT_2005_990.mxl
✦ SWIFT_2005_991.mxl
✦ SWIFT_2005_992.mxl

Sterling Commerce, Inc. 139


Creating SWIFT Maps

✦ SWIFT_2005_995.mxl
✦ SWIFT_2005_996.mxl
✦ SWIFT_2005_998.mxl
✦ SWIFT_2005_999.mxl
✦ SWIFT_2006_097.mxl
✦ SWIFT_2006_101.mxl
✦ SWIFT_2006_102.mxl
✦ SWIFT_2006_102_STP.mxl
✦ SWIFT_2006_103.mxl
✦ SWIFT_2006_103_STP.mxl
✦ SWIFT_2006_104.mxl
✦ SWIFT_2006_105.mxl
✦ SWIFT_2006_106.mxl
✦ SWIFT_2006_107.mxl
✦ SWIFT_2006_110.mxl
✦ SWIFT_2006_111.mxl
✦ SWIFT_2006_112.mxl
✦ SWIFT_2006_190.mxl
✦ SWIFT_2006_191.mxl
✦ SWIFT_2006_192.mxl
✦ SWIFT_2006_195.mxl
✦ SWIFT_2006_196.mxl
✦ SWIFT_2006_198.mxl
✦ SWIFT_2006_199.mxl
✦ SWIFT_2006_200.mxl
✦ SWIFT_2006_201.mxl
✦ SWIFT_2006_202.mxl
✦ SWIFT_2006_203.mxl
✦ SWIFT_2006_204.mxl
✦ SWIFT_2006_205.mxl
✦ SWIFT_2006_206.mxl
✦ SWIFT_2006_207.mxl
✦ SWIFT_2006_210.mxl
✦ SWIFT_2006_256.mxl
✦ SWIFT_2006_290.mxl
✦ SWIFT_2006_291.mxl

Sterling Commerce, Inc. 140


Creating SWIFT Maps

✦ SWIFT_2006_292.mxl
✦ SWIFT_2006_295.mxl
✦ SWIFT_2006_296.mxl
✦ SWIFT_2006_298.mxl
✦ SWIFT_2006_299.mxl
✦ SWIFT_2006_300.mxl
✦ SWIFT_2006_303.mxl
✦ SWIFT_2006_304.mxl
✦ SWIFT_2006_305.mxl
✦ SWIFT_2006_306.mxl
✦ SWIFT_2006_307.mxl
✦ SWIFT_2006_308.mxl
✦ SWIFT_2006_320.mxl
✦ SWIFT_2006_321.mxl
✦ SWIFT_2006_330.mxl
✦ SWIFT_2006_340.mxl
✦ SWIFT_2006_341.mxl
✦ SWIFT_2006_350.mxl
✦ SWIFT_2006_360.mxl
✦ SWIFT_2006_361.mxl
✦ SWIFT_2006_362.mxl
✦ SWIFT_2006_364.mxl
✦ SWIFT_2006_365.mxl
✦ SWIFT_2006_380.mxl
✦ SWIFT_2006_381.mxl
✦ SWIFT_2006_390.mxl
✦ SWIFT_2006_391.mxl
✦ SWIFT_2006_392.mxl
✦ SWIFT_2006_395.mxl
✦ SWIFT_2006_396.mxl
✦ SWIFT_2006_398.mxl
✦ SWIFT_2006_399.mxl
✦ SWIFT_2006_400.mxl
✦ SWIFT_2006_405.mxl
✦ SWIFT_2006_410.mxl
✦ SWIFT_2006_412.mxl

Sterling Commerce, Inc. 141


Creating SWIFT Maps

✦ SWIFT_2006_416.mxl
✦ SWIFT_2006_420.mxl
✦ SWIFT_2006_422.mxl
✦ SWIFT_2006_430.mxl
✦ SWIFT_2006_450.mxl
✦ SWIFT_2006_455.mxl
✦ SWIFT_2006_456.mxl
✦ SWIFT_2006_490.mxl
✦ SWIFT_2006_491.mxl
✦ SWIFT_2006_492.mxl
✦ SWIFT_2006_495.mxl
✦ SWIFT_2006_496.mxl
✦ SWIFT_2006_498.mxl
✦ SWIFT_2006_499.mxl
✦ SWIFT_2006_500.mxl
✦ SWIFT_2006_501.mxl
✦ SWIFT_2006_502.mxl
✦ SWIFT_2006_503.mxl
✦ SWIFT_2006_504.mxl
✦ SWIFT_2006_505.mxl
✦ SWIFT_2006_506.mxl
✦ SWIFT_2006_507.mxl
✦ SWIFT_2006_508.mxl
✦ SWIFT_2006_509.mxl
✦ SWIFT_2006_510.mxl
✦ SWIFT_2006_513.mxl
✦ SWIFT_2006_514.mxl
✦ SWIFT_2006_515.mxl
✦ SWIFT_2006_515_SMPG02.mxl
✦ SWIFT_2006_516.mxl
✦ SWIFT_2006_517.mxl
✦ SWIFT_2006_518.mxl
✦ SWIFT_2006_519.mxl
✦ SWIFT_2006_524.mxl
✦ SWIFT_2006_526.mxl
✦ SWIFT_2006_527.mxl

Sterling Commerce, Inc. 142


Creating SWIFT Maps

✦ SWIFT_2006_528.mxl
✦ SWIFT_2006_529.mxl
✦ SWIFT_2006_535.mxl
✦ SWIFT_2006_536_IOA001.mxl
✦ SWIFT_2006_536.mxl
✦ SWIFT_2006_537.mxl
✦ SWIFT_2006_538.mxl
✦ SWIFT_2006_540.mxl
✦ SWIFT_2006_541.mxl
✦ SWIFT_2006_542.mxl
✦ SWIFT_2006_543.mxl
✦ SWIFT_2006_544.mxl
✦ SWIFT_2006_545.mxl
✦ SWIFT_2006_546.mxl
✦ SWIFT_2006_547.mxl
✦ SWIFT_2006_548.mxl
✦ SWIFT_2006_549.mxl
✦ SWIFT_2006_558.mxl
✦ SWIFT_2006_559.mxl
✦ SWIFT_2006_564.mxl
✦ SWIFT_2006_565.mxl
✦ SWIFT_2006_566.mxl
✦ SWIFT_2006_567.mxl
✦ SWIFT_2006_568.mxl
✦ SWIFT_2006_569.mxl
✦ SWIFT_2006_574_IRSLST.mxl
✦ SWIFT_2006_574.mxl
✦ SWIFT_2006_574_W8BENO.mxl
✦ SWIFT_2006_575.mxl
✦ SWIFT_2006_576.mxl
✦ SWIFT_2006_577.mxl
✦ SWIFT_2006_578.mxl
✦ SWIFT_2006_579.mxl
✦ SWIFT_2006_581.mxl
✦ SWIFT_2006_582.mxl
✦ SWIFT_2006_584.mxl

Sterling Commerce, Inc. 143


Creating SWIFT Maps

✦ SWIFT_2006_586.mxl
✦ SWIFT_2006_587.mxl
✦ SWIFT_2006_588.mxl
✦ SWIFT_2006_589.mxl
✦ SWIFT_2006_590.mxl
✦ SWIFT_2006_591.mxl
✦ SWIFT_2006_592.mxl
✦ SWIFT_2006_595.mxl
✦ SWIFT_2006_596.mxl
✦ SWIFT_2006_598.mxl
✦ SWIFT_2006_599.mxl
✦ SWIFT_2006_600.mxl
✦ SWIFT_2006_601.mxl
✦ SWIFT_2006_604.mxl
✦ SWIFT_2006_605.mxl
✦ SWIFT_2006_606.mxl
✦ SWIFT_2006_607.mxl
✦ SWIFT_2006_608.mxl
✦ SWIFT_2006_609.mxl
✦ SWIFT_2006_643.mxl
✦ SWIFT_2006_644.mxl
✦ SWIFT_2006_645.mxl
✦ SWIFT_2006_646.mxl
✦ SWIFT_2006_649.mxl
✦ SWIFT_2006_690.mxl
✦ SWIFT_2006_691.mxl
✦ SWIFT_2006_692.mxl
✦ SWIFT_2006_695.mxl
✦ SWIFT_2006_696.mxl
✦ SWIFT_2006_698.mxl
✦ SWIFT_2006_699.mxl
✦ SWIFT_2006_700.mxl
✦ SWIFT_2006_701.mxl
✦ SWIFT_2006_705.mxl
✦ SWIFT_2006_707.mxl
✦ SWIFT_2006_710.mxl

Sterling Commerce, Inc. 144


Creating SWIFT Maps

✦ SWIFT_2006_711.mxl
✦ SWIFT_2006_720.mxl
✦ SWIFT_2006_721.mxl
✦ SWIFT_2006_730.mxl
✦ SWIFT_2006_732.mxl
✦ SWIFT_2006_734.mxl
✦ SWIFT_2006_740.mxl
✦ SWIFT_2006_742.mxl
✦ SWIFT_2006_747.mxl
✦ SWIFT_2006_750.mxl
✦ SWIFT_2006_752.mxl
✦ SWIFT_2006_754.mxl
✦ SWIFT_2006_756.mxl
✦ SWIFT_2006_760.mxl
✦ SWIFT_2006_767.mxl
✦ SWIFT_2006_768.mxl
✦ SWIFT_2006_769.mxl
✦ SWIFT_2006_790.mxl
✦ SWIFT_2006_791.mxl
✦ SWIFT_2006_792.mxl
✦ SWIFT_2006_795.mxl
✦ SWIFT_2006_796.mxl
✦ SWIFT_2006_798.mxl
✦ SWIFT_2006_799.mxl
✦ SWIFT_2006_800.mxl
✦ SWIFT_2006_801.mxl
✦ SWIFT_2006_802.mxl
✦ SWIFT_2006_810.mxl
✦ SWIFT_2006_812.mxl
✦ SWIFT_2006_813.mxl
✦ SWIFT_2006_820.mxl
✦ SWIFT_2006_821.mxl
✦ SWIFT_2006_822.mxl
✦ SWIFT_2006_823.mxl
✦ SWIFT_2006_824.mxl
✦ SWIFT_2006_890.mxl

Sterling Commerce, Inc. 145


Creating SWIFT Maps

✦ SWIFT_2006_891.mxl
✦ SWIFT_2006_892.mxl
✦ SWIFT_2006_895.mxl
✦ SWIFT_2006_896.mxl
✦ SWIFT_2006_898.mxl
✦ SWIFT_2006_899.mxl
✦ SWIFT_2006_900.mxl
✦ SWIFT_2006_910.mxl
✦ SWIFT_2006_920.mxl
✦ SWIFT_2006_935.mxl
✦ SWIFT_2006_940.mxl
✦ SWIFT_2006_941.mxl
✦ SWIFT_2006_942.mxl
✦ SWIFT_2006_950.mxl
✦ SWIFT_2006_960.mxl
✦ SWIFT_2006_961.mxl
✦ SWIFT_2006_962.mxl
✦ SWIFT_2006_963.mxl
✦ SWIFT_2006_964.mxl
✦ SWIFT_2006_965.mxl
✦ SWIFT_2006_966.mxl
✦ SWIFT_2006_967.mxl
✦ SWIFT_2006_970.mxl
✦ SWIFT_2006_971.mxl
✦ SWIFT_2006_972.mxl
✦ SWIFT_2006_973.mxl
✦ SWIFT_2006_985.mxl
✦ SWIFT_2006_986.mxl
✦ SWIFT_2006_990.mxl
✦ SWIFT_2006_991.mxl
✦ SWIFT_2006_992.mxl
✦ SWIFT_2006_995.mxl
✦ SWIFT_2006_996.mxl
✦ SWIFT_2006_998.mxl
✦ SWIFT_2006_999.mxl
✦ SWIFT_2007_097.mxl

Sterling Commerce, Inc. 146


Creating SWIFT Maps

✦ SWIFT_2007_101.mxl
✦ SWIFT_2007_102.mxl
✦ SWIFT_2007_102_STP.mxl
✦ SWIFT_2007_103.mxl
✦ SWIFT_2007_103_STP.mxl
✦ SWIFT_2007_104.mxl
✦ SWIFT_2007_105.mxl
✦ SWIFT_2007_106.mxl
✦ SWIFT_2007_107.mxl
✦ SWIFT_2007_110.mxl
✦ SWIFT_2007_111.mxl
✦ SWIFT_2007_112.mxl
✦ SWIFT_2007_190.mxl
✦ SWIFT_2007_191.mxl
✦ SWIFT_2007_192.mxl
✦ SWIFT_2007_195.mxl
✦ SWIFT_2007_196.mxl
✦ SWIFT_2007_198.mxl
✦ SWIFT_2007_199.mxl
✦ SWIFT_2007_200.mxl
✦ SWIFT_2007_201.mxl
✦ SWIFT_2007_202.mxl
✦ SWIFT_2007_203.mxl
✦ SWIFT_2007_204.mxl
✦ SWIFT_2007_205.mxl
✦ SWIFT_2007_206.mxl
✦ SWIFT_2007_207.mxl
✦ SWIFT_2007_210.mxl
✦ SWIFT_2007_256.mxl
✦ SWIFT_2007_290.mxl
✦ SWIFT_2007_291.mxl
✦ SWIFT_2007_292.mxl
✦ SWIFT_2007_295.mxl
✦ SWIFT_2007_296.mxl
✦ SWIFT_2007_298.mxl
✦ SWIFT_2007_299.mxl

Sterling Commerce, Inc. 147


Creating SWIFT Maps

✦ SWIFT_2007_300.mxl
✦ SWIFT_2007_303.mxl
✦ SWIFT_2007_304.mxl
✦ SWIFT_2007_305.mxl
✦ SWIFT_2007_306.mxl
✦ SWIFT_2007_307.mxl
✦ SWIFT_2007_308.mxl
✦ SWIFT_2007_320.mxl
✦ SWIFT_2007_321.mxl
✦ SWIFT_2007_330.mxl
✦ SWIFT_2007_340.mxl
✦ SWIFT_2007_341.mxl
✦ SWIFT_2007_350.mxl
✦ SWIFT_2007_360.mxl
✦ SWIFT_2007_361.mxl
✦ SWIFT_2007_362.mxl
✦ SWIFT_2007_364.mxl
✦ SWIFT_2007_365.mxl
✦ SWIFT_2007_380.mxl
✦ SWIFT_2007_381.mxl
✦ SWIFT_2007_390.mxl
✦ SWIFT_2007_391.mxl
✦ SWIFT_2007_392.mxl
✦ SWIFT_2007_395.mxl
✦ SWIFT_2007_396.mxl
✦ SWIFT_2007_398.mxl
✦ SWIFT_2007_399.mxl
✦ SWIFT_2007_400.mxl
✦ SWIFT_2007_405.mxl
✦ SWIFT_2007_410.mxl
✦ SWIFT_2007_412.mxl
✦ SWIFT_2007_416.mxl
✦ SWIFT_2007_420.mxl
✦ SWIFT_2007_422.mxl
✦ SWIFT_2007_430.mxl
✦ SWIFT_2007_450.mxl

Sterling Commerce, Inc. 148


Creating SWIFT Maps

✦ SWIFT_2007_455.mxl
✦ SWIFT_2007_456.mxl
✦ SWIFT_2007_490.mxl
✦ SWIFT_2007_491.mxl
✦ SWIFT_2007_492.mxl
✦ SWIFT_2007_495.mxl
✦ SWIFT_2007_496.mxl
✦ SWIFT_2007_498.mxl
✦ SWIFT_2007_499.mxl
✦ SWIFT_2007_500.mxl
✦ SWIFT_2007_501.mxl
✦ SWIFT_2007_502.mxl
✦ SWIFT_2007_503.mxl
✦ SWIFT_2007_504.mxl
✦ SWIFT_2007_505.mxl
✦ SWIFT_2007_506.mxl
✦ SWIFT_2007_507.mxl
✦ SWIFT_2007_508.mxl
✦ SWIFT_2007_509.mxl
✦ SWIFT_2007_510.mxl
✦ SWIFT_2007_513.mxl
✦ SWIFT_2007_514.mxl
✦ SWIFT_2007_515.mxl
✦ SWIFT_2007_515_SMPG02.mxl
✦ SWIFT_2007_516.mxl
✦ SWIFT_2007_517.mxl
✦ SWIFT_2007_518.mxl
✦ SWIFT_2007_519.mxl
✦ SWIFT_2007_524.mxl
✦ SWIFT_2007_526.mxl
✦ SWIFT_2007_527.mxl
✦ SWIFT_2007_528.mxl
✦ SWIFT_2007_529.mxl
✦ SWIFT_2007_530.mxl
✦ SWIFT_2007_535.mxl
✦ SWIFT_2007_536_IOA001.mxl

Sterling Commerce, Inc. 149


Creating SWIFT Maps

✦ SWIFT_2007_536.mxl
✦ SWIFT_2007_537.mxl
✦ SWIFT_2007_538.mxl
✦ SWIFT_2007_540.mxl
✦ SWIFT_2007_541.mxl
✦ SWIFT_2007_542.mxl
✦ SWIFT_2007_543.mxl
✦ SWIFT_2007_544.mxl
✦ SWIFT_2007_545.mxl
✦ SWIFT_2007_546.mxl
✦ SWIFT_2007_547.mxl
✦ SWIFT_2007_548.mxl
✦ SWIFT_2007_549.mxl
✦ SWIFT_2007_558.mxl
✦ SWIFT_2007_559.mxl
✦ SWIFT_2007_564.mxl
✦ SWIFT_2007_565.mxl
✦ SWIFT_2007_566.mxl
✦ SWIFT_2007_567.mxl
✦ SWIFT_2007_568.mxl
✦ SWIFT_2007_569.mxl
✦ SWIFT_2007_574_IRSLST.mxl
✦ SWIFT_2007_574.mxl
✦ SWIFT_2007_574_W8BENO.mxl
✦ SWIFT_2007_575.mxl
✦ SWIFT_2007_576.mxl
✦ SWIFT_2007_577.mxl
✦ SWIFT_2007_578.mxl
✦ SWIFT_2007_579.mxl
✦ SWIFT_2007_581.mxl
✦ SWIFT_2007_582.mxl
✦ SWIFT_2007_584.mxl
✦ SWIFT_2007_586.mxl
✦ SWIFT_2007_587.mxl
✦ SWIFT_2007_588.mxl
✦ SWIFT_2007_589.mxl

Sterling Commerce, Inc. 150


Creating SWIFT Maps

✦ SWIFT_2007_590.mxl
✦ SWIFT_2007_591.mxl
✦ SWIFT_2007_592.mxl
✦ SWIFT_2007_595.mxl
✦ SWIFT_2007_596.mxl
✦ SWIFT_2007_598.mxl
✦ SWIFT_2007_599.mxl
✦ SWIFT_2007_600.mxl
✦ SWIFT_2007_601.mxl
✦ SWIFT_2007_604.mxl
✦ SWIFT_2007_605.mxl
✦ SWIFT_2007_606.mxl
✦ SWIFT_2007_607.mxl
✦ SWIFT_2007_608.mxl
✦ SWIFT_2007_609.mxl
✦ SWIFT_2007_643.mxl
✦ SWIFT_2007_644.mxl
✦ SWIFT_2007_645.mxl
✦ SWIFT_2007_646.mxl
✦ SWIFT_2007_649.mxl
✦ SWIFT_2007_690.mxl
✦ SWIFT_2007_691.mxl
✦ SWIFT_2007_692.mxl
✦ SWIFT_2007_695.mxl
✦ SWIFT_2007_696.mxl
✦ SWIFT_2007_698.mxl
✦ SWIFT_2007_699.mxl
✦ SWIFT_2007_700.mxl
✦ SWIFT_2007_701.mxl
✦ SWIFT_2007_705.mxl
✦ SWIFT_2007_707.mxl
✦ SWIFT_2007_710.mxl
✦ SWIFT_2007_711.mxl
✦ SWIFT_2007_720.mxl
✦ SWIFT_2007_721.mxl
✦ SWIFT_2007_730.mxl

Sterling Commerce, Inc. 151


Creating SWIFT Maps

✦ SWIFT_2007_732.mxl
✦ SWIFT_2007_734.mxl
✦ SWIFT_2007_740.mxl
✦ SWIFT_2007_742.mxl
✦ SWIFT_2007_747.mxl
✦ SWIFT_2007_750.mxl
✦ SWIFT_2007_752.mxl
✦ SWIFT_2007_754.mxl
✦ SWIFT_2007_756.mxl
✦ SWIFT_2007_760.mxl
✦ SWIFT_2007_767.mxl
✦ SWIFT_2007_768.mxl
✦ SWIFT_2007_769.mxl
✦ SWIFT_2007_790.mxl
✦ SWIFT_2007_791.mxl
✦ SWIFT_2007_792.mxl
✦ SWIFT_2007_795.mxl
✦ SWIFT_2007_796.mxl
✦ SWIFT_2007_798.mxl
✦ SWIFT_2007_799.mxl
✦ SWIFT_2007_800.mxl
✦ SWIFT_2007_801.mxl
✦ SWIFT_2007_802.mxl
✦ SWIFT_2007_810.mxl
✦ SWIFT_2007_812.mxl
✦ SWIFT_2007_813.mxl
✦ SWIFT_2007_820.mxl
✦ SWIFT_2007_821.mxl
✦ SWIFT_2007_822.mxl
✦ SWIFT_2007_823.mxl
✦ SWIFT_2007_824.mxl
✦ SWIFT_2007_890.mxl
✦ SWIFT_2007_891.mxl
✦ SWIFT_2007_892.mxl
✦ SWIFT_2007_895.mxl
✦ SWIFT_2007_896.mxl

Sterling Commerce, Inc. 152


Creating SWIFT Maps

✦ SWIFT_2007_898.mxl
✦ SWIFT_2007_899.mxl
✦ SWIFT_2007_900.mxl
✦ SWIFT_2007_910.mxl
✦ SWIFT_2007_920.mxl
✦ SWIFT_2007_935.mxl
✦ SWIFT_2007_940.mxl
✦ SWIFT_2007_941.mxl
✦ SWIFT_2007_942.mxl
✦ SWIFT_2007_950.mxl
✦ SWIFT_2007_960.mxl
✦ SWIFT_2007_961.mxl
✦ SWIFT_2007_962.mxl
✦ SWIFT_2007_963.mxl
✦ SWIFT_2007_964.mxl
✦ SWIFT_2007_965.mxl
✦ SWIFT_2007_966.mxl
✦ SWIFT_2007_967.mxl
✦ SWIFT_2007_970.mxl
✦ SWIFT_2007_971.mxl
✦ SWIFT_2007_972.mxl
✦ SWIFT_2007_973.mxl
✦ SWIFT_2007_985.mxl
✦ SWIFT_2007_986.mxl
✦ SWIFT_2007_990.mxl
✦ SWIFT_2007_991.mxl
✦ SWIFT_2007_992.mxl
✦ SWIFT_2007_995.mxl
✦ SWIFT_2007_996.mxl
✦ SWIFT_2007_998.mxl
✦ SWIFT_2007_999.mxl
✦ SWIFT_2008_097.mxl
✦ SWIFT_2008_101.mxl
✦ SWIFT_2008_102.mxl
✦ SWIFT_2008_102_STP.mxl
✦ SWIFT_2008_103.mxl

Sterling Commerce, Inc. 153


Creating SWIFT Maps

✦ SWIFT_2008_103_STP.mxl
✦ SWIFT_2008_104.mxl
✦ SWIFT_2008_105.mxl
✦ SWIFT_2008_106.mxl
✦ SWIFT_2008_107.mxl
✦ SWIFT_2008_110.mxl
✦ SWIFT_2008_111.mxl
✦ SWIFT_2008_112.mxl
✦ SWIFT_2008_190.mxl
✦ SWIFT_2008_191.mxl
✦ SWIFT_2008_192.mxl
✦ SWIFT_2008_195.mxl
✦ SWIFT_2008_196.mxl
✦ SWIFT_2008_198.mxl
✦ SWIFT_2008_199.mxl
✦ SWIFT_2008_200.mxl
✦ SWIFT_2008_201.mxl
✦ SWIFT_2008_202.mxl
✦ SWIFT_2008_203.mxl
✦ SWIFT_2008_204.mxl
✦ SWIFT_2008_205.mxl
✦ SWIFT_2008_206.mxl
✦ SWIFT_2008_207.mxl
✦ SWIFT_2008_210.mxl
✦ SWIFT_2008_256.mxl
✦ SWIFT_2008_290.mxl
✦ SWIFT_2008_291.mxl
✦ SWIFT_2008_292.mxl
✦ SWIFT_2008_295.mxl
✦ SWIFT_2008_296.mxl
✦ SWIFT_2008_298.mxl
✦ SWIFT_2008_299.mxl
✦ SWIFT_2008_300.mxl
✦ SWIFT_2008_303.mxl
✦ SWIFT_2008_304.mxl
✦ SWIFT_2008_305.mxl

Sterling Commerce, Inc. 154


Creating SWIFT Maps

✦ SWIFT_2008_306.mxl
✦ SWIFT_2008_307.mxl
✦ SWIFT_2008_308.mxl
✦ SWIFT_2008_320.mxl
✦ SWIFT_2008_321.mxl
✦ SWIFT_2008_330.mxl
✦ SWIFT_2008_340.mxl
✦ SWIFT_2008_341.mxl
✦ SWIFT_2008_350.mxl
✦ SWIFT_2008_360.mxl
✦ SWIFT_2008_361.mxl
✦ SWIFT_2008_362.mxl
✦ SWIFT_2008_364.mxl
✦ SWIFT_2008_365.mxl
✦ SWIFT_2008_380.mxl
✦ SWIFT_2008_381.mxl
✦ SWIFT_2008_390.mxl
✦ SWIFT_2008_391.mxl
✦ SWIFT_2008_392.mxl
✦ SWIFT_2008_395.mxl
✦ SWIFT_2008_396.mxl
✦ SWIFT_2008_398.mxl
✦ SWIFT_2008_399.mxl
✦ SWIFT_2008_400.mxl
✦ SWIFT_2008_405.mxl
✦ SWIFT_2008_410.mxl
✦ SWIFT_2008_412.mxl
✦ SWIFT_2008_416.mxl
✦ SWIFT_2008_420.mxl
✦ SWIFT_2008_422.mxl
✦ SWIFT_2008_430.mxl
✦ SWIFT_2008_450.mxl
✦ SWIFT_2008_455.mxl
✦ SWIFT_2008_456.mxl
✦ SWIFT_2008_490.mxl
✦ SWIFT_2008_491.mxl

Sterling Commerce, Inc. 155


Creating SWIFT Maps

✦ SWIFT_2008_492.mxl
✦ SWIFT_2008_495.mxl
✦ SWIFT_2008_496.mxl
✦ SWIFT_2008_498.mxl
✦ SWIFT_2008_499.mxl
✦ SWIFT_2008_500.mxl
✦ SWIFT_2008_501.mxl
✦ SWIFT_2008_502.mxl
✦ SWIFT_2008_503.mxl
✦ SWIFT_2008_504.mxl
✦ SWIFT_2008_505.mxl
✦ SWIFT_2008_506.mxl
✦ SWIFT_2008_507.mxl
✦ SWIFT_2008_508.mxl
✦ SWIFT_2008_509.mxl
✦ SWIFT_2008_510.mxl
✦ SWIFT_2008_513.mxl
✦ SWIFT_2008_514.mxl
✦ SWIFT_2008_515.mxl
✦ SWIFT_2008_515_SMPG02.mxl
✦ SWIFT_2008_516.mxl
✦ SWIFT_2008_517.mxl
✦ SWIFT_2008_518.mxl
✦ SWIFT_2008_519.mxl
✦ SWIFT_2008_524.mxl
✦ SWIFT_2008_526.mxl
✦ SWIFT_2008_527.mxl
✦ SWIFT_2008_528.mxl
✦ SWIFT_2008_529.mxl
✦ SWIFT_2008_530.mxl
✦ SWIFT_2008_535.mxl
✦ SWIFT_2008_536_IOA001.mxl
✦ SWIFT_2008_536.mxl
✦ SWIFT_2008_537.mxl
✦ SWIFT_2008_538.mxl
✦ SWIFT_2008_540.mxl

Sterling Commerce, Inc. 156


Creating SWIFT Maps

✦ SWIFT_2008_541.mxl
✦ SWIFT_2008_542.mxl
✦ SWIFT_2008_543.mxl
✦ SWIFT_2008_544.mxl
✦ SWIFT_2008_545.mxl
✦ SWIFT_2008_546.mxl
✦ SWIFT_2008_547.mxl
✦ SWIFT_2008_548.mxl
✦ SWIFT_2008_549.mxl
✦ SWIFT_2008_558.mxl
✦ SWIFT_2008_559.mxl
✦ SWIFT_2008_564.mxl
✦ SWIFT_2008_565.mxl
✦ SWIFT_2008_566.mxl
✦ SWIFT_2008_567.mxl
✦ SWIFT_2008_568.mxl
✦ SWIFT_2008_569.mxl
✦ SWIFT_2008_574_IRSLST.mxl
✦ SWIFT_2008_574_W8BENO.mxl
✦ SWIFT_2008_575.mxl
✦ SWIFT_2008_576.mxl
✦ SWIFT_2008_577.mxl
✦ SWIFT_2008_578.mxl
✦ SWIFT_2008_579.mxl
✦ SWIFT_2008_581.mxl
✦ SWIFT_2008_582.mxl
✦ SWIFT_2008_584.mxl
✦ SWIFT_2008_586.mxl
✦ SWIFT_2008_587.mxl
✦ SWIFT_2008_588.mxl
✦ SWIFT_2008_589.mxl
✦ SWIFT_2008_590.mxl
✦ SWIFT_2008_591.mxl
✦ SWIFT_2008_592.mxl
✦ SWIFT_2008_595.mxl
✦ SWIFT_2008_596.mxl

Sterling Commerce, Inc. 157


Creating SWIFT Maps

✦ SWIFT_2008_598.mxl
✦ SWIFT_2008_599.mxl
✦ SWIFT_2008_600.mxl
✦ SWIFT_2008_601.mxl
✦ SWIFT_2008_604.mxl
✦ SWIFT_2008_605.mxl
✦ SWIFT_2008_606.mxl
✦ SWIFT_2008_607.mxl
✦ SWIFT_2008_608.mxl
✦ SWIFT_2008_609.mxl
✦ SWIFT_2008_620.mxl
✦ SWIFT_2008_643.mxl
✦ SWIFT_2008_644.mxl
✦ SWIFT_2008_645.mxl
✦ SWIFT_2008_646.mxl
✦ SWIFT_2008_649.mxl
✦ SWIFT_2008_690.mxl
✦ SWIFT_2008_691.mxl
✦ SWIFT_2008_692.mxl
✦ SWIFT_2008_695.mxl
✦ SWIFT_2008_696.mxl
✦ SWIFT_2008_698.mxl
✦ SWIFT_2008_699.mxl
✦ SWIFT_2008_700.mxl
✦ SWIFT_2008_701.mxl
✦ SWIFT_2008_705.mxl
✦ SWIFT_2008_707.mxl
✦ SWIFT_2008_710.mxl
✦ SWIFT_2008_711.mxl
✦ SWIFT_2008_720.mxl
✦ SWIFT_2008_721.mxl
✦ SWIFT_2008_730.mxl
✦ SWIFT_2008_732.mxl
✦ SWIFT_2008_734.mxl
✦ SWIFT_2008_740.mxl
✦ SWIFT_2008_742.mxl

Sterling Commerce, Inc. 158


Creating SWIFT Maps

✦ SWIFT_2008_747.mxl
✦ SWIFT_2008_750.mxl
✦ SWIFT_2008_752.mxl
✦ SWIFT_2008_754.mxl
✦ SWIFT_2008_756.mxl
✦ SWIFT_2008_760.mxl
✦ SWIFT_2008_767.mxl
✦ SWIFT_2008_768.mxl
✦ SWIFT_2008_769.mxl
✦ SWIFT_2008_790.mxl
✦ SWIFT_2008_791.mxl
✦ SWIFT_2008_792.mxl
✦ SWIFT_2008_795.mxl
✦ SWIFT_2008_796.mxl
✦ SWIFT_2008_798.mxl
✦ SWIFT_2008_799.mxl
✦ SWIFT_2008_800.mxl
✦ SWIFT_2008_801.mxl
✦ SWIFT_2008_802.mxl
✦ SWIFT_2008_810.mxl
✦ SWIFT_2008_812.mxl
✦ SWIFT_2008_813.mxl
✦ SWIFT_2008_820.mxl
✦ SWIFT_2008_821.mxl
✦ SWIFT_2008_822.mxl
✦ SWIFT_2008_823.mxl
✦ SWIFT_2008_824.mxl
✦ SWIFT_2008_890.mxl
✦ SWIFT_2008_891.mxl
✦ SWIFT_2008_892.mxl
✦ SWIFT_2008_895.mxl
✦ SWIFT_2008_896.mxl
✦ SWIFT_2008_898.mxl
✦ SWIFT_2008_899.mxl
✦ SWIFT_2008_900.mxl
✦ SWIFT_2008_910.mxl

Sterling Commerce, Inc. 159


Creating SWIFT Maps

✦ SWIFT_2008_920.mxl
✦ SWIFT_2008_935.mxl
✦ SWIFT_2008_940.mxl
✦ SWIFT_2008_941.mxl
✦ SWIFT_2008_942.mxl
✦ SWIFT_2008_950.mxl
✦ SWIFT_2008_960.mxl
✦ SWIFT_2008_961.mxl
✦ SWIFT_2008_962.mxl
✦ SWIFT_2008_963.mxl
✦ SWIFT_2008_964.mxl
✦ SWIFT_2008_965.mxl
✦ SWIFT_2008_966.mxl
✦ SWIFT_2008_967.mxl
✦ SWIFT_2008_970.mxl
✦ SWIFT_2008_971.mxl
✦ SWIFT_2008_972.mxl
✦ SWIFT_2008_973.mxl
✦ SWIFT_2008_985.mxl
✦ SWIFT_2008_986.mxl
✦ SWIFT_2008_990.mxl
✦ SWIFT_2008_991.mxl
✦ SWIFT_2008_992.mxl
✦ SWIFT_2008_995.mxl
✦ SWIFT_2008_996.mxl
✦ SWIFT_2008_998.mxl
✦ SWIFT_2008_999.mxl
✦ SWIFT_2009_097.mxl
✦ SWIFT_2009_101.mxl
✦ SWIFT_2009_102.mxl
✦ SWIFT_2009_102_STP.mxl
✦ SWIFT_2009_103.mxl
✦ SWIFT_2009_103_STP.mxl
✦ SWIFT_2009_104.mxl
✦ SWIFT_2009_105.mxl
✦ SWIFT_2009_107.mxl

Sterling Commerce, Inc. 160


Creating SWIFT Maps

✦ SWIFT_2009_110.mxl
✦ SWIFT_2009_111.mxl
✦ SWIFT_2009_112.mxl
✦ SWIFT_2009_190.mxl
✦ SWIFT_2009_191.mxl
✦ SWIFT_2009_192.mxl
✦ SWIFT_2009_195.mxl
✦ SWIFT_2009_196.mxl
✦ SWIFT_2009_198.mxl
✦ SWIFT_2009_199.mxl
✦ SWIFT_2009_200.mxl
✦ SWIFT_2009_201.mxl
✦ SWIFT_2009_202.mxl
✦ SWIFT_2009_203.mxl
✦ SWIFT_2009_204.mxl
✦ SWIFT_2009_205.mxl
✦ SWIFT_2009_207.mxl
✦ SWIFT_2009_210.mxl
✦ SWIFT_2009_256.mxl
✦ SWIFT_2009_290.mxl
✦ SWIFT_2009_291.mxl
✦ SWIFT_2009_292.mxl
✦ SWIFT_2009_295.mxl
✦ SWIFT_2009_296.mxl
✦ SWIFT_2009_298.mxl
✦ SWIFT_2009_299.mxl
✦ SWIFT_2009_300.mxl
✦ SWIFT_2009_303.mxl
✦ SWIFT_2009_304.mxl
✦ SWIFT_2009_305.mxl
✦ SWIFT_2009_306.mxl
✦ SWIFT_2009_307.mxl
✦ SWIFT_2009_308.mxl
✦ SWIFT_2009_320.mxl
✦ SWIFT_2009_321.mxl
✦ SWIFT_2009_330.mxl

Sterling Commerce, Inc. 161


Creating SWIFT Maps

✦ SWIFT_2009_340.mxl
✦ SWIFT_2009_341.mxl
✦ SWIFT_2009_350.mxl
✦ SWIFT_2009_360.mxl
✦ SWIFT_2009_361.mxl
✦ SWIFT_2009_362.mxl
✦ SWIFT_2009_364.mxl
✦ SWIFT_2009_365.mxl
✦ SWIFT_2009_380.mxl
✦ SWIFT_2009_381.mxl
✦ SWIFT_2009_390.mxl
✦ SWIFT_2009_391.mxl
✦ SWIFT_2009_392.mxl
✦ SWIFT_2009_395.mxl
✦ SWIFT_2009_396.mxl
✦ SWIFT_2009_398.mxl
✦ SWIFT_2009_399.mxl
✦ SWIFT_2009_400.mxl
✦ SWIFT_2009_405.mxl
✦ SWIFT_2009_410.mxl
✦ SWIFT_2009_412.mxl
✦ SWIFT_2009_416.mxl
✦ SWIFT_2009_420.mxl
✦ SWIFT_2009_422.mxl
✦ SWIFT_2009_430.mxl
✦ SWIFT_2009_450.mxl
✦ SWIFT_2009_455.mxl
✦ SWIFT_2009_456.mxl
✦ SWIFT_2009_490.mxl
✦ SWIFT_2009_491.mxl
✦ SWIFT_2009_492.mxl
✦ SWIFT_2009_495.mxl
✦ SWIFT_2009_496.mxl
✦ SWIFT_2009_498.mxl
✦ SWIFT_2009_499.mxl
✦ SWIFT_2009_500.mxl

Sterling Commerce, Inc. 162


Creating SWIFT Maps

✦ SWIFT_2009_501.mxl
✦ SWIFT_2009_502.mxl
✦ SWIFT_2009_503.mxl
✦ SWIFT_2009_504.mxl
✦ SWIFT_2009_505.mxl
✦ SWIFT_2009_506.mxl
✦ SWIFT_2009_507.mxl
✦ SWIFT_2009_508.mxl
✦ SWIFT_2009_509.mxl
✦ SWIFT_2009_510.mxl
✦ SWIFT_2009_513.mxl
✦ SWIFT_2009_514.mxl
✦ SWIFT_2009_515.mxl
✦ SWIFT_2009_515_SMPG02.mxl
✦ SWIFT_2009_516.mxl
✦ SWIFT_2009_517.mxl
✦ SWIFT_2009_518.mxl
✦ SWIFT_2009_519.mxl
✦ SWIFT_2009_524.mxl
✦ SWIFT_2009_526.mxl
✦ SWIFT_2009_527.mxl
✦ SWIFT_2009_528.mxl
✦ SWIFT_2009_529.mxl
✦ SWIFT_2009_530.mxl
✦ SWIFT_2009_535.mxl
✦ SWIFT_2009_536_IOA001.mxl
✦ SWIFT_2009_536.mxl
✦ SWIFT_2009_537.mxl
✦ SWIFT_2009_538.mxl
✦ SWIFT_2009_540.mxl
✦ SWIFT_2009_541.mxl
✦ SWIFT_2009_542.mxl
✦ SWIFT_2009_543.mxl
✦ SWIFT_2009_544.mxl
✦ SWIFT_2009_545.mxl
✦ SWIFT_2009_546.mxl

Sterling Commerce, Inc. 163


Creating SWIFT Maps

✦ SWIFT_2009_547.mxl
✦ SWIFT_2009_548.mxl
✦ SWIFT_2009_549.mxl
✦ SWIFT_2009_558.mxl
✦ SWIFT_2009_559.mxl
✦ SWIFT_2009_564.mxl
✦ SWIFT_2009_565.mxl
✦ SWIFT_2009_566.mxl
✦ SWIFT_2009_567.mxl
✦ SWIFT_2009_568.mxl
✦ SWIFT_2009_569.mxl
✦ SWIFT_2009_574_IRSLST.mxl
✦ SWIFT_2009_574_W8BENO.mxl
✦ SWIFT_2009_575.mxl
✦ SWIFT_2009_576.mxl
✦ SWIFT_2009_577.mxl
✦ SWIFT_2009_578.mxl
✦ SWIFT_2009_579.mxl
✦ SWIFT_2009_581.mxl
✦ SWIFT_2009_582.mxl
✦ SWIFT_2009_584.mxl
✦ SWIFT_2009_586.mxl
✦ SWIFT_2009_587.mxl
✦ SWIFT_2009_588.mxl
✦ SWIFT_2009_589.mxl
✦ SWIFT_2009_590.mxl
✦ SWIFT_2009_591.mxl
✦ SWIFT_2009_592.mxl
✦ SWIFT_2009_595.mxl
✦ SWIFT_2009_596.mxl
✦ SWIFT_2009_598.mxl
✦ SWIFT_2009_599.mxl
✦ SWIFT_2009_600.mxl
✦ SWIFT_2009_601.mxl
✦ SWIFT_2009_604.mxl
✦ SWIFT_2009_605.mxl

Sterling Commerce, Inc. 164


Creating SWIFT Maps

✦ SWIFT_2009_606.mxl
✦ SWIFT_2009_607.mxl
✦ SWIFT_2009_608.mxl
✦ SWIFT_2009_609.mxl
✦ SWIFT_2009_620.mxl
✦ SWIFT_2009_643.mxl
✦ SWIFT_2009_644.mxl
✦ SWIFT_2009_645.mxl
✦ SWIFT_2009_646.mxl
✦ SWIFT_2009_649.mxl
✦ SWIFT_2009_690.mxl
✦ SWIFT_2009_691.mxl
✦ SWIFT_2009_692.mxl
✦ SWIFT_2009_695.mxl
✦ SWIFT_2009_696.mxl
✦ SWIFT_2009_698.mxl
✦ SWIFT_2009_699.mxl
✦ SWIFT_2009_700.mxl
✦ SWIFT_2009_701.mxl
✦ SWIFT_2009_705.mxl
✦ SWIFT_2009_707.mxl
✦ SWIFT_2009_710.mxl
✦ SWIFT_2009_711.mxl
✦ SWIFT_2009_720.mxl
✦ SWIFT_2009_721.mxl
✦ SWIFT_2009_730.mxl
✦ SWIFT_2009_732.mxl
✦ SWIFT_2009_734.mxl
✦ SWIFT_2009_740.mxl
✦ SWIFT_2009_742.mxl
✦ SWIFT_2009_747.mxl
✦ SWIFT_2009_750.mxl
✦ SWIFT_2009_752.mxl
✦ SWIFT_2009_754.mxl
✦ SWIFT_2009_756.mxl
✦ SWIFT_2009_760.mxl

Sterling Commerce, Inc. 165


Creating SWIFT Maps

✦ SWIFT_2009_767.mxl
✦ SWIFT_2009_768.mxl
✦ SWIFT_2009_769.mxl
✦ SWIFT_2009_790.mxl
✦ SWIFT_2009_791.mxl
✦ SWIFT_2009_792.mxl
✦ SWIFT_2009_795.mxl
✦ SWIFT_2009_796.mxl
✦ SWIFT_2009_798.mxl
✦ SWIFT_2009_799.mxl
✦ SWIFT_2009_800.mxl
✦ SWIFT_2009_801.mxl
✦ SWIFT_2009_802.mxl
✦ SWIFT_2009_810.mxl
✦ SWIFT_2009_812.mxl
✦ SWIFT_2009_813.mxl
✦ SWIFT_2009_820.mxl
✦ SWIFT_2009_821.mxl
✦ SWIFT_2009_822.mxl
✦ SWIFT_2009_823.mxl
✦ SWIFT_2009_824.mxl
✦ SWIFT_2009_890.mxl
✦ SWIFT_2009_891.mxl
✦ SWIFT_2009_892.mxl
✦ SWIFT_2009_895.mxl
✦ SWIFT_2009_896.mxl
✦ SWIFT_2009_898.mxl
✦ SWIFT_2009_899.mxl
✦ SWIFT_2009_900.mxl
✦ SWIFT_2009_910.mxl
✦ SWIFT_2009_920.mxl
✦ SWIFT_2009_935.mxl
✦ SWIFT_2009_940.mxl
✦ SWIFT_2009_941.mxl
✦ SWIFT_2009_942.mxl
✦ SWIFT_2009_950.mxl

Sterling Commerce, Inc. 166


Creating SWIFT Maps

✦ SWIFT_2009_970.mxl
✦ SWIFT_2009_971.mxl
✦ SWIFT_2009_972.mxl
✦ SWIFT_2009_973.mxl
✦ SWIFT_2009_985.mxl
✦ SWIFT_2009_986.mxl
✦ SWIFT_2009_990.mxl
✦ SWIFT_2009_991.mxl
✦ SWIFT_2009_992.mxl
✦ SWIFT_2009_995.mxl
✦ SWIFT_2009_996.mxl
✦ SWIFT_2009_998.mxl
✦ SWIFT_2009_999.mxl
✦ SWIFT_2009_202_COV.mxl
✦ SWIFT_2009_205_COV.mxl
✦ SWIFT_2010_097.mxl
✦ SWIFT_2010_101.mxl
✦ SWIFT_2010_102.mxl
✦ SWIFT_2010_102_STP.mxl
✦ SWIFT_2010_103.mxl
✦ SWIFT_2010_103_STP.mxl
✦ SWIFT_2010_104.mxl
✦ SWIFT_2010_105.mxl
✦ SWIFT_2010_107.mxl
✦ SWIFT_2010_110.mxl
✦ SWIFT_2010_111.mxl
✦ SWIFT_2010_112.mxl
✦ SWIFT_2010_190.mxl
✦ SWIFT_2010_191.mxl
✦ SWIFT_2010_192.mxl
✦ SWIFT_2010_195.mxl
✦ SWIFT_2010_196.mxl
✦ SWIFT_2010_198.mxl
✦ SWIFT_2010_199.mxl
✦ SWIFT_2010_200.mxl
✦ SWIFT_2010_201.mxl

Sterling Commerce, Inc. 167


Creating SWIFT Maps

✦ SWIFT_2010_202.mxl
✦ SWIFT_2010_202_COV.mxl
✦ SWIFT_2010_203.mxl
✦ SWIFT_2010_204.mxl
✦ SWIFT_2010_205.mxl
✦ SWIFT_2010_205_COV.mxl
✦ SWIFT_2010_207.mxl
✦ SWIFT_2010_210.mxl
✦ SWIFT_2010_256.mxl
✦ SWIFT_2010_290.mxl
✦ SWIFT_2010_291.mxl
✦ SWIFT_2010_292.mxl
✦ SWIFT_2010_295.mxl
✦ SWIFT_2010_296.mxl
✦ SWIFT_2010_298.mxl
✦ SWIFT_2010_299.mxl
✦ SWIFT_2010_300.mxl
✦ SWIFT_2010_303.mxl
✦ SWIFT_2010_304.mxl
✦ SWIFT_2010_305.mxl
✦ SWIFT_2010_306.mxl
✦ SWIFT_2010_307.mxl
✦ SWIFT_2010_320.mxl
✦ SWIFT_2010_321.mxl
✦ SWIFT_2010_330.mxl
✦ SWIFT_2010_340.mxl
✦ SWIFT_2010_341.mxl
✦ SWIFT_2010_350.mxl
✦ SWIFT_2010_360.mxl
✦ SWIFT_2010_361.mxl
✦ SWIFT_2010_362.mxl
✦ SWIFT_2010_364.mxl
✦ SWIFT_2010_365.mxl
✦ SWIFT_2010_380.mxl
✦ SWIFT_2010_381.mxl
✦ SWIFT_2010_390.mxl

Sterling Commerce, Inc. 168


Creating SWIFT Maps

✦ SWIFT_2010_391.mxl
✦ SWIFT_2010_392.mxl
✦ SWIFT_2010_395.mxl
✦ SWIFT_2010_396.mxl
✦ SWIFT_2010_398.mxl
✦ SWIFT_2010_399.mxl
✦ SWIFT_2010_400.mxl
✦ SWIFT_2010_405.mxl
✦ SWIFT_2010_410.mxl
✦ SWIFT_2010_412.mxl
✦ SWIFT_2010_416.mxl
✦ SWIFT_2010_420.mxl
✦ SWIFT_2010_422.mxl
✦ SWIFT_2010_430.mxl
✦ SWIFT_2010_450.mxl
✦ SWIFT_2010_455.mxl
✦ SWIFT_2010_456.mxl
✦ SWIFT_2010_490.mxl
✦ SWIFT_2010_491.mxl
✦ SWIFT_2010_492.mxl
✦ SWIFT_2010_495.mxl
✦ SWIFT_2010_496.mxl
✦ SWIFT_2010_498.mxl
✦ SWIFT_2010_499.mxl
✦ SWIFT_2010_500.mxl
✦ SWIFT_2010_501.mxl
✦ SWIFT_2010_502.mxl
✦ SWIFT_2010_503.mxl
✦ SWIFT_2010_504.mxl
✦ SWIFT_2010_505.mxl
✦ SWIFT_2010_506.mxl
✦ SWIFT_2010_507.mxl
✦ SWIFT_2010_508.mxl
✦ SWIFT_2010_509.mxl
✦ SWIFT_2010_510.mxl
✦ SWIFT_2010_513.mxl

Sterling Commerce, Inc. 169


Creating SWIFT Maps

✦ SWIFT_2010_514.mxl
✦ SWIFT_2010_515.mxl
✦ SWIFT_2010_515_SMPG02.mxl
✦ SWIFT_2010_516.mxl
✦ SWIFT_2010_517.mxl
✦ SWIFT_2010_518.mxl
✦ SWIFT_2010_519.mxl
✦ SWIFT_2010_524.mxl
✦ SWIFT_2010_526.mxl
✦ SWIFT_2010_527.mxl
✦ SWIFT_2010_528.mxl
✦ SWIFT_2010_529.mxl
✦ SWIFT_2010_530.mxl
✦ SWIFT_2010_535.mxl
✦ SWIFT_2010_536_IOA001.mxl
✦ SWIFT_2010_536.mxl
✦ SWIFT_2010_537.mxl
✦ SWIFT_2010_538.mxl
✦ SWIFT_2010_540.mxl
✦ SWIFT_2010_541.mxl
✦ SWIFT_2010_542.mxl
✦ SWIFT_2010_543.mxl
✦ SWIFT_2010_544.mxl
✦ SWIFT_2010_545.mxl
✦ SWIFT_2010_546.mxl
✦ SWIFT_2010_547.mxl
✦ SWIFT_2010_548.mxl
✦ SWIFT_2010_549.mxl
✦ SWIFT_2010_558.mxl
✦ SWIFT_2010_559.mxl
✦ SWIFT_2010_564.mxl
✦ SWIFT_2010_565.mxl
✦ SWIFT_2010_566.mxl
✦ SWIFT_2010_567.mxl
✦ SWIFT_2010_568.mxl
✦ SWIFT_2010_569.mxl

Sterling Commerce, Inc. 170


Creating SWIFT Maps

✦ SWIFT_2010_574_IRSLST.mxl
✦ SWIFT_2010_574_W8BENO.mxl
✦ SWIFT_2010_575.mxl
✦ SWIFT_2010_576.mxl
✦ SWIFT_2010_577.mxl
✦ SWIFT_2010_578.mxl
✦ SWIFT_2010_579.mxl
✦ SWIFT_2010_581.mxl
✦ SWIFT_2010_582.mxl
✦ SWIFT_2010_584.mxl
✦ SWIFT_2010_586.mxl
✦ SWIFT_2010_587.mxl
✦ SWIFT_2010_588.mxl
✦ SWIFT_2010_589.mxl
✦ SWIFT_2010_590.mxl
✦ SWIFT_2010_591.mxl
✦ SWIFT_2010_592.mxl
✦ SWIFT_2010_595.mxl
✦ SWIFT_2010_596.mxl
✦ SWIFT_2010_598.mxl
✦ SWIFT_2010_599.mxl
✦ SWIFT_2010_600.mxl
✦ SWIFT_2010_601.mxl
✦ SWIFT_2010_604.mxl
✦ SWIFT_2010_605.mxl
✦ SWIFT_2010_606.mxl
✦ SWIFT_2010_607.mxl
✦ SWIFT_2010_608.mxl
✦ SWIFT_2010_609.mxl
✦ SWIFT_2010_620.mxl
✦ SWIFT_2010_643.mxl
✦ SWIFT_2010_644.mxl
✦ SWIFT_2010_646.mxl
✦ SWIFT_2010_649.mxl
✦ SWIFT_2010_690.mxl
✦ SWIFT_2010_691.mxl

Sterling Commerce, Inc. 171


Creating SWIFT Maps

✦ SWIFT_2010_692.mxl
✦ SWIFT_2010_695.mxl
✦ SWIFT_2010_696.mxl
✦ SWIFT_2010_698.mxl
✦ SWIFT_2010_699.mxl
✦ SWIFT_2010_700.mxl
✦ SWIFT_2010_701.mxl
✦ SWIFT_2010_705.mxl
✦ SWIFT_2010_707.mxl
✦ SWIFT_2010_710.mxl
✦ SWIFT_2010_711.mxl
✦ SWIFT_2010_720.mxl
✦ SWIFT_2010_721.mxl
✦ SWIFT_2010_730.mxl
✦ SWIFT_2010_732.mxl
✦ SWIFT_2010_734.mxl
✦ SWIFT_2010_740.mxl
✦ SWIFT_2010_742.mxl
✦ SWIFT_2010_747.mxl
✦ SWIFT_2010_750.mxl
✦ SWIFT_2010_752.mxl
✦ SWIFT_2010_754.mxl
✦ SWIFT_2010_756.mxl
✦ SWIFT_2010_760.mxl
✦ SWIFT_2010_767.mxl
✦ SWIFT_2010_768.mxl
✦ SWIFT_2010_769.mxl
✦ SWIFT_2010_790.mxl
✦ SWIFT_2010_791.mxl
✦ SWIFT_2010_792.mxl
✦ SWIFT_2010_795.mxl
✦ SWIFT_2010_796.mxl
✦ SWIFT_2010_798.mxl
✦ SWIFT_2010_799.mxl
✦ SWIFT_2010_800.mxl
✦ SWIFT_2010_801.mxl

Sterling Commerce, Inc. 172


Creating SWIFT Maps

✦ SWIFT_2010_802.mxl
✦ SWIFT_2010_824.mxl
✦ SWIFT_2010_890.mxl
✦ SWIFT_2010_891.mxl
✦ SWIFT_2010_892.mxl
✦ SWIFT_2010_895.mxl
✦ SWIFT_2010_896.mxl
✦ SWIFT_2010_898.mxl
✦ SWIFT_2010_899.mxl
✦ SWIFT_2010_900.mxl
✦ SWIFT_2010_910.mxl
✦ SWIFT_2010_920.mxl
✦ SWIFT_2010_935.mxl
✦ SWIFT_2010_940.mxl
✦ SWIFT_2010_941.mxl
✦ SWIFT_2010_942.mxl
✦ SWIFT_2010_950.mxl
✦ SWIFT_2010_970.mxl
✦ SWIFT_2010_971.mxl
✦ SWIFT_2010_972.mxl
✦ SWIFT_2010_973.mxl
✦ SWIFT_2010_985.mxl
✦ SWIFT_2010_986.mxl
✦ SWIFT_2010_990.mxl
✦ SWIFT_2010_991.mxl
✦ SWIFT_2010_992.mxl
✦ SWIFT_2010_995.mxl
✦ SWIFT_2010_996.mxl
✦ SWIFT_2010_998.mxl
✦ SWIFT_2010_999.mxl
MX Maps
✦ swiftMX.1-0.camt.003.001.02.mxl
✦ swiftMX.1-0.camt.004.001.02.mxl
✦ swiftMX.1-0.camt.005.001.02.mxl
✦ swiftMX.1-0.camt.006.001.02.mxl
✦ swiftMX.1-0.camt.007.002.01.mxl

Sterling Commerce, Inc. 173


Creating SWIFT Maps

✦ swiftMX.1-0.camt.008.002.01.mxl
✦ swiftMX.1-0.camt.026.001.01.mxl
✦ swiftMX.1-0.camt.027.001.01.mxl
✦ swiftMX.1-0.camt.028.001.01.mxl
✦ swiftMX.1-0.camt.029.001.01.mxl
✦ swiftMX.1-0.camt.030.001.01.mxl
✦ swiftMX.1-0.camt.031.001.01.mxl
✦ swiftMX.1-0.camt.032.001.01.mxl
✦ swiftMX.1-0.camt.033.001.01.mxl
✦ swiftMX.1-0.camt.034.001.01.mxl
✦ swiftMX.1-0.camt.035.001.01.mxl
✦ swiftMX.1-0.camt.036.001.01.mxl
✦ swiftMX.1-0.camt.037.001.01.mxl
✦ swiftMX.1-0.camt.038.001.01.mxl
✦ swiftMX.1-0.camt.039.001.01.mxl
✦ swiftMX.2-0.camt.052.001.02.mxl
✦ swiftMX.1-0.seev.001.001.02.mxl
✦ swiftMX.1-0.seev.002.001.02.mxl
✦ swiftMX.1-0.seev.003.001.02.mxl
✦ swiftMX.1-0.seev.004.001.02.mxl
✦ swiftMX.1-0.seev.005.001.02.mxl
✦ swiftMX.1-0.seev.006.001.02.mxl
✦ swiftMX.1-0.seev.007.001.02.mxl
✦ swiftMX.1-0.seev.008.001.02.mxl
✦ swiftMX.1-0.semt.008.001.02.mxl
✦ swiftMX.1-0.semt.009.001.02.mxl
✦ swiftMX.1-0.semt.010.001.01.mxl
✦ swiftMX.1-1.seev.001.001.03.mxl
✦ swiftMX.1-1.seev.002.001.03.mxl
✦ swiftMX.1-1.seev.003.001.03.mxl
✦ swiftMX.1-1.seev.004.001.03.mxl
✦ swiftMX.1-1.seev.005.001.03.mxl
✦ swiftMX.1-1.seev.006.001.03.mxl
✦ swiftMX.1-1.seev.007.001.03.mxl
✦ swiftMX.1-1.seev.008.001.03.mxl
✦ swiftMX.1-0.semt.011.001.01.mxl

Sterling Commerce, Inc. 174


Creating SWIFT Maps

✦ swiftMX.1-0.tsmt.001.001.02.mxl
✦ swiftMX.1-0.tsmt.002.001.02.mxl
✦ swiftMX.1-0.tsmt.003.001.02.mxl
✦ swiftMX.1-0.tsmt.004.001.01.mxl
✦ swiftMX.1-0.tsmt.005.001.01.mxl
✦ swiftMX.1-0.tsmt.006.001.02.mxl
✦ swiftMX.1-0.tsmt.007.001.01.mxl
✦ swiftMX.1-0.tsmt.008.001.02.mxl
✦ swiftMX.1-0.tsmt.009.001.02.mxl
✦ swiftMX.1-0.tsmt.010.001.02.mxl
✦ swiftMX.1-0.tsmt.011.001.02.mxl
✦ swiftMX.1-0.tsmt.012.001.02.mxl
✦ swiftMX.1-0.tsmt.013.001.02.mxl
✦ swiftMX.1-0.tsmt.014.001.02.mxl
✦ swiftMX.1-0.tsmt.015.001.02.mxl
✦ swiftMX.1-0.tsmt.016.001.02.mxl
✦ swiftMX.1-0.tsmt.017.001.02.mxl
✦ swiftMX.1-0.tsmt.018.001.02.mxl
✦ swiftMX.1-0.tsmt.019.001.02.mxl
✦ swiftMX.1-0.tsmt.020.001.01.mxl
✦ swiftMX.1-0.tsmt.021.001.02.mxl
✦ swiftMX.1-0.tsmt.022.001.01.mxl
✦ swiftMX.1-0.tsmt.023.001.02.mxl
✦ swiftMX.1-0.tsmt.024.001.02.mxl
✦ swiftMX.1-0.tsmt.025.001.02.mxl
✦ swiftMX.1-0.tsmt.026.001.01.mxl
✦ swiftMX.1-0.tsmt.027.001.01.mxl
✦ swiftMX.1-0.tsmt.028.001.02.mxl
✦ swiftMX.1-0.tsmt.029.001.01.mxl
✦ swiftMX.1-0.tsmt.030.001.02.mxl
✦ swiftMX.1-0.tsmt.031.001.02.mxl
✦ swiftMX.1-0.tsmt.032.001.02.mxl
✦ swiftMX.1-0.tsmt.033.001.02.mxl
✦ swiftMX.1-0.tsmt.034.001.02.mxl
✦ swiftMX.1-0.tsmt.035.001.02.mxl
✦ swiftMX.1-0.tsmt.036.001.02.mxl

Sterling Commerce, Inc. 175


Creating SWIFT Maps

✦ swiftMX.1-0.tsmt.037.001.02.mxl
✦ swiftMX.1-0.tsmt.038.001.02.mxl
✦ swiftMX.1-0.tsmt.039.001.02.mxl
✦ swiftMX.1-0.tsmt.040.001.02.mxl
✦ swiftMX.1-0.tsmt.041.001.02.mxl
✦ swiftMX.1-0.tsmt.042.001.02.mxl
✦ swiftMX.1-1.camt.007.002.02.mxl
✦ swiftMX.1-1.camt.008.002.02.mxl
✦ swiftMX.1-1.camt.026.001.02.mxl
✦ swiftMX.1-1.camt.027.001.02.mxl
✦ swiftMX.1-1.camt.028.001.02.mxl
✦ swiftMX.1-1.camt.029.001.02.mxl
✦ swiftMX.1-1.camt.030.001.02.mxl
✦ swiftMX.1-1.camt.031.001.02.mxl
✦ swiftMX.1-1.camt.032.001.01.mxl
✦ swiftMX.1-1.camt.033.001.02.mxl
✦ swiftMX.1-1.camt.034.001.02.mxl
✦ swiftMX.1-1.camt.035.001.01.mxl
✦ swiftMX.1-1.camt.036.001.01.mxl
✦ swiftMX.1-1.camt.037.001.02.mxl
✦ swiftMX.1-1.camt.038.001.01.mxl
✦ swiftMX.1-1.camt.039.001.02.mxl
✦ swiftMX.1-2.camt.007.002.02.mxl
✦ swiftMX.1-2.camt.008.002.02.mxl
✦ swiftMX.1-2.camt.026.001.02.mxl
✦ swiftMX.1-2.camt.027.001.02.mxl
✦ swiftMX.1-2.camt.028.001.02.mxl
✦ swiftMX.1-2.camt.029.001.02.mxl
✦ swiftMX.1-2.camt.030.001.02.mxl
✦ swiftMX.1-2.camt.031.001.02.mxl
✦ swiftMX.1-2.camt.032.001.01.mxl
✦ swiftMX.1-2.camt.033.001.02.mxl
✦ swiftMX.1-2.camt.034.001.02.mxl
✦ swiftMX.1-2.camt.035.001.01.mxl
✦ swiftMX.1-2.camt.036.001.01.mxl
✦ swiftMX.1-2.camt.037.001.02.mxl

Sterling Commerce, Inc. 176


Creating SWIFT Maps

✦ swiftMX.1-2.camt.038.001.01.mxl
✦ swiftMX.1-2.camt.039.001.02.mxl
✦ swiftMX.2-0.camt.052.001.01.mxl
✦ swiftMX.2-0.camt.053.001.01.mxl
✦ swiftMX.2-0.camt.054.001.01.mxl
✦ swiftMX.2-0.pacs.002.001.02.mxl
✦ swiftMX.2-0.pacs.003.001.01.mxl
✦ swiftMX.2-0.pacs.004.001.01.mxl
✦ swiftMX.2-0.pacs.006.001.01.mxl
✦ swiftMX.2-0.pacs.007.001.01.mxl
✦ swiftMX.2-0.pacs.008.001.01.mxl
✦ swiftMX.2-0.pacs.009.001.01.mxl
✦ swiftMX.2-0.pain.001.001.02.mxl
✦ swiftMX.2-0.pain.002.001.02.mxl
✦ swiftMX.2-0.semt.001.001.01.mxl
✦ swiftMX.2-0.semt.002.001.01.mxl
✦ swiftMX.2-0.semt.003.001.01.mxl
✦ swiftMX.2-0.semt.004.001.01.mxl
✦ swiftMX.2-0.semt.005.001.01.mxl
✦ swiftMX.2-0.semt.006.001.01.mxl
✦ swiftMX.2-0.semt.007.001.01.mxl
✦ swiftMX.2-0.sese.001.001.01.mxl
✦ swiftMX.2-0.sese.002.001.01.mxl
✦ swiftMX.2-0.sese.003.001.01.mxl
✦ swiftMX.2-0.sese.004.001.01.mxl
✦ swiftMX.2-0.sese.005.001.01.mxl
✦ swiftMX.2-0.sese.006.001.01.mxl
✦ swiftMX.2-0.sese.007.001.01.mxl
✦ swiftMX.2-0.sese.008.001.01.mxl
✦ swiftMX.2-0.sese.009.001.01.mxl
✦ swiftMX.2-0.sese.010.001.01.mxl
✦ swiftMX.2-0.sese.011.001.01.mxl
✦ swiftMX.2-1.camt.040.001.02.mxl
✦ swiftMX.2-1.camt.041.001.02.mxl
✦ swiftMX.2-1.camt.042.001.02.mxl
✦ swiftMX.2-1.camt.043.001.02.mxl

Sterling Commerce, Inc. 177


Creating SWIFT Maps

✦ swiftMX.2-1.camt.044.001.01.mxl
✦ swiftMX.2-1.camt.045.001.01.mxl
✦ swiftMX.2-1.reda.001.001.02.mxl
✦ swiftMX.2-1.reda.002.001.02.mxl
✦ swiftMX.2-1.reda.003.001.02.mxl
✦ swiftMX.2-1.setr.001.001.02.mxl
✦ swiftMX.2-1.setr.002.001.02.mxl
✦ swiftMX.2-1.setr.003.001.02.mxl
✦ swiftMX.2-1.setr.004.001.02.mxl
✦ swiftMX.2-1.setr.005.001.02.mxl
✦ swiftMX.2-1.setr.006.001.02.mxl
✦ swiftMX.2-1.setr.007.001.02.mxl
✦ swiftMX.2-1.setr.008.001.02.mxl
✦ swiftMX.2-1.setr.009.001.02.mxl
✦ swiftMX.2-1.setr.010.001.02.mxl
✦ swiftMX.2-1.setr.011.001.02.mxl
✦ swiftMX.2-1.setr.012.001.02.mxl
✦ swiftMX.2-1.setr.013.001.02.mxl
✦ swiftMX.2-1.setr.014.001.02.mxl
✦ swiftMX.2-1.setr.015.001.02.mxl
✦ swiftMX.2-1.setr.016.001.02.mxl
✦ swiftMX.2-1.setr.017.001.02.mxl
✦ swiftMX.2-1.setr.018.001.02.mxl
✦ swiftMX.2-2.sese.012.001.01.mxl
✦ swiftMX.2-2.sese.013.001.01.mxl
✦ swiftMX.2-2.sese.014.001.01.mxl
✦ swiftMX.3-0.acmt.001.001.01.mxl
✦ swiftMX.3-0.acmt.002.001.01.mxl
✦ swiftMX.3-0.acmt.003.001.01.mxl
✦ swiftMX.3-0.acmt.004.001.01.mxl
✦ swiftMX.3-0.acmt.005.001.01.mxl
✦ swiftMX.3-0.acmt.006.001.01.mxl
✦ swiftMX.3-0.camt.003.001.03.mxl
✦ swiftMX.3-0.camt.004.001.03.mxl
✦ swiftMX.3-0.camt.005.001.03.mxl
✦ swiftMX.3-0.camt.006.001.03.mxl

Sterling Commerce, Inc. 178


Creating SWIFT Maps

✦ swiftMX.3-1.camt.003.001.03.mxl
✦ swiftMX.3-1.camt.004.001.03.mxl
✦ swiftMX.3-1.camt.005.001.03.mxl
✦ swiftMX.3-1.camt.006.001.03.mxl
✦ swiftMX.3-1.sese.015.001.01.mxl
✦ swiftMX.3-1.sese.016.001.01.mxl
✦ swiftMX.3-1.sese.017.001.01.mxl
✦ swiftMX.3-2.camt.003.001.03.mxl
✦ swiftMX.3-2.camt.004.001.03.mxl
✦ swiftMX.3-2.camt.005.001.03.mxl
✦ swiftMX.3-2.camt.006.001.03.mxl
✦ swiftMX.4-0.acmt.001.001.02.mxl
✦ swiftMX.4-0.acmt.002.001.02.mxl
✦ swiftMX.4-0.acmt.003.001.02.mxl
✦ swiftMX.4-0.acmt.004.001.02.mxl
✦ swiftMX.4-0.acmt.005.001.02.mxl
✦ swiftMX.4-0.acmt.006.001.02.mxl
✦ swiftMX.4-0.camt.003.001.04.mxl
✦ swiftMX.4-0.camt.004.001.04.mxl
✦ swiftMX.4-0.camt.005.001.04.mxl
✦ swiftMX.4-0.camt.006.001.04.mxl
✦ swiftMX.4-0.camt.007.001.04.mxl
✦ swiftMX.4-0.camt.008.001.04.mxl
✦ swiftMX.4-0.camt.009.001.04.mxl
✦ swiftMX.4-0.camt.010.001.04.mxl
✦ swiftMX.4-0.camt.011.001.04.mxl
✦ swiftMX.4-0.camt.012.001.04.mxl
✦ swiftMX.4-0.camt.013.001.02.mxl
✦ swiftMX.4-0.camt.014.001.02.mxl
✦ swiftMX.4-0.camt.015.001.02.mxl
✦ swiftMX.4-0.camt.016.001.02.mxl
✦ swiftMX.4-0.camt.017.001.02.mxl
✦ swiftMX.4-0.camt.018.001.02.mxl
✦ swiftMX.4-0.camt.019.001.03.mxl
✦ swiftMX.4-0.camt.020.001.02.mxl
✦ swiftMX.4-0.camt.021.001.02.mxl

Sterling Commerce, Inc. 179


Creating SWIFT Maps

✦ swiftMX.4-0.camt.023.001.03.mxl
✦ swiftMX.4-0.camt.024.001.03.mxl
✦ swiftMX.4-0.camt.025.001.02.mxl
✦ swiftMX.4-0.camt.040.001.03.mxl
✦ swiftMX.4-0.camt.041.001.03.mxl
✦ swiftMX.4-0.camt.042.001.03.mxl
✦ swiftMX.4-0.camt.043.001.03.mxl
✦ swiftMX.4-0.camt.044.001.02.mxl
✦ swiftMX.4-0.camt.045.001.02.mxl
✦ swiftMX.4-0.camt.046.001.02.mxl
✦ swiftMX.4-0.camt.047.001.02.mxl
✦ swiftMX.4-0.camt.048.001.02.mxl
✦ swiftMX.4-0.camt.049.001.02.mxl
✦ swiftMX.4-0.camt.050.001.02.mxl
✦ swiftMX.4-0.camt.051.001.02.mxl
✦ swiftMX.4-0.camt.052.001.01.mxl
✦ swiftMX.4-0.camt.998.001.02.mxl
✦ swiftMX.4-0.reda.001.001.03.mxl
✦ swiftMX.4-0.reda.002.001.03.mxl
✦ swiftMX.4-0.reda.003.001.03.mxl
✦ swiftMX.4-0.semt.001.001.02.mxl
✦ swiftMX.4-0.semt.002.001.02.mxl
✦ swiftMX.4-0.semt.003.001.02.mxl
✦ swiftMX.4-0.semt.004.001.02.mxl
✦ swiftMX.4-0.semt.005.001.02.mxl
✦ swiftMX.4-0.semt.006.001.02.mxl
✦ swiftMX.4-0.semt.007.001.02.mxl
✦ swiftMX.4-0.sese.001.001.02.mxl
✦ swiftMX.4-0.sese.002.001.02.mxl
✦ swiftMX.4-0.sese.003.001.02.mxl
✦ swiftMX.4-0.sese.004.001.02.mxl
✦ swiftMX.4-0.sese.005.001.02.mxl
✦ swiftMX.4-0.sese.006.001.02.mxl
✦ swiftMX.4-0.sese.007.001.02.mxl
✦ swiftMX.4-0.sese.008.001.02.mxl
✦ swiftMX.4-0.sese.009.001.02.mxl

Sterling Commerce, Inc. 180


Creating SWIFT Maps

✦ swiftMX.4-0.sese.010.001.02.mxl
✦ swiftMX.4-0.sese.011.001.02.mxl
✦ swiftMX.4-0.sese.012.001.02.mxl
✦ swiftMX.4-0.sese.013.001.02.mxl
✦ swiftMX.4-0.sese.014.001.02.mxl
✦ swiftMX.4-0.sese.018.001.01.mxl
✦ swiftMX.4-0.sese.019.001.01.mxl
✦ swiftMX.4-0.setr.001.001.03.mxl
✦ swiftMX.4-0.setr.002.001.03.mxl
✦ swiftMX.4-0.setr.003.001.03.mxl
✦ swiftMX.4-0.setr.004.001.03.mxl
✦ swiftMX.4-0.setr.005.001.03.mxl
✦ swiftMX.4-0.setr.006.001.03.mxl
✦ swiftMX.4-0.setr.007.001.03.mxl
✦ swiftMX.4-0.setr.008.001.03.mxl
✦ swiftMX.4-0.setr.009.001.03.mxl
✦ swiftMX.4-0.setr.010.001.03.mxl
✦ swiftMX.4-0.setr.011.001.03.mxl
✦ swiftMX.4-0.setr.012.001.03.mxl
✦ swiftMX.4-0.setr.013.001.03.mxl
✦ swiftMX.4-0.setr.014.001.03.mxl
✦ swiftMX.4-0.setr.015.001.03.mxl
✦ swiftMX.4-0.setr.016.001.03.mxl
✦ swiftMX.4-0.setr.017.001.03.mxl
✦ swiftMX.4-0.setr.018.001.03.mxl
✦ swiftMX.4-0.setr.047.001.01.mxl
✦ swiftMX.4-0.setr.048.001.01.mxl
✦ swiftMX.4-0.setr.049.001.01.mxl
✦ swiftMX.4-0.setr.050.001.01.mxl
✦ swiftMX.4-0.setr.051.001.01.mxl
✦ swiftMX.4-0.setr.052.001.01.mxl
✦ swiftMX.4-0.setr.053.001.01.mxl
✦ swiftMX.4-0.setr.054.001.01.mxl
✦ swiftMX.4-0.setr.055.001.01.mxl
✦ swiftMX.4-0.setr.056.001.01.mxl
✦ swiftMX.4-0.setr.057.001.01.mxl

Sterling Commerce, Inc. 181


Creating SWIFT Maps

✦ swiftMX.4-0.setr.058.001.01.mxl
✦ swiftMX.1-0.pain.009.001.01.mxl
✦ swiftMX.1-0.pain.010.001.01.mxl
✦ swiftMX.1-0.pain.011.001.01.mxl
✦ swiftMX.1-0.pain.012.001.01.mxl
✦ swiftMX.1-2.seev.001.001.04.mxl
✦ swiftMX.1-2.seev.002.001.04.mxl
✦ swiftMX.1-2.seev.003.001.04.mxl
✦ swiftMX.1-2.seev.004.001.04.mxl
✦ swiftMX.1-2.seev.005.001.04.mxl
✦ swiftMX.1-2.seev.006.001.04.mxl
✦ swiftMX.1-2.seev.007.001.04.mxl
✦ swiftMX.1-2.seev.008.001.04.mxl

Sterling Commerce, Inc. 182


SWIFTNet Correlations
Note: If you upgrade to the Sterling Standards Library Version 5.3, you must run the
SwnetCorrMigrate.cmd migration script because the SWIFTNet Correlations details are now
stored in the SWNET_MSG_INFO and SWNET_MSG database tables instead of the
CORRELATION_SET table. See Migrating Correlation Details to Version 5.3 on page 186 for
more information.
Correlation data, often called correlations, is defined as specific pieces of data that you may need to review
in the process of monitoring, tracking, and troubleshooting your activities. These data items are defined by
type and value. These type-value pairs are known as name-value pairs, and are a powerful tool you can use
to record and search for business process- and document-specific data. The name-value pair records are
stored in the correlation table in the application.
Defining correlations can be part of configuring your business process models and maps. Taking the time
to determine the name-value pairs for monitoring and troubleshooting, and configuring them in maps and
business process models, can save you time later.
Correlations can be predefined (provided in certain services), defined by you, and configured at the map
level:
✦ You can assign name-value pairs to a service in a process model using the Service Editor in the GPM.
✦ You can create unique name-value pairs for a service using the Service Editor in the GPM.
✦ You can define name-value pairs and include the service in a business process model. This enables you
to search for the data items you need using advanced search options in the application interface.
✦ You can configure correlation data using standard rules in a map, to specify that data is extracted from
a document when it is translated. The Update standard rule correlation data function enables you to
record document-specific correlation parameters during translation. These correlation parameters are
attached to the translated document. You can then use the Correlation Search user interface to locate
the translated document using the criteria you specified in the map through the Update standard rule.
This function may save you effort, because you would otherwise need to locate the translated
document by reviewing the results from a Central Search query.
The Correlation Search page provides details about each SWIFTNet transport transaction. Each transaction
is a tracking point for any workflow IDs and documents involved in the transaction.The SWIFTNet
Correlation search feature offers the following additional benefits:
✦ You can receive the results of search queries more quickly.
✦ You can further refine correlation searches by specifying a start and end date/time range.
✦ You can further refine SWIFT correlation searches by specifying SWIFT-specific criteria.

Searching for SWIFT Messages Using Correlations


To perform an advanced search for documents:
1. From the Administration menu, select Business Process > Monitor > Advanced Search >
SWIFTNet Correlation.

Sterling Commerce, Inc. 183


SWIFTNet Correlations

2. In the Search SWIFTNet Correlation section, specify any combination of the following search
criteria, as appropriate:

Field Description Action

Location The location of the tables you wish to Select Live Tables or Restore Tables.
search.

Requestor DN Distinguished name of the requestor. Type the name of the requestor.
Note: This DN must be registered with the
SAG instance using SWIFTNet
Alliance Webstation.

Responder DN Distinguished name of the responder. Note: This DN must be registered with the
SAG instance using SWIFTNet
Alliance Webstation.

Service Name Name of the service to which both SWIFT Type the service name.
correspondents have subscribed. Note: This must be a SWIFTNet service to
which you are subscribed.

Request Type Request type supported by the message Type the request type.
exchange.

Interface SWIFTNet message type. Select either InterAct or FileAct.

Operation The SWIFTNet operation to send an InterAct Select from the following:
or FileAct message.
Š get (FileAct)
Š put (FileAct)
Š sync (Interact)
Š async (Interact)

SnF Indicates if the file transfer is done using the Select either True (use Store-and-Forward) or
store-and-forward method. False (do not use Store-and-Forward).

Direction Indicates the direction of the messages. Select either Inbound or Outbound.

Status The status of the messages. Select one of the following formats:
Š Success
Š Failed
Š In Process

Activity From Documents in progress or completed after Using the following formats, type a starting date
the specified start date and time. and time range and select AM or PM:
Š Date – MM/DD/YY
Š Time – HH:MM

Activity To Documents in progress or completed before Using the following formats, type an end date and
the specified end date and time. time range and select AM or PM.:
Š Date – MM/DD/YY
Š Time – HH:MM

Sterling Commerce, Inc. 184


SWIFTNet Correlations

Field Description Action

File Name Search for SWIFTNet records that are Type the name of the file for which you want to
(FileAct Only) associated with a specific file. search the associated records.
Note: This search is valid for FileAct
messages only.

File Size From Search for SWIFTNet records that are Type the beginning size range of the files.
(FileAct Only) associated to files with a specified size
range.

File Size To Search for SWIFTNet records that are Type the endpoint of the range for the file size.
(FileAct Only) associated to files with a specified size
range.

File Size (FileAct Measurement of file size Select from the following:
Only)
Š bytes
Š KB
Š MB

Results per page Number of documents you want to display Select the value to indicate the number of
on the results page. documents to display. Valid values are:
Š 5
Š 10
Š 15

3. Click Go! and the Search Results page opens, listing the SWIFTNet Transaction and SWIFTNet
Message details that match your search criteria.

Field Description

Status Whether the transaction was a success or failure.

Requestor DN - The Requestor/Responder pair for the transaction.


Responder DN

Interface/Operation The transport mode for the transaction.

Service Name The service name for the transaction.

Type The request type for the transaction.

Ref The reference for the transaction.

File Name (byte size) The size of the Request/Response payload for InterAct transactions or the Transfer file
name with size for FileAct transactions.

Msg Type The type of message. Valid values are Request/Response, Delivery Notification, and File
Transfer.

Status The status of the message. Valid values are Accepted, Failed, and In Progress.

WF ID A link to the initiating workflow identifier of the transaction.

Sterling Commerce, Inc. 185


SWIFTNet Correlations

Field Description

Start Time The start time for the transaction.

Document A link to the document corresponding to the transaction.

Signature List A link to the signature list of the document for the transaction (for FileAct transactions
only).

Migrating Correlation Details to Version 5.3


If you upgrade to the Sterling Standards Library Version 5.3, you must run the SwnetCorrMigrate.cmd
migration script because the SWIFTNet Correlations details are now stored in the SWNET_MSG_INFO
and SWNET_MSG database tables instead of the CORRELATION_SET table.
The Migration script transfers the SWIFTNet Correlation data from the CORRELATION_SET table to the
SWNET_MSG table (where TYPE = SWIFTNET MESSAGE) and the SWNET_MSG_INFO table (where
TYPE = SWIFTNET TRANSACTION).
The Migration script is available for both Live and Restore records, and you run the SwnetCorrMigrate.cmd
script with the argument either live or restore, depending on which type of records you want to migrate. If
you do not specify an argument, the live records are migrated.

Sterling Commerce, Inc. 186


Overview of SWIFTNet Transport

Overview of SWIFTNet Transport


The application enables you to send messages to SWIFTNet using either the InterAct or FileAct protocol.
The application enables you to connect to SWIFTNet through the InterAct protocol for real-time messaging,
store-and-forward messaging and real-time query and response. It supports delivery notification,
non-repudiation, and message priority.

InterAct and FileAct Protocol


When you use the InterAct or FileAct protocol to transport messages to and from SWIFTNet, the SWIFTNet
MEFG Server serves requests and receives messages to and from SWIFTNet, through a client application
and a server application that communicate with the SWIFTNet network through the InterAct protocol. The
SWIFTNet MEFG Server operates independently from the application.
The SWIFTNet Server adapter is responsible for receiving request messages from SWIFTNet through the
SWIFTNet MEFG Server and sending responses back. The SWIFTNet Server adapter is comprised of two
parts: the service part and the adapter part. The service part is used in a BPML that does not require
configuration except for enabling it for document tracking. The adapter part is configured through the
Admin Console or the GPM, and this adapter is responsible for starting and stopping the SWIFTNet MEFG
Server from the application using the Command Line Adapter 2 (CLA2), which is built into the SWIFTNet
Server adapter. A Command Line 2 client operates in remote installations (with the SWIFTNet MEFG
Server) to enable the application to run a program from a command line in a business process.
The SWIFTNet Client service is responsible for sending SWIFTNet InterAct and FileAct messages (both
requests and responses) to SWIFTNet, which are initiated by the application. The SWIFTNet Client service
enables you to use InterAct and FileAct messaging with a store-and-forward option. The benefits of using
store-and-forward include:
✦ The sender and receiver do not need to be online at the same time, as is necessary for real-time
messaging.
✦ The sender is notified if a message cannot be delivered (and can optionally be notified when messages
are delivered).
The SWIFTNet Client service enables you to use either synchronous or asynchronous messaging using
InterAct and Put or Get mode in FileAct.
The SWIFTNet Routing Rule is used by the SWIFTNet Client service to route incoming request to a
business process for processing. It uses four parameters:
✦ RequesterDN
✦ ResponderDN
✦ Service name
✦ Request type
These parameters are used to map an incoming request to a business process. The SWIFTNet Routing Rule
page enables you to assign any business process to a set of routing parameters.You need to create a
SWIFTNet routing rule and associate it with an appropriate business process to process incoming
SWIFTNet requests.

Sterling Commerce, Inc. 187


Overview of SWIFTNet Transport

Additional FileAct Protocol Options


To send and receive SWIFTNet messages through the FileAct protocol, you will either use the SWIFTNet
MEFG Server or use one of the following two methods to connect the application to SWIFT:
✦ WebSphere MQ Adapter or WebSphere MQ Suite (see Configuring the WebSphere MQ
Adapter/Suite to Communicate with SWIFT on page 303)—enables you to configure the application to
send and receive InterAct and FileAct files to/from SWIFTNet through the WebSphere MQ Interface
for SWIFTAlliance Access (MQSA). Also enables you to send and receive messages to/from
SWIFTNet though SWIFTNet Alliance Access (SAA) and the SWIFTNet Remote API Host Adapter
(RAHA).
✦ Connect:Direct for SWIFTNet—enables you to send and receive FileAct files to/from SWIFTNet
through the SWIFTNet Remote API (SWIFTNet RA) and the SWIFTNet Remote API Host Adapter
(RAHA).

Secure Sockets Layer (SSL)


Secure Sockets Layer (SSL) is a cryptographic protocol that provides secure communications on the
Internet for activities such as web browsing, e-mail, Internet faxing, instant messaging, and other data
transfers.
SSL provides endpoint authentication and communications privacy over the Internet using cryptography.
When you use SSL, usually only the server is authenticated (the client is not authenticated). The
authentication of the server ensures that the end user (which may be a person or an application such as a web
browser) knows exactly with whom he or she is communicating. Once the server is authenticated, all the
data communicated is encrypted and secured between the client and server only.
The application provides you with the ability to set up SSL in a loopback between the SWIFTNet HTTP
Server and the SWIFTNet MEFG Server, so both ends of the communication are secure. You can also
initiate or receive an InterAct or FileAct request using SSL (another form of loopback).

CHIPS Message Transport Using SWIFTNet


The application enables you to send CHIPS messages to CHIPS, using either the SWIFTNet network
(optionally using IBM Websphere MQ) or The Clearing House Frame Relay Network (a proprietary
network that uses IBM Websphere MQ). Acknowledgements are sent to CHIPS using the SWIFTNet Server
adapter. Using the SWIFTNet transport available in the application, you can also receive all response
messages from CHIPS, including heartbeat messages, and send supervisory STATUS messages to CHIPS
to test the connection.
The CHIPS adapter works with the SWIFTNet Server adapter, SWIFTNet HTTP Server adapter, and the
SWIFTNet MEFG Server to communicate with CHIPS. When the CHIPS adapter is used with the
SWIFTNet network, it receives acknowledgement messages from CHIPS in the SWIFTNet Response
within sixty seconds, and any incoming messages (for example, heartbeat message, resolver notification,
and so forth) are received by SWIFTNet Server adapter. The return acknowledgement of the incoming
messages is performed by the Receive Handler and Acknowledgement Handler within the CHIPS adapter
(the business process is bootstrapped using the SWIFTNet Routing Rule).

Sterling Commerce, Inc. 188


SWIFTNet MEFG Server

SWIFTNet MEFG Server

Overview
The SWIFTNet MEFG Server serves requests and receives messages to and from SWIFTNet, through a
client application and a server application that communicate with the SWIFTNet network through the
InterAct or FileAct protocol. The SWIFTNet MEFG Server operates independently from the application
and includes all the APIs necessary to communicate with the SWIFTNet network.
The application enables you to use either InterAct or FileAct messaging with a store-and-forward option.
The benefits of using store-and-forward include:
✦ The sender and receiver do not need to be online at the same time, as is required for real-time
messaging.
✦ The sender is notified in the event delivery fails (and can optionally be notified upon delivery of the
message).
The application also has a feature that provides you with failover support from real-time messages to
store-and-forward (if there is a failure in real-time messaging, you can configure the application to
automatically switch to store-and-forward messaging to increase your messaging success).
Note: This feature requires subscription to both real-time and store-and-forward services.
The SWIFTNet client application sends requests to the SWIFTNet network through the SWIFTNet Alliance
Gateway/SWIFTNet Net Link (SAG/SNL) instance. The client application listens for requests from the
SWIFTNet Client service, and interacts with SWIFTNet to obtain responses.
The SWIFTNet MEFG Server application receives requests from SWIFTNet. The server application listens
for requests from SWIFTNet and interacts with the application to obtain responses. A request from the
server application to the application calls the SWIFTNet Server adapter to process the request.
The SWIFTNet MEFG Server server application is started by enabling (and stopped by disabling) the
SWIFTNet Server adapter. The starting and stopping of the server application is handled through the
Command Line Adapter 2, which is built into the SWIFTNet Server adapter.

Sterling Commerce, Inc. 189


SWIFTNet MEFG Server

This diagram illustrates the process flow between the application and the SWIFTNet network through the
SWIFTNet MEFG Server:

Synchronous Message Exchange/Put Message Exchange


Asynchronous Message Exchange/Get Message Exchange

Request
Response
Client service
SWIFTNet

SWIFTNet
Client Request

SWIFT Remote API


Request Application
Response
SWIFTNet SAG
Response / SWIFTNet
SNL Network
SWIFTNet
Server adapter
SWIFTNet

Server Request
Request
Application
Response SWIFTNet
Response
MEFG Server
Sterling
Commerce
Application

Callback Processing

The administration of the SWIFTNet MEFG Server is through SWIFTNet Server adapter, including
enabling and disabling the SWIFTNet MEFG Server.
If you use the SWIFTNet HTTP Server adapter in conjunction with the SWIFTNet Server adapter to use
Secure Sockets Layer (SSL), the SWIFTNet HTTP Server adapter accepts the forwarded request from the
SWIFTNet MEFG Server and provides secure authentication.
The SWIFTNet Client service (in conjunction with the SWIFTNet HTTP Server adapter) enables you to use
Secure Sockets Layer (SSL) to provide secure authentication, using the SWIFTNet HTTP Server adapter to
accept the forwarded request from the SWIFTNet MEFG Server. When you use SSL with the application,
two channels are secured: an Outbound channel (the application acting as the Requestor) and an Inbound
channel (the application acting as the Responder).

Sterling Commerce, Inc. 190


SWIFTNet MEFG Server

This diagram illustrates the process flow between the application and the SWIFTNet network through the
SWIFTNet MEFG Server, including the Outbound and Inbound channels (using the SWIFTNet HTTP
Server adapter for SSL):

Client service
SWIFTNet

SSL Outbound
Requestor

gSOAP
Server
Public Key
A B Private Key Request
Server adapter
SWIFTNet HTTP

SWIFTNet
Responder

SSL Inbound Request Network


gSOAP
Client

Public Key
Private Key C D

Application SWIFTNet
MEFG Server

You will need 2 pairs of certificates. The first pair belongs to the SWIFTNet MEFG Server (A and B in the
diagram above) and is used to secure the outbound channel. The second pair of certificates belongs to the
application (C and D in the diagram above) and is used to secure the inbound channel. In the above diagram,
the callouts signify the following:
✦ A — A public key certificate file belongs to the SWIFTNet MEFG Server that is configured on the
SWIFTNet Client service (the certificate is specified for the CA Certificate parameter).
✦ B — A private key certificate file that is stored on the SWIFTNet MEFG Server as a key file (which
you configure through the SSL Configuration utility named sslUtil.jar in the SWIFTNet MEFG Server
installation bin sub-directory).
✦ C — A private key certificate file that is configured on the SWIFTNet HTTP Server adapter (the
certificate is specified for the System Cert parameter).
✦ D — A public key file that belongs to the application and is stored for the SWIFTNet MEFG Server as
a CA Cert file or trusted list (that you configure through the SSL Configuration utility named
sslUtil.jar in the SWIFTNet MEFG Server installation bin sub-directory).

Supported Platforms
The following platforms are supported for the SWIFTNet MEFG Server:
✦ Windows Server 2003 (Standard or Enterprise Edition) with Service Pack 1
✦ AIX 5.3 ML02

Sterling Commerce, Inc. 191


SWIFTNet MEFG Server

✦ SunOS 5.10

Client Application
The client application can exchange messages in synchronous or asynchronous mode for InterAct
processing or can exchange messages in Put or Get mode for FileAct processing.

Synchronous Message Exchange


When the client application is communicating in synchronous mode messaging, the SWIFTNet Client
service prepares the request and sends it to the SWIFTNet MEFG Server. Then, the client application on the
SWIFTNet MEFG Server processes the request, performs the necessary communication exchange with the
SWIFTNet SAG/SNL instance, and sends the request to the SWIFTNet network.
In synchronous mode, the client application is blocked until a response is received from the responder
through the SAG/SNL instance. Once a response is received, it is sent to the application by the client
application, and the response is placed in the primary document.

Asynchronous Message Exchange


In asynchronous mode, the SWIFTNet Client service prepares the request and sends it to the SWIFTNet
MEFG Server. The client application on the SWIFTNet MEFG Server processes the request, performs the
necessary communication exchange with the SWIFTNet SAG/SNL instance, and sends the request to the
SWIFTNet network.
In asynchronous mode, the client application receives a response handle from the SAG/SNL instance. Using
this response handle, the client application periodically checks with the SWIFTNet network to determine if
a response is available . Once a response is received by the application, it is placed in the primary document.

Configuring the Client Application


You must appropriately configure the SWIFTNet Client service to use the client application. See SWIFTNet
Client Service.

Server Application
When a request from the SWIFTNet network arrives, the SWIFTNet SAG/SNL sends it to the SWIFTNet
MEFG Server server application. The server application processes the request and forwards the request to
the application. When the application receives the request, it invokes the SWIFTNet Server adapter to
process the request. If store-and-forward messaging is in use, the message payload is placed in a mailbox.

Configuring the Server Application


You must appropriately configure the SWIFTNet Server adapter to use the server application. See
SWIFTNet Server Adapter.

Sterling Commerce, Inc. 192


SWIFTNet MEFG Server

The Application Acting as Third Party


In SWIFT 6.1, the application can act as a Third Party either in T-Copy mode or Y-Copy mode. As a Third
Party, SWIFT forwards the copied request messages to the application. When the copied request is received,
based on the Service Name specified in the message, the application searches the SWIFTNet Copy Service
Profile to find out whether the application must act in T-Copy or Y-Copy mode.
If the application must act in Y-Copy mode, Enhanced Header Information is extracted from the copied
request, and is inserted into the application mailbox. The message name for the mailbox is in the following
format:
ThirdParty_[CopySnFRef]

You can create a mailbox routing rule to evaluate this mailbox and bootstrap a custom business process to
make the decision whether to Third Party Authorised or Refuse the copied request based on the Enhanced
Header Information.
By default, the application supplies a predefined business process for this notification process named
SWIFTNet3rdPartyClientNotification. This predefined business process is based on Transaction Count
Enhanced Header Info. In this business process , the third party authorizes if the Transaction Count is less
than five, and refuses if the Transaction Count is greater than or equal to five. The decision is then made by
the translator using the SWIFTNet3rdPartyClientTxsCntr map. This is the predefined business process:
Note: The notification message is a system message, and it should be sent using Service Name
swift.snf.system. To test this business process, the service name that you should use is
swift.snf.system!x. You must change this name in the business process depending on whether you
are testing it.
<process name="SWIFTNet3rdPartyClientNotification">
<rule name="NoMoreMessage">
<condition>number(msgCount/text()) &gt; number(msgTotal/text())</condition>
</rule>
<sequence name="NotificationFlow">
<assign to="msgCount">1</assign>
<assign to="msgTotal" from="count(RoutingRequest/RoutingRequest/MessageId)"/>
<choice name="ForEachMessage">
<select>
<case ref="NoMoreMessage" negative="true" activity="DoNotification"/>
</select>
<sequence name="DoNotification">
<assign to="msgId"
from="RoutingRequest/RoutingRequest/MessageId[number(//ProcessData/msgCount/text())]
/text()"/>
<operation name="Extract HeaderInfo from Mailbox">
<participant name="MailboxExtractBegin"/>
<output message="MailboxExtractBegin_In">
<assign to="CommitNow">YES</assign>
<assign to="MessageId" from="msgId/text()"/>
<assign to="." from="*"/>
</output>
<input message="MailboxExtractBegin_Out">
<assign to="." from="*"/>
</input>

Sterling Commerce, Inc. 193


SWIFTNet MEFG Server

</operation>
<operation name="Using Map">
<participant name="Translation"/>
<output message="Xlate_In">
<assign to="map_name">SWIFTNet3rdPartyClientTxsCntr</assign>
<assign to="validate_input">NO</assign>
<assign to="validate_output">NO</assign>
<assign to="output_to_process_data">YES</assign>
<assign to="." from="*"/>
</output>
<input message="Xlate_Out">
<assign to="." from="OUTPUT/node()"/>
</input>
</operation>
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="SendNotification">
<participant name="SWIFTNetClientService"/>
<output message="handleClientRequest">
<assign to="." from="*"/>
<assign to="serviceName">swift.snf.system!x</assign>
<assign to="thirdPartyAuth">TRUE</assign>
<assign to="MessageName" from="/ProcessData/MessageName/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
<onFault>
<sequence name="SWIFTClientOnFault">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<operation name="RefuseDueToTechnicalIssue">
<participant name="SWIFTNetClientService"/>
<output message="handleClientRequest">
<assign to="." from="*"/>
<assign to="serviceName">swift.snf.system!x</assign>
<assign to="thirdPartyAuth">TRUE</assign>
<assign to="AuthDecision">Refused</assign>

Sterling Commerce, Inc. 194


SWIFTNet MEFG Server

<assign to="RefuseReason">Error sending original


notification.</assign>
<assign to="MessageName" from="/ProcessData/MessageName/text()"/>
</output>
<input message="testing">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</onFault>
<onFault code="Mailbox Message Is Not Extractable">
<sequence name="MoveOnToNextMessage">
<assign to="msgCount" from="msgCount+1"/>
<repeat ref="ForEachMessage"/>
</sequence>
</onFault>
<assign to="msgCount" from="msgCount+1"/>
<repeat ref="ForEachMessage"/>
</sequence>
</choice>
</sequence>
</process>

When you send the notification message, the third party must also use the SWIFTNet Client service and
must specify at least three parameters as follows:
✦ thirdPartyAuth must to be set to TRUE to send notification message
✦ AuthDecision must contain a valid value (either Authorised or Refused)
✦ MessageName is the message name for the mailbox
Note: When you call the Mailbox Extract service to extract the message, this name should be available in
ProcessData. If the extraction of the message from mailbox and sending the notification are
configured by the same business process (as was done in this predefined business process), you do
not need to include the MessageName. However, if you use a more complex business process that
invokes other Business Process, you must be careful not to lose the original MessageName.
When you send the notification message, the third party may also specify three optional parameters as
follows:
✦ ToSndrInfo - When the decision is Authorised, this parameter contains the information that the third
party wants to convey to the original sender of the request.
✦ ToRcvrInfo - When the decision is Authorised, this parameter contains the information that the third
party wants to convey to the original receiver of the request.
✦ RefuseReason - When the decision is Refused, this parameter contains the refusal reason that the third
party wants to convey to the original sender of the request.

Sterling Commerce, Inc. 195


SWIFTNet MEFG Server

SWIFTNet MEFG Server Installation


The SWIFTNet MEFG Server installation consists of a sequence of related tasks. This table outlines the
process flow you must follow to install the SWIFTNet MEFG Server:

Task Description For more information


Number

1 Configure SAG/SNL. Configuring SAG/SNL on page 197

2 Install and configure the SWIFTNet remote API. Installing the SWIFTNet Remote API (RA) on
page 199

3 Install OpenSSL software on the SWIFTNet MEFG Obtain the OpenSSL installation software
Server host. (Win32 OpenSSL v0.9.8e Light version) from:
Note: Optional—this is only required if you wish to http://www.slproweb.com/products/Win32Ope
enable SSL support between the application nSSL.html.
and SWIFTNet MEFG Server.
On Solaris 10 and AIX 5.3 machines, the
OpenSSL libraries should be included with
your operating system, although they may be
optionally installed. Please check the
appropriate documentation for your operating
system to ensure the OpenSSL software is
installed.

4 Install the SWIFTNet MEFG Server. Installing the SWIFTNet MEFG Server on
page 204

5 Configure SSL between the application and the Configuring SSL Between the Application and
SWIFTNet MEFG Server. the SWIFTNet MEFG Server on page 200
Note: Optional—this is only required if you wish to
enable SSL support between the application
and SWIFTNet MEFG Server.

6 Install the Command Line Adapter 2 Client, Starting the Command Line Adapter 2 Client
on page 207

7 Configure and enable the SWIFTNet Server Adapter and SWIFTNet Server Adapter
start the SWIFTNet MEFG Server.
Note: To monitor the status of the SWIFTNet MEFG
Server, you need to select Show Advanced
Status when you configure the SWIFTNet
Server adapter.

8 Configure and enable the SWIFTNet Client Service. SWIFTNet Client Service

9 Configure the SWIFTNet routing rule. SWIFTNet Routing Rule

10 Configure Mailboxes (only if you are executing Using Mailboxes


store-and-forward).

11 Configure the SWIFTNetClient business process. SWIFTNetClient Business Process

Sterling Commerce, Inc. 196


SWIFTNet MEFG Server

Prerequisites
The following prerequisites must be met for the SWIFTNet MEFG Server to operate:
✦ The Command Line Adapter 2 client (CLA2Client) must be running to receive commands from the
application to start and stop the SWIFTNet MEFG Server.
✦ The Command Line Adapter 2 client (CLA2Client) must be deployed on the same machine as the
SWIFTNet MEFG Server.
✦ SWIFTNet Remote API (RA) must be installed on the same machine as the SWIFTNet MEFG Server.
✦ The SAG/SNL installed and configured with appropriate message partners and endpoints. See
Configuring SAG/SNL on page 197.
✦ You must have a SWIFTNet Subscription for the InterAct and/or FileAct protocols.
✦ You use the same account to install the SWIFTNet MEFG Server as you used for the SAG/SNL
installation.
✦ You have Java JDK 1.5 installed.
✦ You must install the SWIFTNet MEFG Server on either the Sun Solaris 5.10 operating system,
Windows Server 2003 (Standard or Enterprise Edition) operating system, or AIX 5.3 operating system.

Configuring SAG/SNL
Complete the following steps to configure SAG/SNL for use with the SWIFTNet MEFG Server:
1. Log in as an administrator to the SWIFTAlliance Workstation.
2. Go to Gateway Admin - Application Interface and create the client and server message partners.
Note: The client (type = Client) and server (type = Server) message partner names must match the
names in the SWIFTNet MEFG Server configuration (<SagMessagePartnerClientName> and
<SagMessagePartnerServerName>).
3. In the Application Interface module, for the server message partner, configure the parameters as
follows:

Parameter Configuration

Name Name from the SWIFTNet MEFG Server configuration


(<SagMessagePartnerServerName>).

Type Server

Status Enabled

Unit None

Host Adapter Remote API Host Adapter

Supported Message Select Strict SNL Format.


Formats

Additional Processing Select Remote API Host Adapter.

Sterling Commerce, Inc. 197


SWIFTNet MEFG Server

4. In the Application Interface module, for the client message partner, configure the parameters as
follows:
Note: The Application Interface must be started.

Parameter Configuration

Name Name from the SWIFTNet MEFG Server configuration


(<SagMessagePartnerClientName>).

Type Client

Status Enabled

Unit None

Default Message Format Strict SNL Format


for Emission (from Note: Strict SNL Format is required by the API.
Message Partner)

Supported Message Select Strict SNL Format.


Formats Note: Strict SNL Format is required by the API.

Additional Processing Note: Do not select any additional processing options.

5. In the Endpoints module, for the server message partner, configure the endpoint parameters as follows
to define where to route the messages:

Parameter Configuration

Name Name from the SWIFTNet MEFG Server configuration.

Destination Application Interface:<Name from the SWIFTNet MEFG Server configuration>

Status Enabled

6. In the Endpoints module, for the server message partner, configure the routing detail criteria
appropriately for your installation:

Parameter Configuration

From SWIFTNet Interface

Sequence Note: This is the sequence number.

Name Name for this Endpoint configuration.

Status Enabled

SNL Endpoint None

Service Name None

Request Type None

Requestor DN None

Sterling Commerce, Inc. 198


SWIFTNet MEFG Server

Parameter Configuration

Responder DN None

Traffic Type None

Delivery Mode None

Priority None

7. In the Endpoints module, for the server message partner, configure the destination detail parameters as
follows:

Parameter Configuration

Interface Application Interface

Application Name of the Server Message Partner specified in SWIFTNet Server configuration.

Mode Strict

Installing the SWIFTNet Remote API (RA)


You need to install the SWIFTNet Remote API on the machine on which the SWIFTNet MEFG Server will
be installed. This is the software distributed by SWIFT, the API that the SWIFTNet MEFG Server uses to
connect to the SWIFTNet SAG/SNL instance to link into a SAG. Remote API is software supplied by
SWIFT that establishes a communication link with the RA Host adapter component of the SWIFTAlliance
Gateway (SAG), either from a SWIFTNet application existing on a remote machine or from a SWIFTNet
application existing on the machine where SAG is installed. RA offers two sets of APIs: SWIFTNet
Link-specific APIs and SWIFTAlliance Gateway-specific APIs.
Before you install the SWIFTNet Remote API (RA), verify that you have performed the following:
✦ The SWIFTAlliance Gateway software is installed on the machine you wish to connect with, with the
RAHA option checked in the licensing screen. Otherwise you will only be able to install the RA
locally on the SAG system.
✦ You know the host name or IP address of the machine on which the SWIFTAlliance Gateway software
is installed.
✦ You know the port number used by SAG to communicate with its remote applications. This is the port
number specified during the SAG installation, and its default value is 48002.
✦ You have 300MB of free disk space as working space is available on the machine where you will
install the RA software.
✦ The patch level requirements in the Release Letter from SWIFT are respected. The same patch
requirements apply for both the machines on which RA and/or SAG are installed. This is particularly
important for Java patches.
The following requirements apply to UNIX systems only:
✦ The Remote API installer is graphical and should be run using a dedicated UNIX X display terminal. If
this is not possible or desirable, run the installer using a PC based X server such as Exceed, PC-Xware,
XManager or Reflection-X. It is important that the PC X server is configured to run in single window
mode and uses XDM to start a UNIX desktop session such as CDE. Failure to comply with these

Sterling Commerce, Inc. 199


SWIFTNet MEFG Server

requirements may cause the installer not to display correctly. The method used to configure it in single
window depends on your product. If you are using Exceed software, select Window Mode in the
Xconfig module and toggle the mode from Multiple to Single.
✦ The home directory must have at least 60 MB of free space.
✦ On AIX and Solaris operating systems, if the disk space requirements for the temporary files for the
install program cannot be satisfied, the installer option -is:tempdir <TMPDIR> can be used to
specify an alternate temporary directory.
Complete the following steps to install the RA:
Note: See the SWIFT Remote Developers Toolkit Installation Guide for complete installation instructions.
1. Install the remote API on the machine where you will install SWIFTNet MEFG Server.
2. Configure the RA to point to the SAG instance you will be accessing, or if the RA is already
configured, verify that it points to the correct SAG instance.
3. If you are installing on the Windows operating system, add SYSTEM to the Security settings, allow
SYSTEM Full Control and select Allow inheritable permissions from parent to propagate to this
object. See the documentation for the SWIFTNet Remote API for more information.
a. Right-click and select Properties on <SWIFT RA API installdir>.
b. Select the Security tab.
c. Click Add to and select SYSTEM.
d. Allow Full Control to SYSTEM.
e. Select the Allow inheritable permissions from parent to propagate this object option.
f. To confirm, navigate to the <applicationinstalldir\SWIFTAlliance\RA\lib> directory, and
right-click and select Properties.
g. Select the Security tab.
h. Verify that SYSTEM has Full Control permissions for the
<applicationinstalldir\SWIFTAlliance\RA\lib> directory.
4. If you are installing on a Windows operating system, following the SWIFT RA installation, you will
need to set the PATH system environment variables:
PATH : append <Swift RA API installdir>\bin;<Swift RA API installdir>\lib
SWNET_HOME : <Swift RA API installdir>
SWNET_CFG_PATH : <Swift RA API installdir>\Ra1\cfg;

Configuring SSL Between the Application and the SWIFTNet MEFG


Server
Note: Optional—this is only required if you wish to enable SSL support between the application and
SWIFTNet MEFG Server.

Sterling Commerce, Inc. 200


SWIFTNet MEFG Server

To configure SSL for the SWIFTNet MEFG Server, you must complete the following tasks:

Task Number Description

1 Prepare the SSL certificates for the SWIFTNet MEFG Server.

2 Prepare the SSL certificates for the application.

3 Configure the SWIFTNet Server adapter.

4 Configure the SWIFTNet HTTP Server adapter.

5 Configure the SWIFTNetClient business process.

6 Configuring the SSL Setup on the SWIFTNet MEFG Server

Preparing the SSL Certificates for the SWIFTNet MEFG Server


To prepare the SSL certificates for use with the SWIFTNet MEFG Server, complete the following:
1. Create the keyfile that contains the private key for MEFGCommServer.
You can use OpenSSL to generate the keyfile and certificate request file. Then, you can use this
certificate request to ask the CA to generate the certificate and sign it for you.
Note: Note: When you use OpenSSL to generate the keyfile, you will be prompted to type in the password
to protect the keyfile.
Note: Please take note of this password for later use. (step 8 of Configuring the SSL Setup on the SWIFTNet
MEFG Server).
2. Import the signed certificates into the application CA repository.
3. Note the CA Certificate ID and CA Certificate Name because you will need to use them in the
SWIFTNetClient business process.
4. Create the CA Certificate that contains the cert (public key) for the application side of this
configuration.
Note: You can only do this after you have completed step 3 of Preparing the SSL Certificates for the
application.

Preparing the SSL Certificates for the Application


To prepare the SSL certificates for use with the application, complete the following:
1. Create a self-signed certificate on the application for the System certificate, including the following:
Š Select Set Certificate Signing Bit.
Š The name of this certificate must be the name of your server/domain so that Open SSL can
properly validate the certificate.
Note: Alternatively, you can generate a certificate signing request using the Certificate Wizard, and ask a
CA to sign your certificate. If you choose this option, include the following:
Š Ensure your common name for the certificate matches the correct server name/domain name.

Sterling Commerce, Inc. 201


SWIFTNet MEFG Server

Š Check in the key and the certificate (after the certificate is signed and returned by CA) to System
Certificate.
2. When you create and check in the certificate, note the certificate name. This name will be used when
you configure the SWIFTNet HTTP Server adapter (step 4 below).
3. Export the public key of the certificate you generated above. This public key will be used by the
SWIFTNet MEFG Server (that you created in Preparing the SSL Certificates for the SWIFTNet MEFG
Server on page 201) as CA certificate file (trusted list).
4. Configure the SWIFTNet HTTP Server adapter to use SSL and choose the System certificate you
generated in step 1 of this procedure.
Note: Note the port number of the SWIFTNet HTTP Server adapter because this number must match the
port you configure for the SWIFTNet Server adapter (below).

Configuring the SWIFTNet Server Adapter for SSL


To configure the SWIFTNet Server adapter for SSL, complete the following:
1. Select Deployment > Services > Configuration.
2. Search for SWIFTNet Server adapter or select it from the list and click Go!.
3. Click Edit.
4. For GIS HTTP Server Adapter Port, use the SSL port configured for the SWIFTNet HTTP Server
adapter (above).
5. For GIS Server IP, type your exact server name/domain name. This must match with the
server/domain name and also match the system certificate name you created in Preparing the SSL
Certificates for the Application on page 201.
6. Ensure that Use SSL is set to True.

Configuring the SWIFTNet HTTP Server Adapter for SSL


To configure the SWIFTNet HTTP Server adapter for SSL, complete the following:
1. Select Deployment > Services > Configuration.
2. Search for SWIFTNet HTTP Server adapter or select it from the list and click Go!.
3. Click Edit.
4. Ensure that Use SSL is set to Must.
5. For System Certificate, select the appropriate system certificate.

Configuring the SWIFTNet Client Service or Business Process for SSL


You must either configure the SWIFT Client service through the application user interface or through the
business process you create for the service.
To configure the SWIFTNet Client service for SSL, complete the following:
1. Select Deployment > Services > Configuration.
2. Search for SWIFTNet Client service or select it from the list and click Go!.

Sterling Commerce, Inc. 202


SWIFTNet MEFG Server

3. Click Edit.
4. Ensure that Use SSL is set to Must.
5. For CA Certificate, select the appropriate CA certificate. This is the certificate you imported in step 2
of Preparing the SSL Certificates for the SWIFTNet MEFG Server on page 201.
Alternatively, to configure the SWIFTNetClient business process, add the following to the BPML to ensure
the SSL configuration for the SWIFTNet HTTP Client adapter is included:
Note: The bold lines indicate information that you need to modify to match your installation.
<<operation>
<participant name="SWIFTNetClientService"/>
<output message="handleClientRequest">
<assign to="." from="*"></assign>
<assign to="interfaceMode">interact</assign>
<assign to="swiftOp">sync</assign>
<assign to="requestorDN">o=ptscfrnn,o=swift</assign>
<assign to="responderDN">o=ptscfrnn,o=swift</assign>
<assign to="serviceName">swift.generic.ia!x</assign>
<assign to="SnF">FALSE</assign>
<assign to="nonRepudiation">FALSE</assign>
<assign to="possibleDuplicate">FALSE</assign>
<assign to="deliveryNotification">FALSE</assign>
<assign to="UseSSL">TRUE</assign>
<assign to="CipherStrength">All</assign>
<assign to="CACertId">000.00.000.00:00000:10f3202f455:4337</assign>
</output>
<input message="testing">
<assign to="." from="*"></assign>
</input>
</operation>
Note: The CACertId must match the CA Cert ID you configured for the SWIFTNet MEFG Server (step
2 of Preparing the SSL Certificates for the SWIFTNet MEFG Server on page 201).

Configuring the SSL Setup on the SWIFTNet MEFG Server


Prior to completing the next steps, ensure that you have completed the tasks in Configuring SSL Between
the Application and the SWIFTNet MEFG Server on page 200.
1. Type the following command to change to the directory where the SWIFTNet MEFG Server SSL
Utilityjar is located:
cd <SWIFTNet MEFG Server installdir>/bin
2. Type the following command to invoke the configuration script:
dir *.jar
You will see the sslUtil.jar file.
3. Type the following command:
java -jar sslUtil.jar
4. Type the full path for the SWIFTNet MEFG Server home directory (the directory in which you just
installed the SWIFTNet MEFG Server) and press Enter. You are prompted to confirm the directory.

Sterling Commerce, Inc. 203


SWIFTNet MEFG Server

5. Type Yes and press Enter to confirm. The configuration script verifies the structure of the directory to
ensure that it is the valid installation directory for the SWIFTNet MEFG Server. If the directory is not
valid (for example, the bin directory is missing from the path), you are prompted to retype the valid
directory. Once a valid directory is entered, you proceed with the SSL configuration.
6. Type the full path to the private key location and press Enter. This key file belongs to the SWIFTNet
MEFG Server and will used during the SSL “handshake.”
Note: The key file contains your private key.
7. Type Yes and press Enter to confirm the path.
8. Type the correct password to access the key file and press Enter.
9. Type the password again to confirm it and press Enter.
10. Type the full path to the CA Certificate location and press Enter. This CA Certificate file contains the
trusted certificates that are used during the SSL “handshake.”
11. Type Yes and press Enter to confirm the path. The configuration completes and displays a message
that the SSL configuration process has finished.

Installing the SWIFTNet MEFG Server


Complete the following steps to install the SWIFTNet MEFG Server:
Note: The installation script and the binary install are located on the application installation DVD.
1. After installing the application, log on to your UNIX or Windows system using the same account as
the one you used to install and configure SWIFTNet RA.
2. If you are installing on UNIX system with X-Windows, please ensure that you configure the
X-Windows so the installation user interface can be displayed correctly. If X-Windows environment is
not available, the installation reverts to the command line interface.
3. Download the SCIInstallWizard_swiftnet.jar and swiftnet_[version].jar files from the installation
DVD to the server where the SWIFTNet MEFG Server will be installed.
Note: Replace [version] in the command above with the value from the list that matches the patch you
are installing.
4. Type the following command to invoke the installation script:
java -jar SCIInstallWizard_swiftnet.jar
5. Press Enter.
6. On the SWIFTNet MEFG Server Installer page, click Next.
7. Type the jdk directory which you want to use or click Select Folder to choose the jdk directory.
8. Type the destination directory where you want to install the SWIFTNet MEFG Server or click Select
Folder to choose the installation directory.
9. If you are installing on a Windows operating system, select the Install on Windows check box.
10. Click Next. If the directory does not exist, you are prompted to click Yes to create it.
11. If you are installing on the Windows operating system, you are required to enter the account user name
in the format DomainName\Username. If it is a local user, type .\Administrator.

Sterling Commerce, Inc. 204


SWIFTNet MEFG Server

12. On the Install Jar page, click Select Files to specify the path to the swiftnet_[version].jar installation
jar.
13. If you want to install SSL, select the Install SSL check box.
14. Click Next.
15. If you chose to install SSL, the SSL configuration page is displayed. Complete the necessary
parameters and click Next.
Note: The key file contains the private key to be used during the SSL handshake.
16. On the Install MEFG SWIFTNet Adapter Components page, you can view a summary of the
installation steps that will be performed.
17. Click Next.
The installation script copies files from the installation jar to the destination directory and verifies that
the correct number of files and blocks are copied. If the destination directory does not have enough
free disk space, the script suggests you delete enough files to provide the necessary disk space and then
exits the installation. During the installation process, you can click Show Details to view detailed
information about the progress of the install.
You are notified that the installation is complete with the following message: Installation Finished.
On a Windows system, this installs the following service instances (you can verify this by checking
Control Panel > Administrative tools > Services):
Š MEFGCommServerService1
Š MEFGSwiftnetServerService1_Instance1
Š MEFGSwiftnetServerService1_Instance2
Š MEFGCommSSLServerService1
Š MEFGSwiftnetSSLServerService1_Instance1
Š MEFGSwiftnetSSLServerService1_Instance2
Š MEFGMonServerService1

Sterling Commerce, Inc. 205


SWIFTNet MEFG Server

Note: If you have already installed any of these services, you will be notified through an error message
containing Error Code 1073 that the service or services are already installed. If this occurs, you can
unregister the services as follows and then re-install the SWIFTNet MEFG Server again:
a. Go to <MEFG Server directory>\bin.
b. Double-click unregister_svcs.cmd to unregister all the related services. Or, alternatively, you can
unregister each of the services manually by typing the following and pressing Enter after each
line:
To uninstall the MEFG Comm Server Service, type MEFGCommServer.exe -u
To uninstall the MEFG SWIFTNet Server Service Instance 1, type MEFGSwiftnetServer.exe
-u s1
To uninstall the MEFG SWIFTNet Server Service Instance 2, type MEFGSwiftnetServer.exe
-u s2
To uninstall the MEFG Comm SSL Server Service, type MEFGCommSSLServer.exe -u
To uninstall the MEFG SWIFTNet SSL Server Service Instance 1, type
MEFGSWIFTNetSSLServer.exe -u s1
To uninstall the MEFG SWIFTNet SSL Server Service Instance 2, type
MEFGSWIFTNetSSLServer.exe -u s2
18. If you are installing on a Windows operating system, you must add the following under the System
variables (add the <MEFG installdir>\bin directory to the PATH environment variable just before the
<SWIFT RA API installdir>\bin entry):
Š PATH : append <MEFG installdir>\bin;
Caution: Insert this PATH variable before the SWIFT RA API installdir entries you added in step 4 of
Installing the SWIFTNet Remote API (RA) on page 199 (the PATH variable must appear ahead
of the library references in the System variable list).
Š Allow the defined user to start MEFGSwiftnetServer and MEFGCommServer through the
following steps:
a. Select Control Panel > Administrative Tools > Local Security Settings.
b. Select Local Policies > User Rights Assignment.
c. Double-click Log on as a service and assign the account user (that you entered during the
installation process) to this setting.

Configuring Fail-over Processing Using the SWIFTNet MEFG Server


To set up the SWIFTNet MEFG Server in a dual-active SAG configuration for fail-over processing, specify
the following application interface definitions for the SWIFTNet Server adapter:
✦ active-active Configuration
✦ RA1 definitions for primary SAG (s1)
✦ RA2 definitions for alternate SAG (s2)
Note: Certificates and profiles must be available on the SAG where they are used. For fail-over processing,
Puts and Gets try to connect to the first SAG specified for s1 and s2. If the connection fails, the Put

Sterling Commerce, Inc. 206


SWIFTNet MEFG Server

and Get try to connect to the next SAG. If this connection also fails, the cycle is repeated if retry has
been enabled.

Starting the Command Line Adapter 2 Client


The Command Line Adapter 2 client (CLA2Client) must be installed and run on a remote server. Complete
the following steps to start the remote adapter implementation version of the Command Line Adapter 2:
1. Locate the client jar (CLA2Client.jar) in your application installation that contains the necessary
classes.
2. Move the client jar to the machine that will be running the remote Command Line Adapter 2 client.
Note: This is the machine on which the SWIFTNet MEFG Server is installed.
3. Start the remote adapter implementation using the following command:
[path to java bin]/java -jar [path to CLA2 Client jar file]/CLA2Client.jar
<port> [debug]
Note: The port (above) will be used when you configure the SWIFTNet Server adapter.
This is an example of the command to start the remote adapter implementation:
jdk1.5.0_11/bin/java -jar CLA2Client.jar 15699 debug
Note: The [debug] option is not required, but you may find it helpful. When you upgrade the
application, you will also need to obtain the corresponding new CLA2Client.jar file to avoid receiving
a ClassConflict error.

Monitoring the Status of the SWIFTNet MEFG Server


To monitor the status of the SWIFTNet MEFG Server, you need to select Show Advanced Status when
you configure the SWIFTNet Server adapter:
1. Select Deployment > Services > Configuration.
2. Search for SWIFTNet Server adapter or select it from the list and click Go!.
Note: When you select the SWIFTNet Server adapter, make sure you also select the Show Advanced
Status check box prior to clicking Go!. This enables you to view the Advanced Status column on the
Services Configuration page to see whether the SWIFTNet MEFG Server is stopped or started.
3. Click Edit.
4. Specify field settings in the Admin Console. See SWIFTNet Server Adapter.
5. On the Confirm page, verify that the Enable Service for Business Processes check box is selected.
This enables the adapter instance.

Starting and Stopping the SWIFTNet MEFG Server


To start and stop the SWIFTNet MEFG Server:
1. Select Deployment > Services > Configuration.

Sterling Commerce, Inc. 207


SWIFTNet MEFG Server

2. Search for SWIFTNet Server adapter or select it from the list and click Go!.
Note: When you select the SWIFTNet Server adapter, make sure you also select the Show Advanced
Status check box prior to clicking Go!. This enables you to view the Advanced Status column on the
Services Configuration page to see whether the SWIFTNet MEFG Server is stopped or started.
3. Once the SWIFTNet Client adapter is configured and saved, click the Enabled check box on the
Services Configuration page. This starts the SWIFTNet MEFG Server.
Note: To stop the SWIFTNet MEFG Server, clear the Enabled check box on the Services
Configuration page

Monitoring the SWIFTNet MEFG Server Queues


To monitor the status of the SWIFTNet MEFG Server:
1. Select Operations > SWIFTNet Monitor.
2. To automatically refresh the display, select the Automatically refresh every 15 seconds option.
3. View the status of the SWIFTNet MEFG Server queues.
Note: The status is only populated after you configure the SWIFTNet Server Adapter and start it.

Sterling Commerce, Inc. 208


SWIFTNet Input Channel

SWIFTNet Input Channel


The SWIFTNet 6.1 release introduces the concept of an input channel. Currently, the application only
supports the use of input channel for InterAct messages in store-and-forward (SnF) mode. An input channel
can be used by the messaging interface to establish an input session with SWIFT. The input session starts
when the messaging interface opens the input channel and ends when the messaging interface closes the
input channel. The input channel also supports sender-to-receiver first-in-first-out (FIFO), which means that
each message is delivered only one time and minimizes the number of possible duplicates.
During such an input session, each message that is sent using this input channel is assigned a sequence
number. This numbering is used by SWIFT to detect messages that are out of sequence, gaps in a sequence,
and duplicate messages.
So messages are delivered in the same sequence that they are sent, SWIFT only delivers messages when all
messages with a lower sequence number have been acknowledged by SWIFT. When the acknowledgement
on a message is lost, the messaging interface must resend the message with the original sequence number.
This allows duplicate messages to be more easily identified and avoided by SWIFT.
SWIFT automatically provides a default input channel for each user (BIC8) who is subscribed to at least
one service working in store-and-forward mode. You can optionally create additional input channels when
you have two or more messaging interfaces that operate independently at the same time, because the input
channel can only be used by one messaging interface at a time.

How the Application Supports the Use of Input Channel


To support the use of input channel, the application includes the following functionality:
✦ Ability to create a new input channel
✦ Ability to delete an existing input channel
✦ Ability to open an input channel
✦ Ability to close an input channel
✦ Ability to monitor input channel status. The input channel status resides in an application database
table (SWNET_CHANNEL) to allow the message traffic to be synchronized with SWIFT. Each
operation related to the input channel checks this status before proceeding to the next step.
✦ Support for local processing. If a message was sent when the input channel is closed or down, the
message is stored locally in a database. When the input channel is open again, it is resent to SWIFT.
This local processing support is only available when the message is sent using the input channel.
✦ An automatic process to resend messages. The application provides a predefined scheduler business
process to automate the resend process. This business process checks both unsent messages (stored in
local processing) as well as unacknowledged messages to be resent when the input channel is available
again.
✦ An automatic process to resolve sequence gaps. SWIFT only acknowledges messages when all
messages that have a lower sequence number have been acknowledged by SWIFT. However, when
there is a persistent error, it creates a gap because there is not an acknowledgement for a subsequent
message number, and this error will eventually become a bottleneck. The only way to resolve this gap
is by sending a Resolve Gap request to SWIFT. So, when the application resend attempts exceed the

Sterling Commerce, Inc. 209


SWIFTNet Input Channel

maximum resend attempts setting that you have configured, the application automatically sends the
Resolve Gap request to SWIFT to resolve the gap so SWIFT will then continue processing with the
subsequent sequence number.
✦ Ability to automatic open the input channel when the SWIFTNet Server adapter is started and
closing the input channel when the SWIFTNet Server adapter is stopped. When the SWIFTNet
MEFG Server is started, it triggers a callback to the application that bootstraps a predefined business
process to open the input channel (if you have configured it to use input channel). During the shutdown
process, the SWIFTNet MEFG Server is not stopped immediately. The request to shut down is delayed
to ensure that there is no gap in the input channel and all requests has been acknowledged. Once all
gaps are resolved, the application automatically triggers a predefined business process to close the
input channel and then automatically disables the SWIFTNet Server adapter and shuts down the
SWIFTNet MEFG Server.
✦ Automatic synchronization after the input channel is opened (in force mode) and before the
input channel is closed, to ensure all gaps are resolved and each sequence number is
acknowledged. This also ensures that the messaging interface assigns the correct sequence number for
new messages each time a new input session begins.
✦ Automatic traffic throttling, which is used in conjunction with the input channel status
monitoring to provide an automatic switch to local processing mode when the message traffic
has exceeded SWIFT capacity. The resend scheduler business process handles the resend operation
of the unsent messages when the capacity resume to normal.

Support for Local Processing


If a message is sent when the input channel is closed, down, or during synchronization, the message is
temporarily stored locally in the application database. When the input channel is open, the message is resent
to SWIFT.
Note: This local processing support is only available when the message is sent using the input channel.
Input processing is not supported in a clustered environment.
The SWIFTNet Client service indicates if a message is stored locally in the Advance Status column when
you view the service instance.

Automatic Process to Resend a Message


The resend scheduler automatically handles the resend process for both unacknowledged messages and
unsent messages (from local processing) when the input channel status allows it. The resend scheduler
invokes the predefined SWIFTNetClientResend business process to perform the resend of the message.
You do not need to supply any parameters to the predefined SWIFTNetClientResend business process
because all necessary information is passed dynamically by the resend scheduler. Therefore, all resend
processes are handled automatically.

Automatic Process to Resolve a Sequence Gap


SWIFT only acknowledges messages when all messages with a lower sequence number have already been
accounted for (acknowledged) by SWIFT. However, when there is a persistent error, this creates a gap (no
acknowledgement for the subsequent message number) and may eventually become a bottleneck. The only
way to resolve this gap is to send a Resolve Gap request to SWIFT.

Sterling Commerce, Inc. 210


SWIFTNet Input Channel

When this occurs, the resend scheduler automatically sends a Resolve Gap request when the retry count has
exceeded the maximum retry attempts configured in the SWIFTNet Server adapter. The resend scheduler
invokes the predefined SWIFTNetClientResend business process to send the Resolve Gap request to
SWIFT.
You can track the Resolve Gap request in the SWIFTNet Correlation Search Interface if you wish.

Input Channel Status


Input channel operation relies heavily on the input channel status. Certain statuses trigger automatic
operation while other statuses may prevent an operation from occurring. The statuses maintain message
traffic and synchronize with the SWIFT queue mailbox. The input channel status is stored in the application
database table (SWNET_CHANNEL) and most input channel functions (all functions except the create and
delete operations) check the current value for input channel status before proceeding. You can use the
SWIFTNet Monitor to view the status of the input channels. The following are the possible input channel
status values and their description:

Input Channel Status Description

OPENING This status occurs when the SWIFTNet Client service attempts to open the input
channel. When this status appears, no other opening requests (for the same input
channel name) are allowed. If the client is attempting to send the message, the message
is saved locally. If there is a gap, the status will be updated to OPEN_SYNC. If there is
no gap but there are any local messages that have not been sent, the status is updated
to LOCAL and the Resend Message function is disabled. When all gaps are resolved, the
status is updated to OPEN.

OPEN_SYNC This status occurs when SWIFT indicates that there is a gap that must be resolved by
resending previously unacknowledged messages. Only the Resend Message function is
allowed to operate at this time. If the client is trying to send the message, the message is
saved locally during this time. After all gaps are resolved, if there are local messages, the
status will be updated to LOCAL. If there are no local messages, the status is updated to
OPEN.

OPEN This status occurs when the input channel is open and all gaps have been resolved. This
status also occurs when there are no local messages that have not been sent. Both the
Send Message and Resend Message functions are allowed to send messages within the
allocated window size. If the windows size has reached zero, the status is updated to
SYNC.

SYNC This status occurs when the window size has reached zero and it is time for
synchronization to occur. At this point, the resend handler resend any previous
messages that have not been acknowledged and holds all new messages locally. Only
the Resend Message function is allowed to operate at this time. If the client is trying to
send a new message, the message is saved locally. After all gaps are resolved, if there
are local messages, the status will be updated to LOCAL. If there are no local messages,
the status is updated to OPEN.

Sterling Commerce, Inc. 211


SWIFTNet Input Channel

Input Channel Status Description

LOCAL This status occurs when after the gaps are all resolved (after the OPEN_SYNC or SYNC
statuses have occurred), but there are new messages in local processing that have not
sent. Only the Resend Message function is allowed to operate at this time. If the client is
trying to send a new message, the message is saved locally. Then, if there are no other
local messages, the status is changed to OPEN. However, if the window size reaches
zero during this time, the status is first changed to SYNC.

CLOSE_SYNC This status occurs when the SWIFTNet Client service is attempting to close the input
channel (using a manual close) but there are gaps (messages that have not been
acknowledged) in the Input Channel. Therefore, the status is updated to CLOSE_SYNC
to resolve the gaps before closing. Only the Resend Message function is allowed to
operate at this time. If the client is trying to send the message, the message is saved
locally. When all gaps are resolved, the SWIFTNet Client service sends a Close Input
Channel Request and the status is updated to CLOSING. When the CLOSING
completes successfully, the status is updated to CLOSED.

CLOSE_DOWN This status occurs when the user is attempting to disable the SWIFTNet Server adapter.
If there is a gap in the Input Channel, that gap is resolved before the SWIFTNet Server
adapter is disabled. Only the Resend Message function is allowed to operate at this time.
If the client is trying to send the message, the message is saved locally. When all gaps
are resolved, the SWIFTNet Client service sends a Close Input Channel Request (and
the status is updated to CLOSING). When the CLOSING completes successfully, the
status is updated to CLOSED and the SWIFTNet Server adapter is disabled.

CLOSING This status occurs when the SWIFTNet Client service is attempting to close the input
channel. When this status appears, no other closing requests (for the same input
channel name) are allowed. If the client is trying to send the message, the message is
saved locally and the Resend Message function is disabled. When all gaps are resolved,
the status is updated to CLOSED.

CLOSED This status occurs when the input channel is closed. If the client is trying to send the
message, the message is saved locally and the Resend Message function is disabled.

LOCKED This status occurs when there is an error during the opening or closing of the input
channel, or an error during a message send because the SWIFTNET MEFG Server or
SAG is down.

Monitoring the Input Channels


To monitor the status of the input channels:
1. Select Operations > SWIFTNet Monitor.
2. To automatically refresh the display, select the Automatically refresh every 15 seconds option.
3. Click the Monitor Input Channel link to display the status of the input channels.
Note: The status is only populated after you configure the SWIFTNet Server Adapter and start it.

Configuring the Application Components to Use the Input Channel


You must configure the following three application components to use the input channel:
✦ SWIFTNet Server Adapter
✦ Resend Scheduler

Sterling Commerce, Inc. 212


SWIFTNet Input Channel

✦ SWIFTNet Client Service (including configuring a predefined business process to create a new input
channel)
Although the Resend Scheduler configuration is part of configuring the SWIFTNet Server adapter, we
discuss it separately here to show its importance during the input channel operation.

Configuring the SWIFTNet Server Adapter and Resend Scheduler


To configure the SWIFTNet Server adapter to use the input channel:
1. Select Deployment > Services > Configuration.
2. Search for SWIFTNet Server adapter or select it from the list and click Go!.
3. Click Edit.
4. Specify field settings in the Admin Console.
Note: Specify failover processing to ensure that failover is supported if a SAG connection fails by
configuring Active-Active Configuration. The business entities (accessible through the Business
Entities wizard as part of the SWIFTNet Client adapter configuration) are shared by both RA1 and
RA2. The Business Entities wizard enables you to add multiple entities.

Field Description

Name Unique and meaningful name for the service configuration. Required.

Description Meaningful description for the service configuration, for reference purposes. Required.

Select a Group Select one of the options:


Š None – Do not include the configuration in a service group at this time.
Š Create New Group – Enter a unique name for a new group, which will be created with
this configuration. (You can then add other services to the group as well.)
Š Select Group – If service groups already exist for this service type, they are displayed
in the list. Select a group from the list.
Note: Only select group if this adapter is clustered in a group. See Managing
Services and Services.

GIS Server IP The callback IP of the application for the SWIFTNet MEFG Server. Required.
Note: The default value is the IP address of the machine where the application is
installed.

Sterling Commerce, Inc. 213


SWIFTNet Input Channel

Field Description

GIS HTTP Server This is the listening port for the SWIFTNet HTTP Server Adapter. Required. The default
Adapter Port populated value is the instance port number of the application instance plus 53. For
example, if the application instance port is 34600, the listening port populated by default
is 34653.
Note: The HTTP Server adapter functions between the SWIFTNet Client adapter and
the SWIFTNet MEFG Server. For an SSL connection, this value should be
server name because the certificate is made with the server name.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

MEFG SWIFTNet IP The IP address of the SWIFTNet MEFG Server. Required.

MEFG SWIFTNet Port The port of the SWIFTNet MEFG Server. Required.

CLA2Client Listening The listening port used by the client command adapter (CLA2Client) running along the
Port SWIFTNet MEFG Server. Required.
Note: This port listens for requests to start and stop the SWIFTNet MEFG Server.

MEFG SWIFTNet Home The home directory of the SWIFTNet MEFG Server. Required.

Use SSL Whether to enable Secure Socket Layer (SSL) over HTTP communication between the
application and the SWIFTNet MEFG Server. Valid values are False (default) and True.
Select True to use SSL with an Input Channel.
Note: When you select True, the SSL Details page is displayed. This page allows you
to configure the SSL configuration for the Resend Scheduler and you must
configure the parameters on this page. This is the client component and it
requires client configuration, so you must configure SSL for the SWIFTNet
Server adapter exactly the same as you configure for the SWIFTNet Client
service. The duplicate configuration is necessary because the Resend
Scheduler must be linked to a specific instance of the SWIFTNet Server
adapter.

Cipher Strength Specifies the strength of the algorithms (cipher suites) used to encrypt data. Valid values
are:
Š STRONG - Required if Use SSL is Must
Š ALL - All cipher strengths are supported
Š WEAK - Often required for international trade, because government regulations
prohibit STRONG encryption from being exported
Default is ALL. Required if SSL is checked.

CA Certificate Move one or more CA Certificates to the use column. These are the digital security
certificates that the SSL server will use to authenticate the client. Required if SSL is
selected.

Sterling Commerce, Inc. 214


SWIFTNet Input Channel

Field Description

Message Partner Client The client message partner name that the SNL server application recognizes for the
Name SWIFTNet MEFG Server client application.
Note: The Message Partner Client Name must correspond to the Application
Interface Message Partner that is defined on the SAG as the client interface for
the SWIFTNet MEFG Server.

Message Partner Server The server message partner name that the SNL server application recognizes for the
Name SWIFTNet MEFG Server server application.
Note: The Message Partner Server Name must correspond to the Application
Interface Message Partner that is defined on the SAG as the client interface for
the SWIFTNet MEFG Server.

Delivery Notification Determines whether the server requests a delivery notification when a business partner
is downloading. Possible values are True and False (default). Required.

Delivery Notification The request type of the delivery notification is the value GIS SWIFTNet Server uses in
Request Type the response after getting a request from a remote client. Required.

Active-Active Enables you to set up active-active configuration using two separate instances of the
Configuration Remote API (RA), RA1 and RA2. Each RA should be configured to point to a different
SAG to support failover processing. Possible values are True and False (default).
Required.
Note: This parameter specifies whether to support failover if one SAG fails. When
this parameter is set to True, you are presented with parameters for both an
RA1 Profile and an RA2 Profile.

When you are operating in an environment with multiple SAGs configured in


active-active mode, setting this parameter enables you to define an alternate
RA connection to a secondary SAG for failover support.

SNL Endpoint (for Store The SNL endpoint used to receive data from SnF queues (for example, snl_sft).
and Forward only) Optional—complete only if using store and forward processing.
Note: You must define endpoints on the SAG to route the InterAct messages to the
correct application interface. If you are using store-and-forward, an extra
endpoint is required to route messages coming from the store-and-forward
queue (you can use the default endpoint for store-and-forward, snl_sft).

SnF Monitoring Interval The store and forward monitoring interval (in seconds). Optional.
(in seconds) Note: This parameter enables you to indicate the interval that you want the
SWIFTNet MEFG Server to check on the queue status. The SWIFTNet MEFG
Server sets a timer to send the GetSnFStatusRequest message based on the
value you enter.
Note: This feature is not supported in VMWare due to the manner in which VMWare
delivers timer interrupts. You will need to disable this feature if you notice a
slow down/delay in your system.

Return Signature List Whether you want your own signature returned. Valid values are False (default, which
indicates that normal Crypto is used) and True. Optional for T-Copy and Y-Copy
implementation.

Sterling Commerce, Inc. 215


SWIFTNet Input Channel

Field Description

Use Input Channel (for Whether to use the input channel with this adapter. Valid values are False (default) and
InterAct Store and True. You do not have to select True if you just want to create a new input channel.
Forward only) Required.
Note: Used for InterAct store-and-forward only. If you configure this parameter, the
SWIFTNet MEFG Server opens the Input Channel automatically during the
startup (when the SWIFTNet Server Adapter is enabled). This Input Channel
remains open until the SWIFTNet MEFG Server is shut down (or the
SWIFTNet Server Adapter is disabled). During this time, you still have an
option to send message using the input channel or without the input channel.
All you need to do is to indicate this by using this parameter in SWIFTNet Client
service.

SWIFTNet RA The absolute path of the RA1 installation directory for RA1 SWIFTNet. Required. For
example, /SWIFTAlliance/RA.
Note: This parameter specifies where to pick up the remote API and execute to SAG.

Config The relative path of the RA1 instance configuration directory (relative to the RA
installation directory). Required. For example, RA1/cfg.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Bin This is added to the PATH environment variable to contain the SWIFTNet MEFG Server
binaries. Possible value is bin. Required.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Lib This is added to the library path environment variable. Possible value is lib. Required.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Sterling Commerce, Inc. 216


SWIFTNet Input Channel

Field Description

Category This is the category of RA . Possible values are:


Š RA (SNL facade library to access an SAG)
Š SNL (a native SNL interface)
Š DEFAULT (default set for the RA1 instance)
Required.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Delivery Responder DN The distinguished name of the responder to which delivery notifications requested by the
sender are sent. Optional.
Note: If left blank, Delivery Notifications requested by the server are sent to the
responder indicated in the message; otherwise, it is sent to this responder

Delivery Notification Determines whether the RA1 server is handling a delivery notification. Possible values
are True and False (default). Optional. This is used for a FileAct get.

Delivery Notification DN Distinguished name of the responder of the delivery notification. Optional.

Request Type of Del. Request type of the delivery notification. This is used for a FileAct Get. Required.
Notifn

Send Del. Notifn before Indicates if the server will send a delivery notification before the internal process is
Backend Processing executed. Required.

Event Status Tracking Indicates if the server requires all the FileAct Event statuses to be returned. Valid values
are:
Š Minimal (only Completed, Rejected, Duplicated statuses will be returned)
Š Full (all statuses are returned)
Required.

SWIFTNet RA The absolute path of the RA2 installation directory for RA2 SWIFTNet. Required (based
on Active-Active configuration). For example, /SWIFTAlliance/RA.
Note: This parameter is only displayed if Active-Active Configuration is set to True.

Config The relative path of the RA2 instance configuration directory (relative to the RA2
installation directory). Required (based on Active-Active configuration). For example,
/RA2/cfg.
Note: This parameter is only displayed if Active-Active Configuration is set to True.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Sterling Commerce, Inc. 217


SWIFTNet Input Channel

Field Description

Bin This is added to the PATH environment variable to contain the SWIFTNet MEFG Server
binaries. Required (based on Active-Active configuration).
Note: This parameter is only displayed if Active-Active Configuration is set to True.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Lib This is added to the library path environment variable. Required (based on Active-Active
configuration).
Note: This parameter is only displayed if Active-Active Configuration is set to True.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Category This is the category of RA2. Possible values are:


Š RA (SNL facade library to access an SAG)
Š SNL (a native SNL interface)
Š DEFAULT (default set for the RA1 instance)
Required (based on Active-Active configuration).
Note: This parameter is only displayed if Active-Active Configuration is set to True.
Note: If you are using the SWIFTNet Server adapter in your current installation, prior
to installing a new version of the Standards Library, you need to note the value
you have configured for this parameter. This parameter may be overwritten
during the upgrade process (replaced with the default value). If this parameter
is overwritten, you need to restore it to the original value after the upgrade
process is complete.

Delivery Responder DN The responder to which delivery notifications requested by the sender are sent. Required
(based on activeActive configuration).
Note: If left blank, Delivery Notifications requested by the server are sent to the
responder indicated in the message; otherwise, it is sent to this responder
Note: This parameter is only displayed if activeActive Configuration is set to True.

Delivery Notification Determines whether the RA2 server is handling a delivery notification. Possible values
are True and False (default). Optional. This is used for a FileAct get.

Delivery Notification DN Distinguished name of the responder of the delivery notification. Optional.

Request Type of Del. Request type of the delivery notification. This is used for a FileAct Get. Required.
Notifn

Send Del. Notifn before Indicates if the server will send a delivery notification before the internal process is
Backend Processing executed. Required.

Sterling Commerce, Inc. 218


SWIFTNet Input Channel

Field Description

Event Status Tracking Indicates if the server requires all the FileAct Event statuses to be returned. Valid values
are:
Š Minimal (only Completed, Rejected, Duplicated statuses will be returned)
Š Full (all statuses are returned)
Required.

Input Channel Name The name of the input channel. Required only if you specified True for Use Input
Channel.

Authoriser DN The authorized distinguished name that will be used to open the input channel. Required
only if you specified True for Use Input Channel.

Force Open the Input Whether to force open the input channel or use normal mode. Valid values are False
Channel (use normal mode, which is the default) and True (force the input channel). Required
only if you specified True for Use Input Channel.

Max. Resend Attempts The maximum number of resend attempts allowed before the application automatically
sends a Resolve Gap request to SWIFT. The default is 3. Required only if you specified
True for Use Input Channel.

Run As User Identify a user who has permission to run the scheduled activity. You can type the user
ID, click the button to select the user ID from the list, and click Save.
Note: You must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Use 24 Hour Clock By default, the scheduling wizard displays times using a 12-hour clock (which designates
Display the time in hours as a.m. or p.m.). Use this option to display times using a 24-hour clock.
Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Do not use schedule Removes all references to a schedule from the service. If you select this option, you
cannot enable the schedule in the future. You must recreate the schedule instead. Use
this option only when you do not need a schedule for the service. This is the default
option.
Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Run based on timer Run the service at a certain time or time interval, such as every 2 hours.
Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Select Time Type the time at which you want the Resend Scheduler to run.
Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Sterling Commerce, Inc. 219


SWIFTNet Input Channel

Field Description

Run daily Run the service one or more times every day.
Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Run based on days of Run the service on certain days of the week, such as every Monday.
the week Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Run based on days of Run the service on certain days of the month, such as the 1st or 15th of every month.
the month Note: We recommend that you set the Resend Scheduler to Run based on timer
and set it for one minute under normal usage (that is, every one minute). You
must configure the parameters on the Schedule Type page for the Resend
Scheduler to work correctly.

Schedule Exclusions Allows you to add any schedule anomalies (when the Resend Scheduler should not run).
Note: We recommend you leave this parameter blank (that is, do not create any
schedule exclusions).

Date Exclusions Allows you to add any date anomalies (any date on which the Resend Scheduler should
not run).
Note: We recommend you leave this parameter blank (that is, do not create any date
exclusions).

New Business Entity Click add to create a new business entity or click edit to modify an existing entity.
Note: You must have at least one business entity created to proceed.

Entity Identifies the security context to be used. For the client, the business entity is the
requester. For the server, the business entity is the responder. Required for each
configured entity to access a proprietary SWIFTNet PKI certificate to set up a valid
security context.
Note: This is the distinguished name created by SWIFT. This parameter is only
displayed if you edit an existing Business Entity or add a new Business Entity.
The business entities are shared by both the RA1 and RA2 profiles.

UserId The user identifier for this business entity (to log in to SWIFTNet). Required for each
configured entity.
Note: The UserName is created in SAG (in the Users Module) and must also have a
certificate created for it in the SAG. This parameter is only displayed if you edit
an existing Business Entity or add a new Business Entity.

Password The user password for this business entity (to log in to SWIFTNet). Required for each
configured entity.
Note: This password is automatically encrypted. This parameter is only displayed if
you edit an existing Business Entity or add a new Business Entity.

Delivery Notification Overrides the global delivery notification parameter. Required for each configured RA
(RA1 or RA2). This parameter is not necessary unless there are multiple security
contexts. Valid values are True and False (default). Required.

Sterling Commerce, Inc. 220


SWIFTNet Input Channel

Field Description

Delivery Notification Overrides the global delivery notification parameter. Required for each configured RA
Request Type (RA1 or RA2). This parameter is not necessary unless there are multiple security
contexts. Optional.

Message Queue The name of the store and forward queue from which to receive messages. Required in
Store and Forward mode.

Notification Queue The Name of the store-and-forward queue to retrieve delivery notifications (optional; if
empty, same as Message Queue). Required in Store and Forward mode.

Acquire queue by force Whether to acquire the queue by force. Valid values are False (default) and True.
Required.

Use Default Delivery Indicates whether to use the default delivery notification configuration on the RA1 page.
Notification Required.

Delivery Notification (Del. Indicates whether the sender asked the receiver to send a delivery notification. Optional.
Notifn) Valid values are True (default) or False.
Note: This parameter is only available when Use Default Delivery Notification is
not selected.

Request Type of Del. If Delivery Notification (Del. Notifn) is set to True, the value of this parameter is used to
Notifn request a specific delivery notification message from the remote receiving server
application when it returns the delivery notification. Optional.
Note: This parameter is only available when Use Default Delivery Notification is
not selected.

Reception Directory The full directory path where the file is received and stored during FileAct Put mode.
Required for FileAct. Optional.

Download Directory The full directory path where the file is picked up and sent to the requestor during FileAct
Get mode. Required for FileAct. Optional.

Success Directory The full directory path that must be specified when using the FileAct #OLDEST_FILE
feature. Required for FileAct. Optional.

5. After configuring the SWIFTNet Server adapter in the Admin Console, click the Enable Service for
Business Process check box on the Confirm page to enable the instance.
6. Once the SWIFTNet Server adapter is configured and saved, click the Enabled check box on the
Services Configuration page. This starts the SWIFTNet MEFG Server. You should wait to ensure that
the SWIFTNet MEFG Server starts.
7. On the Confirm page, verify that the Enable Service for Business Processes check box is selected to
enable the adapter instance.

Configuring the SWIFTNet Client Service


To configure the SWIFTNet Client service to be used in conjunction with an input channel:
1. Select Deployment > Services > Configuration.
2. Search for SWIFTNet Client service or select it from the list and click Go!.
3. Click Edit.

Sterling Commerce, Inc. 221


SWIFTNet Input Channel

4. Specify field settings in the Admin Console.


Note: Each instance of the SWIFTNet Client service is configured for a pair of requestor/responder DNs
and the SWIFTNet Client service name.

Field Description

Name Unique and meaningful name for the service configuration. Required.

Description Meaningful description for the service configuration, for reference purposes. Required.

Select a Group Select one of the options:


Š None – Do not include the configuration in a service group at this time.
Š Create New Group – Enter a unique name for a new group, which will be created with
this configuration. (You can then add other services to the group as well.)
Š Select Group – If service groups already exist for this service type, they are displayed
in the list. Select a group from the list.
Note: See Managing Services and Services.

SWIFTNet Interface SWIFTNet message type. Valid values are InterAct or FileAct. Required.

Store and Forward Indicates if the file transfer is done using the store-and-forward method. Valid values are
True (use Store-and-Forward) and False (default—do not use Store-and-Forward).
Required. BPML element value is SnF.

SWIFTNet Operation The SWIFTNet operation to send an InterAct or FileAct message. Possible values are:
Š Synchronous (default)—InterAct
Š Asynchronous—InterAct
Š Put—FileAct (default)
Š Get—FileAct
Required. BPML element value is sync (default) or async for InterAct, or Put or Get for
FileAct.

Requestor DN Distinguished name of the requestor. Required. BPML element value is requestorDN.
Note: This DN must be registered with the SAG instance using SWIFTNet Alliance
Webstation.

Responder DN Distinguished name of the responder. Required. BPML element value is responderDN.
Note: This DN must be registered with the SAG instance using SWIFTNet Alliance
Webstation.

Service Name Name of the service to which both SWIFT correspondents have subscribed. Required.
BPML element value is serviceName.
Note: This must be a SWIFTNet service to which you are subscribed.

Authoriser DN The distinguished name of the authorizing party. Optional.

Sterling Commerce, Inc. 222


SWIFTNet Input Channel

Field Description

This service allows Third Whether this service uses T-Copy or Y-Copy (check your service agreement with
Party Copy SWIFT). Only available for FileAct store-and-forward. BPML element value is
thirdPartyCopy. Valid values are TRUE or FALSE.
This parameter is displayed only if you selected File Act and True for Store and
Forward on SWIFTNet Client Service Interface page.
Note: If the Copy Mode is Y-Copy, the application sends an authorization message,
which is like sending an Interact store-and-forward request. The SWIFTNet
Client service is used, but you must set the This service allows Third Party
Copy parameter to TRUE, and provide the authorization decision (either
Authorised or Refused) for the AuthDecision parameter.

Request for Third Party Whether you are requesting third party copy. When the Copy feature is defined as
Copy Optional in the service agreement, you can choose whether you want the Third Party
Copy to occur. BPML element value is copyIndicator. Valid values are TRUE or FALSE.
Displayed only if you select True for This service allows Third Party Copy.
Note: This parameter is displayed only if you selected True for This service allows
Third Party Copy.

Request for Notification In T-Copy mode, this setting is not applicable, the value should always be set to FALSE.
from Third Party
In Y-Copy mode, when the Authorisation Notification Indicator feature is available
and defined as Optional in the service agreement, you can choose whether you want to
receive the Authorisation Notification messages. BPML element value is
authNotifIndicator. Valid values are TRUE or FALSE. Displayed only if you selected
True for This service allows Third Party Copy.
Note: This parameter is displayed only if you selected True for This service allows
Third Party Copy.

Request Type Request type supported by the message exchange. Optional for InterAct and required for
FileAct in SWIFTNet 6.0. BPML element value is requestType.
Note: In SWIFTNet 6.0 FileAct the format convention is as follows:
<business_area>.<type_of_syntax>.<detailed_syntax_and_format>
This format starts with a four-characters business area code, followed by a period (dot),
followed by a three-character code that designates the type of syntax (which can be
<nnn> , FIN, or xxx), followed by another period (dot), and then followed by a more
detailed indication of syntax and format.

Request Reference User reference of the request. Optional. BPML element value is requestReference.

Non Repudiation Indicates whether non-repudiation is required. Possible values are True (when enabled
Required this means that trading partners cannot deny that they sent a request) or False
(default—when enabled this indicates that non-repudiation is not required). Optional.
BPML element value is nonRepudiation.

Switch to SnF mode Indicates whether you want to switch to store-and-forward mode if a real-time
when real-time transmission (InterAct or a FileAct Put) has failed. Possible values are True or False
transmission failed (default). Required. BPML element value is switchToSnF.

Store and Forward The name of the store-and-forward service. Required when Switch to SnF mode when
Service Name real-time transmission failed is set to True. BPML element value is SnFServiceName.

Sterling Commerce, Inc. 223


SWIFTNet Input Channel

Field Description

End-to-End Signature Whether an end-to-end signature is required. Valid values are False (default) and True.
Required Optional.
Note: You can use an end-to-end signature regardless of whether you are using
non-repudiation (for example, for SWIFT SCORE messages).

Number of Retries Number of retries to connect to SAG. Default value is 3. Optional. BPML element value is
numOfRetries.

Retry Delay (in seconds) Number of delays before the next retry. Default value is 60 (seconds). Optional. BPML
element value is secInRetryDelay.

Trace Trace for logging purposes in the SWIFTNet MEFG Server. Valid values are True and
False (default). Required. BPML element value is trace.

Use Signature List Whether to use a signature list. This enables you to select your own signatures. If you do
not use a signature list then normal Crypto is used. Valid values are False and True.
Required.
Note: This parameter is displayed only if you selected True for End-to-End
Signature Required.

Return Signature List Whether to return a signature list. Valid values are False and True. Required.
If you want a signature list returned, the SWIFTNet MEFG Server receives the
requestor's own signature in the response message. This returned signature will be
extracted and saved as a separate message. This message is stored in the database
and is made available for Correlation search.
Note: This parameter is displayed only if you selected True for End-to-End
Signature Required.

Use RND Whether to use RND (digest reference values that terminate on “and RND”). Valid values
are False (default) and True. Required.
Note: This parameter is displayed only if you selected True for End-to-End
Signature Required.

Delivery Notification (Del. Indicates that the sender asked the receiver to send a delivery notification. Possible
Notifn) values are True or False (default). Optional. BPML element value is
deliveryNotification.
Note: This parameter is only displayed when you select True for Store and Forward
or are performing a FileAct Put. If you are performing a Put operation, you can
request the responder to send you a delivery notification and specify a different
Delivery Notification DN and Request Type of Delivery Notification, if desired.
If you are performing a Get operation, the responder can request Delivery
Notification from the requestor after receiving the file. That setting for delivery
notification is configured through the SWIFTNet Server adapter.

Request Type of Delivery Used to request a specific delivery notification message from the remote receiving server
Notification application when it returns the delivery notification (when Delivery Notification is set to
True). Optional. BPML element value is requestTypeDelNotifn.
Note: This parameter is only displayed when you select True for Store and Forward
or a FileAct Put.

Sterling Commerce, Inc. 224


SWIFTNet Input Channel

Field Description

Message Priority Indicates priority handling in the queue for store-and-forward only. Valid values are
Normal (default) and Urgent. Optional. BPML element value is messagePriority.
Note: This value is used as a selection criterion when delivering messages from a
queue, and in SWIFTNet FileAct to influence the pace of the FileAct flow.

Use Input Channel Whether to use the input channel. Valid values are False (default) and True. Required.
This parameter is displayed only if you selected True for Store and Forward and
InterAct for SWIFTNet interface.
Note: Used for InterAct store-and-forward only. Select True if you are using an input
channel. If you configure this parameter, the SWIFTNet MEFG Server opens
the Input Channel automatically during the startup (when the SWIFTNet Server
Adapter is enabled). This Input Channel remains open until the SWIFTNet
MEFG Server is shut down (or the SWIFTNet Server Adapter is disabled).
During this time, you still have an option to send message using the input
channel or without the input channel. All you need to do is to indicate this by
using this parameter in SWIFTNet Client service.

MEFG SWIFTNet IP The IP address for the SWIFTNet MEFG Server. Required.

MEFG SWIFTNet Port The port for the SWIFTNet MEFG Server. Default is 80. Optional.

Response Timeout The timeout interval (in seconds) in which a response must be received or the message
operation fails. Optional. Default is 60 seconds.

Use SSL Whether to enable Secure Socket Layer (SSL) over HTTP communication between the
application and the SWIFTNet MEFG Server. Valid values are None and Must.
Note: Regardless of the value you select for Use SSL, you must also update the
business processes associated with the SWIFTNet Client service.

Cipher Strength Indicates the strength of the cipher. Possible values are ALL (default), WEAK, and
STRONG. Optional.

CA Certificate The CA certificate of the SWIFTNet MEFG Server.


Note: This is the public key certificate that must be configured to set up the outbound
SSL channel. This page is only displayed if you set Use SSL to Must.
Note: The SWIFTNet Client service Configuration page allows you to select the same
CA Certificate for SSL processing a second time, and continues to allow
additional selections of the same certificate in subsequent edits. If you have
already selected a CA Certificate once for a configuration of the SWIFTNet
Client service, do not select the same CA Certificate again, as this will result in
an error when you execute the relevant business process.

Switch to SnF mode Whether to switch to store-and-forward mode when real-time transmission fails. Select
when real-time True if you want to switch to Store and Forward mode when the real-time transmission
transmission failed (InterAct and FileAct Put) has failed. Valid values are True and False.

Physical Filename Physical name of the file to send. Required if put or get is selected for the SWIFTNet
Operation. BPML element value is physicalFilename.

Logical Filename Logical name of the file to send. This name is communicated to the application
SWIFTNet Server. By default, this name is the Physical Filename without the path.
Optional. BPML element value is logicalFilename.

File Information User information about the file transfer. Optional. BPML element value is fileInfo.

Sterling Commerce, Inc. 225


SWIFTNet Input Channel

Field Description

File Description User description about the file transfer. Optional. BPML element value is fileDesc.

5. On the Confirm page, verify that the Enable Service for Business Processes check box is selected.

Creating a New Input Channel


Each BIC8 that is subscribed to at least one service working in store-and-forward mode has a default/generic
input channel that is automatically created by SWIFT. The number of input channels should be limited and
most users only use the generic input channel because, for most users, the messaging interface uses the same
input channel for all traffic for the different services and applications.
However, if you want to create an additional input channel, a sample business process is provided with the
application.
Note: Any additional input channel may be subject to SWIFT charges, so please contact SWIFT to avoid
any unexpected charges.
To create a new input channel, only need to enable the SWIFTNet Server adapter to start the SWIFTNet
MEFG Server so it can forward the create request to SWIFT. You do not need to configure the SWIFTNet
Server adapter to use the input channel.
This is the sample business process you can use to create a new input channel:
<process name="SWIFTNetCreateInputChannel">
<sequence name="SWIFTNetCreateInputChannel">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"></assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>
<!-- build Create request -->
<operation>
<participant name="SWIFTNetClientService"/>
<output message="createInputChannelRequest">
<assign to="." from="*"></assign>
<assign to="authoriserDN">Put a value here</assign>
<assign to="inputChannelName">Put a value here</assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>
</sequence>
</process>

To create an input channel:

Sterling Commerce, Inc. 226


SWIFTNet Input Channel

1. Edit the sample business process, SWIFTNetCreateInputChannel, and supply the following
parameters:
Š authoriserDN, which must have at least one RBAC role for store-and-forward.
Š inputChannelName, which must be composed of the following:
inputChannelName = domain "_" component ["!" environment]
The domain identifies the institution, (that is, the BIC-8 in lowercase text). The component allows
identification of different input channels for a specified BIC-8, and you can choose this part of the
name. The environment identifies whether the queue is used on ITB, Pilot, or Live, and uses the
same naming conventions as the service name.
Input channel names are always in lowercase text (for example, bankus33_system2!x).
2. After you have finished editing, save the business process.
3. Configure the SWIFTNet Client service and the SWIFTNet Server adapter. You do not have to
configure the SWIFTNet Server adapter to use the input channel; instead, you can select False for Use
Input Channel.
4. Enable the SWIFTNet Server adapter, which starts the SWIFTNet MEFG Server. Wait to ensure that
the SWIFTNet MEFG Server is started.
5. Execute the SWIFTNetCreateInputChannel business process to send the Create Input Channel request.
6. Monitor the execution of the business process. If it is successful, you have successfully created your
new input channel. To start using your new input channel, you must configure the SWIFTNet Server
adapter to use the new input channel name you just created and you must restart the SWIFTNet Server
adapter for the change to occur.

Deleting an Existing Input Channel


Once you delete an input channel, you cannot use it. Therefore, you must be careful when you want to delete
an input channel because all the message history for the input channel must have already expired. We
recommend that you carefully assess whether an input channels might still be in use before deleting it.
Note: The default/generic input channel cannot be deleted.
To delete a new input channel, you do not need to configure the SWIFTNet Server adapter to use the input
channel. You just need to enable the SWIFTNet Server adapter to start the SWIFTNet MEFG Server so it
can forward the delete request to SWIFT.
This is the sample business process to delete an existing input channel:
<process name="SWIFTNetDeleteInputChannel">
<sequence name="SWIFTNetDeleteInputChannel">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"></assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>

Sterling Commerce, Inc. 227


SWIFTNet Input Channel

</operation>
<!-- build Delete request -->
<!-- W A R N I N G N O T E -->
<!-- Once deleted, the input channel cannot be re-created or used anymore -->
<operation>
<participant name="SWIFTNetClientService"/>
<output message="deleteInputChannelRequest">
<assign to="." from="*"></assign>
<assign to="authoriserDN">Put a value here</assign>
<assign to="inputChannelName">Put a value here</assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>
</sequence>
</process>

To delete an input channel:


1. Edit the sample business process, SWIFTNetDeleteInputChannel, and supply the following
parameters:
Š authoriserDN, which must have at least one RBAC role for store-and-forward.
Š inputChannelName, which must be the existing input channel name.
2. After you have finished editing, save the business process.
3. Configure the SWIFTNet Client service and the SWIFTNet Server adapter. You do not have to
configure the SWIFTNet Server adapter to use the input channel; instead, you can select False for Use
Input Channel.
4. Enable the SWIFTNet Server adapter, which starts the SWIFTNet MEFG Server. Wait to ensure that
the SWIFTNet MEFG Server is started.
5. Execute the SWIFTNetDeleteInputChannel business process to send the Delete Input Channel request.
6. Monitor the execution of the business process. If it is successful, you have successfully deleted the
new input channel.

Opening an Input Channel


You can either open an input channel automatically or manually.

Automatically Opening an Input Channel


The SWIFTNet Server adapter allows you to configure an input channel to be opened when the adapter is
enabled.
To open an input channel automatically:
1. Configure the SWIFTNet Server adapter to use the input channel. See Configuring the SWIFTNet
Server Adapter and Resend Scheduler on page 213 for more information.
2. Enable the SWIFTNet Server adapter.

Sterling Commerce, Inc. 228


SWIFTNet Input Channel

3. Access the Current Process page from the Administration menu by selecting Business Processes >
Current Processes so you can monitor the business process execution. The SWIFTNet MEFG Server
triggers a callback to the application which eventually bootstraps the predefined
SWIFTNetOpenInputChannel business process to open the input channel. When both the
SWIFTNetOpenInputChannel business process and the handleSWIFTNetOpenInputChannel business
process have completed successfully, the input channel has been successfully opened. If an error
occurs, you should check the input channel configuration in the SWIFTNet Server adapter.
Once the input channel is open, you can send message using this input channel. The resend scheduler works
automatically in the background until the SWIFTNet Server adapter is disabled.

Manually Opening an Input Channel


You can open the input channel manually if you create and invoke a business process similar to the
SWIFTNetOpenInputChannel business process.
Caution: Do not modify the SWIFTNetOpenInputChannel business process because that may affect your
ability to automatically open an input channel.
The business process you will need to create must rely on the input channel configuration in the SWIFTNet
Server adapter and you must have already configured this adapter with the appropriate input channel
settings.
Note: This manual operation will not function if the SWIFTNet Server adapter is not configured with the
correct input channel settings or the adapter is not enabled.
You may want to manually open an input channel in these circumstances:
✦ When automatically opening the input channel fails because there is a gap in the channel (that is, the
channel was not closed properly) and the SWIFTNet Server adapter was configured to open in Normal
mode, which will cause the open request to fail because it will need to be opened in Force mode. To
resolve this issue, you can manually invoke the SWIFTNetManualOpenInputChannel business process
(see example below) with the Force mode equal to TRUE.
✦ When the SWIFTNet Client service encounters an error when sending a message using the input
channel, and this sets the status to LOCKED. To resolve this issue, you can manually invoke the
SWIFTNetManualOpenInputChannel business process (see example below) with the Force mode
equal to TRUE.
✦ When you close the input channel manually and need to open the input channel again. In this situation
you can manually invoke the SWIFTNetManualOpenInputChannel business process (see example
below) with the Force mode equal to FALSE.
This is the sample SWIFTNetManualOpenInputChannel business process to open an input channel
manually:
<process name="SWIFTNetManualOpenInputChannel">
<sequence name="SWIFTNetManualOpenInputChannel">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>

Sterling Commerce, Inc. 229


SWIFTNet Input Channel

</input>
</operation>
<!-- build Open request -->
<operation name="Service">
<participant name="SWIFTNetClientService"/>
<output message="openInputChannelRequest">
<assign to="." from="*"/>
<assign to="forceOpen">TRUE</assign>
<assign to="serverAdapterName">SWIFTNetServerAdapter</assign>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
</sequence>
</process>

You can supply values for the forceOpen parameter (this is an optional parameter and the default value is
FALSE) and the serverAdapterName parameter (this is an optional parameter and the default value is
SWIFTNetServerAdapter) in the business process above. The forceOpen parameter indicates whether to
open in Force mode (if set to TRUE) and the serverAdapterName parameter indicates where to get the input
channel configuration from (from which instance of the SWIFTNet Server adapter). If you are using the
default SWIFTNet Server adapter, you do not need to specify this parameter.
Note: The adapter must be enabled when you execute this business process.
To open an input channel manually:
1. Configure and enable the SWIFTNet Server adapter.
2. Create a new business process based on the example above and name it
SWIFTNetManualOpenInputChannel.
3. Supply the following parameters in the business process:
Š forceOpen, which indicates whether to open in Force mode (if set to TRUE). This is an optional
parameter and the default value is FALSE.
Š serverAdapterName, which indicates where to get the input channel configuration from (from
which instance of the SWIFTNet Server adapter). If you are using the default SWIFTNet Server
adapter, you do not need to specify this parameter. This is an optional parameter and the default
value is SWIFTNetServerAdapter.
4. After you have finished editing, save the business process.
5. Execute the business process you created, SWIFTNetManualOpenInputChannel, to send the Open
Input Channel request.
6. If the business process successfully completes, the input channel has been opened successfully. If an
error occurs, you should check the input channel configuration in the SWIFTNet Server adapter.
Once the input channel is open, you can send messages using this input channel. The resend scheduler
should work automatically in the background until the SWIFTNet Server adapter is disabled.

Sterling Commerce, Inc. 230


SWIFTNet Input Channel

Closing the Input Channel


You can either close the input channel automatically or manually.

Automatically Closing the Input Channel


The SWIFTNet Server adapter allows the input channel to be closed when the adapter is disabled.
To close an input channel automatically:
1. Disable the SWIFTNet Server adapter and check the message shown on the Service Configuration
page. The message will depend on the current input channel status. For example, if the message
indicates that the status is OPEN and will be disabled automatically after any gaps are resolved, this
means the adapter delayed the shutdown process to ensure that any gaps in the input channel are
resolved and all current messages receive their acknowledgements. The resend scheduler
automatically handles the synchronization during this closing process. Once all gaps are resolved, the
resend handler invokes the predefined SWIFTNetCloseInputChannel business process to close the
channel.
2. You can monitor the Current Process page if you wish. Access the Current Process page from the
Administration menu by selecting Business Processes > Current Processes so you can monitor the
business process execution.
When the business process completes successfully, the input channel is closed successfully, as well. If you
see an error, you may need to check the error details and try to close the input channel manually.

Manually Closing the Input Channel


You can also close the input channel manually (that is, without shutting down the SWIFTNet Server
adapter) by creating and invoking a business process similar to the SWIFTNetCloseInputChannel business
process.
Caution: Do not modify the SWIFTNetCloseInputChannel business process because this may affect the
automatic opening of the input channel.
The business process you create must rely on the input channel configuration in the SWIFTNet Server
adapter and the adapter must be enabled with the appropriate input channel settings.
This is a sample business process to close an input channel manually:
<process name="SWIFTNetManualCloseInputChannel">
<sequence name="SWIFTNetManualCloseInputChannel">
<operation name="set user token">
<participant name="SetUserToken"/>
<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"/>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input>
</operation>
<!-- build Close request -->
<operation name="Service">
<participant name="SWIFTNetClientService"/>

Sterling Commerce, Inc. 231


SWIFTNet Input Channel

<output message="closeInputChannelRequest">
<assign to="." from="*"/>
<assign to="serverAdapterName">SWIFTNetServerAdapter</assign>
</output>
<input message="inmsg">
<assign to="." from="*"/>
</input
</operation>
</sequence>
</process>

To close the input channel manually:


1. Configure (with the appropriate input channel settings) and enable the SWIFTNet Server adapter.
2. Create a new business process based on the example above and name it
SWIFTNetManualCloseInputChannel.
3. Supply the following parameter in the business process: serverAdapterName, which indicates where
to get the input channel configuration from (from which instance of the SWIFTNet Server adapter). If
you are using the default SWIFTNet Server adapter, you do not need to specify this parameter. This is
an optional parameter and the default value is SWIFTNetServerAdapter. This instance of the adapter
must be enabled when you execute the business process.
4. After you have finished editing, save the business process.
5. Execute the business process you created, SWIFTNetManualCloseInputChannel, to send the Close
Input Channel request.
6. If the business process successfully completes, the input channel has been closed successfully. If an
error occurs, it may indicate that your request to close the input channel is pending until any gaps are
resolved. If this occurs, the resend scheduler attempts to resolve any gaps and the input channel will be
closed automatically once all gaps resolved. If you try to send message(s) while the resend scheduler is
processing, the messages are stored on local processing. Once the channel is closed, if you need to
open it again, see Manually Opening an Input Channel on page 229 for more information.

Sending an InterAct Message Using the Input Channel


Once the input channel is open, you can use the SWIFTNet Client service to send messages using the input
channel.
Note: You can only use the input channel to send InterAct messages in store-and-forward mode.
To send an InterAct message using the input channel:
1. Configure the SWIFTNet Client Service (please refer to Configuring the Application Components to
Use the Input Channel on page 212) to use the input channel. You must also be sure that the interface
used is InterAct and store-and-forward mode.
Alternatively, you can pass the necessary parameter through the BPML. The following is a sample
business process that you can use to send messages using the input channel:
<process name="SWIFTNet-IA-Sync-SnF-InputChannel">
<sequence name="SWIFTNetClientService">
<operation name="set user token">
<participant name="SetUserToken"/>

Sterling Commerce, Inc. 232


SWIFTNet Input Channel

<output message="SetUserTokenMessage">
<assign to="USER_TOKEN">admin</assign>
<assign to="." from="*"></assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>

<operation>
<participant name="SWIFTNetClientService"/>
<output message="handleClientRequest">
<assign to="." from="*"></assign>
<assign to="interfaceMode">interact</assign>
<assign to="swiftOp">sync</assign>
<assign to="requestorDN">o=test,o=swift</assign>
<assign to="responderDN">o=test,o=swift</assign>
<assign to="serviceName">swift.generic.iast!x</assign>
<assign to="SnF">TRUE</assign>
<assign to="nonRepudiation">FALSE</assign>
<assign to="deliveryNotification">TRUE</assign>
<assign to="useInputChannel">TRUE</assign>
<assign to="serverAdapterName">SWIFTNetServerAdapter</assign>
</output>
<input message="testing">
<assign to="." from="*"></assign>
</input>
</operation>

</sequence>
</process>

The parameters used in the BPML are very similar to the parameters used to send messages in InterAct
store-and-forward mode without using the input channel.
However, you need to assign a new parameter, useInputChannel, to TRUE if you want to use the input
channel. You also can supply the serverAdapterName parameter (the parameter is optional and the default
value is SWIFTNetServerAdapter). The serverAdapterName indicates from which instance of the
SWIFTNet Server adapter the input channel configuration should be taken. If you are using the default
SWIFTNet Server Adapter, you do not need to specify this parameter.
2. Configure the SWIFTNet Server Adapter (please refer to Configuring the Application Components to
Use the Input Channel on page 212) to use the input channel.
3. Enable the SWIFTNet Server Adapter and monitor the Current Process page to verify that the input
channel is successfully opened.
4. Execute the sample business process above (with the appropriate payload) to send the message using
the input channel.
If an error occurs, the resend scheduler automatically resends the message. If the retry count has exceeded
the maximum retry attempts setting in the SWIFTNet Server adapter, the resend scheduler automatically
sends a Resolve Gap request to notify SWIFT to skip this sequence number and proceed with the subsequent
number.

Sterling Commerce, Inc. 233


Document Tracking for SWIFTNet Transport

Document Tracking for SWIFTNet Transport

Overview
The document tracking support within the SWIFTNet Client service and SWIFTNet Server adapter provides
you with a document-centric view of the whole process of SWIFTNet messaging. This gives you the ability
to monitor the workflow not only from business process point of view, but also from the actual document
point of view. In a single view, you can see how the document is transformed/translated from one form to
another within the application, and how the request and response document correlate with each other.
To enable this feature, all the business processes that are related to the SWIFTNet workflow must have the
Document Tracking option enabled when you check in or edit the business processes. To do so and enable
the framework to track, select the Document Tracking check box on the Process Levels page. Set the
following options as needed and leave the rest of the business process parameters as the defaults:
✦ On the Deadline Settings page, set the deadline and notification options, if necessary.
✦ On the Life Span page, set the life span, if necessary.

Monitoring the SWIFTNet Data Flow


The Data Flow Monitoring feature now enables you to view inbound and outbound SWIFTNet data flows.
For both inbound and outbound, you can correlate and view the transformation of the selected document,
and you can also see the SWIFTNet Message ID that is related to the document.
Note: Message ID is a unique identifier in SWIFTNet that is required to enable the user to discern duplicate
documents—you can tell if a document is a duplicate of another document if the Message IDs of
both documents are the same. The Message ID is extremely useful in enabling you to reconcile
documents.
To perform an advanced search for SWIFTNet business process data flows:
1. From the Business Process menu, select Monitor > Advanced Search > Data Flows.

Sterling Commerce, Inc. 234


Document Tracking for SWIFTNet Transport

2. In the Business Process Monitor Data Flows page, specify any combination of the following search
criteria, as appropriate:

Field Description

Search

Endpoint The remote endpoint of the data flows to search for. Host name or IP address. Optional.

Direction Direction of the data flows to search for. Optional. Valid values are:
Š Inbound
Š Outbound

Protocol Protocol for the data flows to search for. Optional. Valid values are:
Š AS2
Š HTTP
Š FTP
Š SFTP
Š MBI
Š Connect:Direct
Š WebDAV
Š SWIFTNet

Status Current or final status of a data flow. Optional. Select one of the following options:
Š Normal
Š Error

Document Name For data flows associated with a specific document, enter the document name. Optional.

Data Size Range of size of the data transferred to search for. From/To in bytes, KB, MB, or GB.
Optional.

DateRange From – The beginning date and time for data flows to search for
To – The end date and time for data flows to search for
Note: Select the calendar icon to the right of the date to access calendar information.
Optional.

Save search results Enter a string for use in repeating the search in another session. Required.
values by using tag

Sterling Commerce, Inc. 235


Document Tracking for SWIFTNet Transport

Field Description

Results per page Select how many results to display per page. Required. Valid values are:
Š 10
Š 25
Š 50
Š 100
Š 200
Š 250
Š 400
Š 500
Default is 10.

List Directly

By Data Flow ID Type the data flow ID for which you want to search.

3. Click Go! The Monitor page opens, listing the business process data flows that match your search
criteria.
4. Click the Root Document Name corresponding to the data flow you want to view. There are two
different types of data flows:
Š If the Root Document Name is SWIFTNetRequest, it corresponds to an outbound data flow in
which the application is acting as the client making a SWIFTNet request to the SWIFTNet
Alliance Gateway (SAG).
Š If the Root Document Name is PsHttpDocument_node_*, it corresponds to an inbound data flow
in which the application is acting as the server processing the request from the client.

Monitoring the SWIFTNet Communication Session Records


The application creates communication session records for any associated authentication, authorization, file
transfer, or non-file transfer records, even if a document is not transferred and no data flow record is created.
For example, session data can include a user connecting to a mailbox using FTP, receiving messages, and
then quitting the FTP session.
To view SWIFTNet communications sessions records:
1. From the Administration menu, select Business Processes > Monitor > Advanced Search >
Communication Sessions.
Complete the fields using the following descriptions:

Field Description

Endpoint The remote endpoint of the communication sessions to search for. Host name or IP
address. Optional.

Sterling Commerce, Inc. 236


Document Tracking for SWIFTNet Transport

Field Description

Protocol Protocol for the communication sessions to search for. Optional. Valid values are:
Š AS2
Š HTTP
Š FTP
Š SFTP
Š MBI
Š Connect:Direct
Š WebDAV
Š SWIFTNet

Date Range From - The beginning date and time to search for communication sessions
To - The end date and time to search for communication sessions
Note: Select the calendar icon to the right of the date to access calendar information.
Optional.

Principal Search for communication sessions associated with a Principal participant. Optional.

Secure Mode Search for communication sessions in a secure mode. Optional. Valid values are:
Š SSL
Š CCC

Save search results Enter a string for use in repeating the search in another session. Required.
values by using tag

Results per page Select how many results to display per page. Required. Valid values are:
Š 10
Š 25
Š 50
Š 100
Š 200
Š 250
Š 400
Š 500
Default is 10.

List Directly By Communication Session ID

Sterling Commerce, Inc. 237


SWIFT Editor
The application provides you with an online editing interface, the SWIFT Editor, which enables you to
correct a SWIFT message (MT and MX) that was returned due to an error in translation (a validation check
failed) or transmission (including a process failure such as a negative acknowledgement (NAK)). The
application maintains a link between every SWIFT message that is returned for reprocessing and its
historical predecessor, so there is a record of every rejected message all the way back to the initial
submission, including references to each person that modified the message and the return code (error status
and reason).
The SWIFT Editor contains a sidebar on the left side that provides useful information about the document
history and error reports that includes the reasons for an error that occurred.
The SWIFT Editor also enables you to search through the applicable code lists quickly and easily through
the Tools section in the SWIFT Editor, including the following:
✦ SWIFT_Addresses List
✦ SWIFT_BaseAddresses List
✦ SWIFT_IBANFormats Code List
✦ SWIFT_Currencies Code List
✦ SWIFT_Countries Code List
✦ SWIFT_BICPlusIBAN and BICPlusIBAN Code Lists
✦ SWIFT_SEPARouting Code List
✦ NISOLanguage Code List
The editing process requires two different roles (performed by two separate people), per the SWIFT
guidelines. Your system administrator will add the appropriate permission (listed in the table below) to the
user accounts for both roles to enable each role to perform properly.

Role Description Permission Assigned

Editor This is the person who edits a SWIFT SWIFT Message Edit
message.

Reviewer This is the person who submits SWIFT Message Resend


modified messages to be resent.

The combination of both roles provides the “four eyes” validation required by SWIFT.
The editing process is as follows:
1. An e-mail alert is sent to the configured address when an outbound translation has errors during FIN
enveloping or when a NAK is received.
2. The Editor searches for the returned message through the EDI Correlations search (searching for
messages with ReadyForEdit status), and displays the message in the SWIFT Editor.

Sterling Commerce, Inc. 238


SWIFT Editor

3. After the Editor repairs the message (or verifies that it does not need repair) and saves it, a separate
e-mail alert is sent to the address configured for the Reviewer (the person responsible for auditing the
repair and resending the message).
4. The Reviewer receives the e-mail alert and audits the message (looking for messages with
ReadyForResend status). The Reviewer accesses the SWIFT Editor in read-only mode. The error
report specifies the original errors and the modified and/or added fields as links to their position in the
document.
5. After reviewing a repair message, the Reviewer determines how to handle it. The Reviewer can:
Š Reject changes and mark the message for further edit.
Š Abort the repair process entirely.
Š Resend the message using the specified business process.

Editor Tasks
The Editor repairs and saves SWIFT messages that are returned or rejected because of translation or
transmission errors.
The following caveats apply:
✦ The error report displayed in the SWIFT Editor when a Reviewer accesses a repaired document shows
all errors and links them to their position in the SWIFT Editor.
✦ All groups and records can be collapsed and expanded as needed to focus viewing.
✦ Highlighting an error icon in the SWIFT Editor displays the error message for reference.
✦ The SWIFT Editor allows users to modify field values and add or delete instances of repeating groups
and records.

Editing SWIFT Messages


To find messages in Ready to Edit status (Editor role task) so you can edit them:
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
1. From the Administration menu, select Business Process > Monitor > Advanced Search > EDI
Correlation.
2. In the Search Options area, specify the following search criteria, as appropriate:

Field Description Action

All Level Options

Location EDI correlations maintained in a specific Select Live Tables – Display live (active) EDI
location. correlations.

Search Level EDI processing level. Select Transaction – For the search query,
Type display results from the transaction level.

Sterling Commerce, Inc. 239


SWIFT Editor

Field Description Action

Test Mode Mode of the application system where If desired, select one of the following options:
documents that contain the EDI correlations
Š Any (default)
were created.
Š Test
Š Production
Š Information
Š Interchange is a test
Š Syntax only test
Š Echo request
Š Echo response
Optional.

Direction Flow of the documents that contain the EDI If desired, select one of the following options:
correlations.
Š Any (default)
Š Inbound
Š Outbound
Optional.

Sender ID ID for the organization that is sending Type the identifier of the sender. Optional.
documents.

Receiver ID ID for the receiving organization. Type the identifier of the receiver. Optional.

Sender ID Qualifier used with the Sender ID to define the Type the qualifier of the sender. Optional.
Qualifier organization that is sending documents.

Receiver ID Qualifier used with the Receiver ID for the Type the qualifier of the receiver. Optional.
Qualifier receiving organization.

Start Date Documents in progress or completed after the Using the following formats, type a starting date
specified start date and time. and time range and select A.M. or P.M.:
Š Date – MM/DD/YYYY
Š Time – HR:MN:SC
Note: Defaults to a range of the last 24
hours.
Optional.

End Date Documents in progress or completed before Using the following formats, type an end date
the specified end date and time. and time range and select A.M. or P.M.:
Š Date – MM/DD/YYYY
Š Time – HR:MN:SC
Note: Defaults to a range of the last 24
hours.
Optional.

Transaction Level Options

Sterling Commerce, Inc. 240


SWIFT Editor

Field Description Action

Transaction Set ID of the transaction set indicated in the If desired, type the ID of the transaction set.
ID document. Optional.

Compliance Status of compliance checking at the If desired, select one of the following options:
Status transaction set level.
Š Any (default)
Š OK
Š NOT OK
Optional.

Message Repair Status of message repair (for SWIFT Select ReadyForEdit status.
Status documents only).

3. Click Go! to display the EDI correlation records that match your search criteria.
4. For SWIFT documents, on the EDI Correlation Transaction Results page, click info in the Detail
column for the document you want to edit or click the View icon to display the message in read-only
mode. The Read Only dialog displays the business names and their associated components of data, as
opposed to viewing the document to display the raw data of the SWIFT message.Click Close to exit
the Read Only dialog.
5. Next to Document Repair Status, select the ReadyForEdit link to access that message in the SWIFT
Editor.
Note: The Document Repair Status is ReadyForEdit and is a link only if you have the necessary permission
to access and edit the document in the SWIFT Editor. If you correct a failed document and save it,
the status is changed to ReadyforResend and an e-mail is sent to the address specified in the
enveloping.properties property file.
6. Review the errors in the Error Report (left side of the window), select each error link, and repair the
error as necessary. This may include changing the content of the field, or adding or deleting fields.
Note: To add an occurrence of a repeating field or group, select Add at the appropriate point in the message
structure. To delete an occurrence of a field or group, select Delete where appropriate.
7. Click View Text if you want to access a plain text display of the message.
8. When you are finished editing the message, click Validate to validate the message for SWIFT
compliance. If the message contains validation errors, the SWIFT editor retains the message so you
can correct the errors and perform further edits.
9. Once validation is successful, click Save.
10. Review the changes on the Confirm page, and click Finish. This sends an e-mail to the Reviewer,
notifying that the message has been repaired.
11. In the EDI Correlation Transaction Detail Results page, you can view data details such as message
format (MX or MT). If desired, in the EDI Correlation Transaction Detail Results page, click info to
the right of Document Correlations to get more details about the message.
12. In the Document Correlation Details page, view details about the message you selected, and to see the
correlation between the message and corresponding EDI document or data. The details available
include:

Sterling Commerce, Inc. 241


SWIFT Editor

Š time stamp
Š scope
Š process ID
Š document name
Š data value
Note: When you access the returned SWIFT message through the Document Correlation Details page, a
tree-view is displayed on the left to allow you to link directly to the previous version(s) of the
message. The right pane of the tree view displays the correlation details of the SWIFT message.
13. If you want to view the SWIFT message as text, select the document link at the top right of the page.

Reviewer Tasks
The Reviewer repairs and saves SWIFT messages that are returned or rejected because of translation or
transmission errors.
The following caveats apply:
✦ The error report displayed in the SWIFT Editor when a Reviewer accesses a repaired document shows
all errors and links to the position of the error in the SWIFT Editor.
✦ All groups and records in the message can be collapsed and expanded (as needed) to focus your
viewing.
✦ Highlighting an error icon in the SWIFT Editor Change Report (displayed on the left side of the
window) displays the error message for reference.

Searching for SWIFT Messages


To search for messages in Ready to Resend status (Reviewer role task):
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
1. From the Administration menu, select Business Process > Monitor > Advanced Search > EDI
Correlation.
2. In the Search Options area, specify the following search criteria, as appropriate:

Field Description Action

All Level Options

Location EDI correlations maintained in a specific Select Live Tables – Display live (active) EDI
location. correlations.

Search Level EDI processing level. Select Transaction – For the search query,
Type display results from the transaction level.

Sterling Commerce, Inc. 242


SWIFT Editor

Field Description Action

Test Mode Mode of the application system where If desired, select one of the following options:
documents that contain the EDI correlations
Š Any (default)
were created.
Š Test
Š Production
Š Information
Š Interchange is a test
Š Syntax only test
Š Echo request
Š Echo response
Optional.

Direction Flow of the documents that contain the EDI If desired, select one of the following options:
correlations.
Š Any (default)
Š Inbound
Š Outbound
Optional.

Sender ID ID for the organization that is sending Type the identifier of the sender. Optional.
documents.

Receiver ID ID for the receiving organization. Type the identifier of the receiver. Optional.

Sender ID Qualifier used with the Sender ID to define the Type the qualifier of the sender. Optional.
Qualifier organization that is sending documents.

Receiver ID Qualifier used with the Receiver ID for the Type the qualifier of the receiver. Optional.
Qualifier receiving organization.

Start Date Documents in progress or completed after the Using the following formats, type a starting date
specified start date and time. and time range and select A.M. or P.M.:
Š Date – MM/DD/YYYY
Š Time – HR:MN:SC
Note: Defaults to a range of the last 24
hours.
Optional.

End Date Documents in progress or completed before Using the following formats, type an end date
the specified end date and time. and time range and select A.M. or P.M.:
Š Date – MM/DD/YYYY
Š Time – HR:MN:SC
Note: Defaults to a range of the last 24
hours.
Optional.

Transaction Level Options

Sterling Commerce, Inc. 243


SWIFT Editor

Field Description Action

Transaction Set ID of the transaction set indicated in the If desired, type the ID of the transaction set.
ID document. Optional.

Compliance Status of compliance checking at the If desired, select one of the following options:
Status transaction set level.
Š Any (default)
Š OK
Š NOT OK
Optional.

Message Repair Status of message repair (for SWIFT Select ReadyForResend status.
Status documents only).

3. Click Go! to display the EDI correlation records that match your search criteria.
4. For SWIFT documents, on the EDI Correlation Transaction Results page, click info in the Detail
column for the document you want to audit or click the View icon to display the message in read-only
mode. The Read Only dialog displays the business names and associated data components. Click
Close to exit the Read Only dialog.
5. Next to Document Repair Status, select the ReadyForResend link to display the SWIFT Editor.
Note: The Document Repair Status is ReadyForResend and is a link only if you have the necessary
permission to audit the document in the SWIFT Message Editor.
6. Review the changes made in the Change Report (left side of the window), select each link, and review
the change as necessary.
7. When you are finished auditing the entire message, click Next.
8. Specify how you want to handle this message by performing one of the following:
Š Mark this document for further edit (sends the message back to the Editor for further editing).
Š Resend this document (sends the document using the business process you select).
Š Abort (terminates the audit process).
9. If you are resending the message, select the appropriate business process from the Execute Business
Process list. By default it is the SWIFTEnvelope business process.
10. If you want to disable validation prior to resending the message, select Turn Off Validation.
Note: Select this option if you want to send a message that does not conform to SWIFT validation rules.
11. Review the Confirm page, and click Finish.

Setting Default Configuration Options


To set the default configuration options for the SWIFT Message Entry Workstation and SWIFT Editor
(Creator Role Task), perform the following:
1. From the Administration menu, select Business Process > Message Entry Workstation.
2. Under Configure, next to Edit Configuration, click Go!.

Sterling Commerce, Inc. 244


SWIFT Editor

Note: The Edit Configuration option is displayed only if you have the Message Entry Configure
permission added to your user account.
3. In the View Configuration page, review the configuration settings. If you need to edit the settings,
click Go!.
4. In the Edit Configuration page, specify the following details, as required, and click Next:

Field Description

Show - Default send BP Enables you to display a default business process in the user interface for sending
messages. Selecting the check box enables this feature. Optional.

Show - Turn off validation Enables you to allow the user to have the option to disable validation when sending or
resending messages. Selecting the check box enables this feature; clearing the check
box indicates that users cannot turn validation off. Optional.

Default Sender ID Type the default Sender ID BIC so the Sender ID field is automatically populated with this
value when you create a message. The Sender ID BIC is usually the same for every
message. Optional.

Accepter Lookup Alias Enables you to specify that the Accepter Lookup Alias option is not displayed in the
user interface but is instead defaulted to the message format/message type or just the
message type. Select one of the following options:
Š Always provide value (this is the default and indicates that the user will be prompted
to provide the Accepter Lookup Alias value)
Š Use format: MessageFormat_MessageType
Š Use format: MessageType
Note: If you select either of the “Use format” options, the Accepter Lookup Alias
defaults to the format you specify and the user does not have the ability to
override that format.
Optional.

5. Click Next.
6. On the Confirm Configuration page, click Finish.

Sterling Commerce, Inc. 245


SWIFT Message Entry Workstation
The application provides you with the SWIFT Message Entry Workstation functionality that enables you to
create, edit, review, copy, delete, and track a SWIFT message.
The SWIFT Message Entry Workstation enables you to create a new SWIFT message (MT or MX), and to
enter the message data based on the message structure. Additionally, the SWIFT Message Entry
Workstation provides validation functionality that flags syntactical errors that may need to be fixed before
sending the message. The SWIFT Message Entry Workstation also allows you to repair errors in the
message.
The extent of functionality that is available to each user of the SWIFT Message Entry Workstation is
determined by the security permissions that your system administrator assigns to your user account, based
on your role. In the application, each user account has permissions assigned to it, so that the user can perform
necessary functions (for SWIFT Message Entry Workstation, this means that you have the required
permissions to perform necessary actions for SWIFT messages, depending on your role). The message
creation process requires three different roles (performed by three separate people as described in the table
below):

Role Description Permissions that Must be


Assigned to the User Account

Creator This is the person who creates a Š Message Entry Create


message. The Creator can also
validate a message or edit default Š Message Entry Edit
configuration specifications. Š Message Entry Delete
Š Message Entry Copy
Š Message Entry Configuration

Verifier This is the person who can submit Message Entry Review
the created or edited messages to be
sent. The Verifier can also validate
the messages.

Tracker This is the person who tracks the Message Entry Track
history of the messages.

Note: Each time a user adds, modifies, or deletes a message through the SWIFT Message Entry
Workstation, the action is logged to create an audit trail based on the user who performed the event.
Each SWIFT message created through the SWIFT Message Entry Workstation evolves in stages. The
possible statuses of a SWIFT message during this evolution are as follows:
✦ Draft (this is the initial stage and subsequent edits)
✦ Ready to send
✦ Sent
✦ Rejected

Sterling Commerce, Inc. 246


SWIFT Message Entry Workstation

SWIFT Message Entry Workstation Display and Usability Features


The SWIFT Message Entry Workstation uses visual cues to indicate whether a component (group, field, and
so forth) is mandatory or optional, to clearly identify each:

Component Description Displayed With

Mandatory Group Dark Blue Background

Mandatory Choice Blocks Highlighted in Dark Blue

Mandatory Subfield Labels Dark Blue Text

Mandatory Fields and subfield text Dark Blue Label with Yellow Background
boxes

Optional Fields and subfield text Grey Label with White Background
boxes

Mandatory Subfield of an Optional Blue Label with White Background


Parent Block

Also, you can easily access the SWIFT code lists provided with the application, by using the following:
Note: The country codes, currency codes, and code words are available as lists from which you can choose
values. These lists are always available in the Tools section of the SWIFT Editor.
✦ List of the Currencies codes (with description), including Active and Historic currency support for MX
messages.
✦ List of the Countries codes (with description).
✦ Lists for Code Words
Note: Qualifier fields that have a data source name present are treated differently; they have a lookup
associated with code word subfields.
The application provides default values for qualifiers subfields and a default “Start of block” and “End of
block” for fields. Additionally, for date fields you are prompted with a date choice icon (various date
formats defined by MT and MX messages are supported, as well as ISO-8601 Date Time format, which is
used in MX messages). Date validations are also supported, and for Time-only formats the Time format is
displayed next to the text box for the field.

Installing Available Message Types


The application automatically includes the newest versions of SWIFT Message Types, but older versions of
the MT files are available in jar files that are located in the <install_dir>/container/Applications directory.
If you want to create a document using an older version of an MT, you need to first install the jar file that
contains the appropriate MT.
Note: The 2002 version MT messages are available by installing the SWIFT_2005_MEW.jar file.

Installing Older MT Versions


Complete the following steps to install a jar file containing an older version of an MT:

Sterling Commerce, Inc. 247


SWIFT Message Entry Workstation

Note: The jar files are located in the <install_dir>/container/Applications directory.


1. Locate the jar file for the version of MT you want to create.
2. Navigate to the <install_dir>/bin directory and type the following command to invoke installation
script:
./InstallService.sh [version].jar
Note: Replace [version] in the command above with the name of the jar file containing the appropriate
version of the MT. The jar file are named in the format SWIFT_<year>_MEW.jar.
3. Press Enter.
You are notified that the installation is complete.

SWIFT Message Creation Process


The message creation process is as follows:

Task Process

1 The Creator logs in to the application and the user permissions assigned to the Creator are loaded.

2 Using the SWIFT Message Entry Workstation, the Creator creates a new SWIFT message or
searches for a SWIFT message which is in Draft state for further editing.
Note: When you create a new message, your Sender ID value is populated by default with the
value specified on the Configuration page.
Note: The application automatically includes the newest versions of SWIFT Message Types, but
older versions of the MT files are available in jar files. See Installing Available Message
Types on page 247 for information on how to install older MT versions if you need to create
messages using those versions.

3 After the Creator creates the message, he or she can validate the message to check for SWIFT
compliance and mark the message as MARK AS READY TO SEND.

4 The Verifier reviews the message and can also perform the following tasks:
Š Reject the message and mark the message for further edit, including the reasons for rejection (if
desired).
Š Send the message, which invokes the business process (SWIFTMessageEntryOutbound is the
default). Once the business process is invoked, the scope of Message Entry Workstation ends.
Note: If you want to disable validation prior to sending the message, select Turn Off Validation.

5 If the message is rejected by the Verifier, the Creator can edit the changes using the SWIFT Editor
and then mark the message as Ready for Resend, and the Verifier can again mark it as Reject or
Send.

6 The Tracker can track the history of the message and review the modifications that were made to the
message, including the user who made each change (along with any remarks noted about why a
change was made). Also the tracker can view the raw data for the message, regardless of the
message status.

Sterling Commerce, Inc. 248


SWIFT Message Entry Workstation

Creating a SWIFT Message


To create new messages in the SWIFT Message Entry Workstation (Creator Role Task):
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
1. From the Administration menu, select Business Process > Message Entry Workstation.
2. Under Create, next to New Message, click Go!.
Note: The New Message option is displayed only if you have the Message Entry Create permission added
to your user account.
3. In the Select New Message page, enter the following details, as required, and click Next:

Field Description

Message name The name of the SWIFT message. Required.

Sender ID Identifier for the organization that is sending this SWIFT message. Optional.
Note: The Sender ID value is required for some SWIFT messages since this value is
used to perform validation against your data.
Note: When you create a new message, your Sender ID value is populated by default
with the value specified on the Configuration page.

Receiver ID Identifier for the organization receiving this SWIFT message. Optional.
Note: The Receiver ID value is required for some SWIFT messages since this value
is used to perform validation against your data.

4. In the Select Message Information page, enter the following details (as required), and click Next.

Field Description

Standard The standard required to create the SWIFT message.

Standard Version The version of the standard required to create the message.

Message Type The type of message being created.

5. In the Confirm page, click Finish. This launches the SWIFT Editor to enable you to type the values in
the required parameters to create the new SWIFT message.
Note: Any data typed for the Optional Repetitive Group is displayed under the Added Groups section
in the Confirmation page. To add an occurrence of a repeating field or group, click Add at the
appropriate point in the message structure. To delete an occurrence of a field or group, click Delete
where appropriate.
6. In the SWIFT Editor page, click View Text if you want to access a plain text display of the message.
7. In the SWIFT Editor page, the Validate function enables you to validate the message for SWIFT
compliance so that you can avoid translation errors during enveloping.

Sterling Commerce, Inc. 249


SWIFT Message Entry Workstation

8. If any errors occur during validation, review the errors in the Validation Report (left side of the
window), select each error link, and repair the error as necessary (repairing may include changing the
content of the field, or adding or deleting fields).
Note: If a SWIFT pass-through map generates the maximum number of translation errors on the input side
of the map, it is possible that the output side of the map contains translation errors that are not
reported since error processing stops once the maximum number of errors is reached. In this
scenario, an error report is not displayed when the output message data is edited through the Message
Entry Workstation and EDI Correlation Search, but the message has not been sent due to translation
errors and no errors are displayed in the report for the Message Entry Workstation. So, to see
validation errors for the output message data, click Validate once the message is loaded in the
Message Entry Workstation. Then, you can make any necessary fixes and resend the message.
9. You can either save the message for further edits by selecting the SAVE option or submit the message
for review by selecting the MARK AS READY TO SEND option. When the action is completed
successfully, you are prompted with the following message: “The system update completed
successfully.” Once a message status is Ready to Send, the message can be reviewed by the Verifier.
10. An e-mail alert is sent to the Verifier when the status of the message is changed from DRAFT to
MARK AS READY TO SEND. The e-mail address of the Verifier is specified in the
messageentryworkstation.properties.in property file. Any changes to this e-mail address can be
done by editing the customer_overrides.properties file in the following format:
messageentry.SWIFT.READY_TO_SEND.<username> = e-mail address of the verifier, where
username is the user who marks the messages as MARK AS READY TO SEND.
Note: If there is no e-mail address specified in the entry
messageentry.SWIFT.READY_TO_SEND.<username> the system searches for the e-mail
address specified in the entry messageentry.SWIFT.READY_TO_SEND.default. All
ReadyToSend messages will be directed to this e-mail address. By default this is the e-mail address
of the system administrator.
11. In the Confirm page, after you have selected the status of the message, click Finish.
Note: In the Confirm page, you can also click View Text to access an XML display of the message.

Searching for a SWIFT Message


SWIFT Message Entry Workstation enables you to easily search for messages as follow:
1. From the Administration menu, select Business Processes > Message Entry Workstation.
The parameters described in the Search Parameters table are displayed.

Search Parameters
The following table describes the search parameters displayed on the Message Entry Workstation page.

Sterling Commerce, Inc. 250


SWIFT Message Entry Workstation

Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
T

Field Description Action

Message Name The name used for the SWIFT Type the name of the SWIFT
message. message for which you are
searching.

Standard The standard used for the SWIFT Select the SWIFT standard used for
message. creating the message.

Standard Version The version used for creating the Select the standard version used for
SWIFT message. the SWIFT message.

Message Type The type of message being created. Select the type of message that was
used to create the message.

Sender ID Identifier for the organization that is Type the identifier of the sender.
sending the SWIFT message.

Receiver ID Identifier for organization receiving Type the identifier of the receiver.
the SWIFT message.

Author The user who created the message. Type the name of the person who
created the message.

Message Status Status of the message. Select the status of the message
from the following options:
Š DRAFT
Š READY TO SEND
Š SENT
Š REJECTED

Start Date Documents in progress or completed Using the following formats, type a
after the specified start date and starting date and time range and
time. select A.M. or P.M.:
Š Date – MM/DD/YYYY
Š Time – HR:MN:SC
Note: Defaults to a range of the
last 24 hours.

End Date Documents in progress or completed Using the following formats, type an
before the specified end date and end date and time range and select
time. A.M. or P.M.:
Š Date – MM/DD/YYYY
Š Time – HR:MN:SC
Note: Defaults to a range of the
last 24 hours.

2. Depending on the search criteria, the Search Result page displays various parameters as follows:

Sterling Commerce, Inc. 251


SWIFT Message Entry Workstation

Search Results Parameters

Field Description

Select Enables the Creator to copy, edit, delete, or get information of a message.

Name Displays the name of the message.

Standard Displays the SWIFT message standard.

Version Displays the version of the SWIFT standard.

Type Displays the type of SWIFT message.

Sender ID Identifier for the organization that is sending the SWIFT message.

Receiver ID Identifier for the organization receiving the SWIFT message.

Created On Displays the date and time when the message was created.

Status Displays the status of the message.

Note: If there are no messages found using the search criteria you specify, the message “No Messages
match your search criteria” is displayed.
3. Depending on the results displayed for the message for which you searched, you can click copy, edit,
delete, or info from the Select Field for that SWIFT message.
4. If you click info, you can select View to display the message, including the business names and
associated data components. Click Close to exit the Read Only dialog.
5. Click Return to return to the main page of the SWIFT Message Entry Workstation.

Verifying SWIFT Messages


The Verifier may not create messages using the SWIFT Message Entry Workstation, but may only verify
and validate existing messages.
The following caveats apply to the Verifier role:
✦ The Verifier uses the SWIFT Editor in read-only mode.
✦ All groups and records in the message can be collapsed and expanded (as needed) so you can focus
your viewing of specific parts of the message.
✦ Clicking info in the Change Report (displayed on the left side of the SWIFT Editor page) displays the
details of the changes made for reference.
Note: When you view a change report in the Message Entry Workstation, if you select the error code link
it may not direct you to the field with the error. If this occurs, select the field link instead of the error
code link.
To search a message, the verifier performs the following actions:
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page

Sterling Commerce, Inc. 252


SWIFT Message Entry Workstation

1. From the Administration menu, select Business Process > Message Entry Workstation.
2. The Verifier searches for a SWIFT message based on the search criteria described in Search
Parameters on page 250.
3. After searching for a SWIFT message (using the procedure for searching a message as described in the
section Searching for a SWIFT Message on page 250), select it and click Send. The SWIFT Editor is
displayed in read-only mode.
4. When you are finished auditing the entire message, click Next.
5. In the Confirm page, specify how you want to handle this message by performing one of the following
options:
Š Select the action Send to invoke a business process. The default business process is
SWIFTMessageEntryOutbound). This business process looks up the envelope that is used to send
the message.
Note: If during the message creation process, the Sender ID and Receiver ID were specified for the
message, the values for those parameters are automatically populated to these fields and you are
unable to modify the values.
Š Select the action Reject (optionally, you can provide reason for rejection). The Reject action
updates the message to Rejected status. For each Rejected message, the Creator must make the
necessary edits prior to marking the document Ready for Resend.
Note: By default, the business process used for Execute Business Process is
SWIFTMessageEntryOutbound, which is specified in the
messageentryworkstation.properties.in property file. If you want to specify a different business
process, you must add the name of that business process to the customer_overrides.properties file in
the following format: envelope.messageentry=NameOfBusinessProcess (where
NameOfBusinessProcess is the name of the business process).
6. Review the Confirm page and click Finish.
Note: The Verifier can only access documents with Ready to Send status. The Verifier is not able to take
any action on a message with any other status.
7. An e-mail alert is sent when the status of the message is changed from READY TO SEND to
REJECTED. The e-mail alert is sent to the user who last modified the message (not necessarily the
user who created it). An e-mail address is specified for each user when the system administrator
creates the user accounts.
Note: If no e-mail address is specified for the user who last modified the message, the system checks for
the e-mail address specified in the messageentryworkstation.properties.in property file. If neither
e-mail address is specified, the system searches for the e-mail address specified in the entry
messageentry.SWIFT.REJECT.default which is available in the
messageentryworkstation.properties.in property file. By default, this is the e-mail address of the
system administrator. You can change this e-mail address by editing the
customer_overrides.properties file in the following format:
messageentry.SWIFT.<username>.mailid = e-mail address of the Creator or the person who last
edited the message, where username is the user who marks the message as REJECTED.

Sterling Commerce, Inc. 253


SWIFT Message Entry Workstation

Tracking SWIFT Messages


A Tracker can track the history of a message and view the changes made by each user. The Tracker can also
view the raw data for the different message statuses.
In order to track a message, the Tracker must perform the following actions:
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
1. From the Administration menu, select Business Process > Message Entry Workstation.
2. The Tracker searches for a message based on the search criteria as described in the Search Parameters
on page 250.
Depending on the search criteria you specify, the Search Result page displays various parameters as
described in Search Results Parameters on page 252.
3. In the Message page, click info next to the appropriate message to display the following details:

Field Description

Document Click info to view the raw data for the message.

Modified on The date the message was modified.

Modified by The user who modified the message.

Status The status of the message after modification.

Remarks Remarks made by a user or by the system, if any.

View Click the View icon to display the message in read-only mode. The Read Only dialog
displays the business names and associated data components. Click Close to exit the
Read Only dialog.

Deleting a Message
The SWIFT Message Entry Workstation allows you to delete a message if you have the appropriate
permission assigned to your user account. Both the Creator and the Verifier are able to delete messages.
To delete a message, you must perform the following actions:
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
1. From the Administration menu, select Business Process > Message Entry Workstation.
2. Search for a message based on the search criteria described in Search Parameters on page 250.
Depending on the search criteria you specify, the Search Result displays various parameters as
described in Search Results Parameters on page 252.

Sterling Commerce, Inc. 254


SWIFT Message Entry Workstation

Note: You must select the Delete function from the Select menu in the same row as the message that you
want to delete. You are prompted with a delete confirmation window.
3. Click OK to delete the message.
4. In the Delete Resources page, review the following message details to ensure you are deleting the right
message and click Next:

Field Description

Message Name Displays the name of the SWIFT message that you want to delete.

Standard Displays the SWIFT message standard.

Standard Version Displays the version of the SWIFT standard.

Message Type Displays the type of SWIFT message.

Created On Displays the date and time when the message was created.

Created By Displays the name of the user who created the message.

Current Status Displays the current status of the SWIFT message.

5. In the Confirm page, click Delete. When the deletion is complete, the message “the system update
completed successfully” is displayed.
6. Click Return to return to the main page of the SWIFT Message Entry Workstation.

Copying a Message
The SWIFT Message Entry Workstation allows you to copy a message if you have the Message Entry Copy
permission assigned to your user account.
To copy a message, you must perform the following actions:
Note: If you click Cancel in the SWIFT Document Editor, you will be asked for a confirmation. Click Yes
on the Confirmation dialog box and a Cancel screen with a status bar is displayed. Once the status
of the cancellation is complete, click Return to return to the main page
1. From the Administration menu, select Business Process > Message Entry Workstation.
2. Search for a message based on the search criteria described in Search Parameters on page 250.
Depending on the search criteria you specify, the Search Result displays various parameters as
described in Search Results Parameters on page 252.
Note: You must select the Copy function from the Select menu in the same row as the message that you
want to copy.
3. Click Copy to display the Copy Message page. Enter the following details, as required, and click
Next:

Field Description

Message Name The name of the copy of the SWIFT message. Required.

Sterling Commerce, Inc. 255


SWIFT Message Entry Workstation

Field Description

Sender ID Identifier for the organization that is sending the SWIFT message. Optional.
Note: The Sender ID value is required for some SWIFT messages since this value is
used to perform validation against your data.

Receiver ID Identifier for the organization receiving the SWIFT message. Optional.
Note: The Receiver ID value is required for some SWIFT messages since this value
is used to perform validation against your data.

Note: The status of a copied message is independent from the status of the source message. For example,
if the source message was in Draft status when a copy of the message was made, the copied message
continues to show the status as Draft even if the status of the source message has since changed to
Sent or Rejected.
You are prompted with a Copy Message confirmation window with the following details:

Field Description

Message Name Displays the name of the copied SWIFT message.

Copy of Message Displays the original SWIFT message name from which the copy was created.

Standard Displays the SWIFT message standard.

Standard Version Displays the version of the SWIFT standard.

Message Type Displays the type of SWIFT message.

Sender ID Identifier for the organization that is sending the SWIFT message.
Note: If a Sender ID was not specified when you created the copy, this parameter
contains the indicator Not Provided.

Receiver ID Identifier for the organization receiving the SWIFT message.


Note: If a Receiver ID was not specified when you created the copy, this parameter
contains the indicator Not Provided.

4. Click Finish to create a copy of the SWIFT message. Once the copy is successfully created, the
message “The system update completed successfully” is displayed.
5. Click Return to return to the main Message Entry Workstation page.

Sterling Commerce, Inc. 256


SWIFT Error Codes

Overview
The Translation service produces a Translation Status report. The report contains information about the
translation of the document and any compliance errors. Errors from the input side of the map are listed under
the Input tab. Errors from the output side of the map are listed under the Output tab.
Compliance errors can also be specified with the extended rule cerror.
This section describes translation status errors and error codes that may be generated when using SWIFT.
Note: Please refer to the specific sections of the SWIFT documentation (parts II and III) to view the details
of how field tag and code word validation is performed for all field tags.

Text Validation Error Codes


The following table contains the error codes for SWIFT text validation:

SWIFT Error Code Translator Report Error Description


Error Number

M50 901 Message length exceeded

M60 902 Non-SWIFT character encountered (a character not included in the


<X>, <Y>, <Z> character sets. Also see error code T32.)

T01 904 Code word error. This check applies to:


Š Field 39B in MT700,705,707,710,720,740,747.
Š Field :22H:COAL subfield 3 in MT503,504.

T02 905 Unable to determine the reason for NAK. Please contact your CSC
immediately for advice.

T03 906 Code word error. This check applies to:


Š Field 26C, subfield 3, in MT600,601,604,605,606,607,608,609.
Š Field 38B, subfield 1, in MT405.
Š Field :22H:COLA subfield 3 in MT503,504,505,506,507.

T04 907 Code word error. This check applies to:


Š Field 26C, subfield 4, in MT600,601,604,605,606,607,608,609.
Š Field 38B, subfield 2, in MT405.
Š Field :22H:COLA subfield 3 in MT503,504,505,506,507.
Š Field :22H:REDE subfield 3 in
MT528,529,536,537,548,575,578,584,586.

Sterling Commerce, Inc. 257


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T05 908 Code word error. This check applies to:


Š Field 68B, subfield 4, in MT609.
Š Field 38B, subfield 3, in MT405.
Š Field :22H:DEPO subfield 3 in MT503,504,505,506.

T06 909 Code word error. This check applies to:


Š Subfield 1, field 32F
Š Subfield 5, field 68B,68C
Š Subfield 3, field 60F,60M,62F,62M,64,65 in MT608 or in any
message appended in common groups n92,n95,n96.

T07 910 Code word error. This check applies to:


Subfield 3, field 33G.
Field :22H:INOU subfield 3 in MT503,505,527,558.

T08 911 Code word error. This check applies to:


Š Field 23, in MT102_STP,609.
Š Field 26G, in MT550, or in any message appended in common
groups n92,n95,n96.
Š Field 71A in
MT100,101,102,103_not_STP,103_STP,104,107,405,740, or in
any message appended in common groups n92,n95,n96.
Š Field :22H:REPR subfield 3 in MT527,558,569.

T09 912 Code word error. This check applies to:


Š Subfield 3, field 23 in MT305,601.
Š Subfield 3, field 68C in MT609, or in any message appended in
common groups n92,n95,n96.
Š Field :25D:COLL subfield 3 in MT507 when Data Source Scheme
(DSS) is not present.

T10 913 The repetitive sequence occurred more than the maximum number of
times permitted.

T11 914 The repetitive sequence occurred less than the minimum number of
times required.

T12 915 Field, line, subfield, or component content error. Or, the format
Reject/Return is not allowed for field 72 in this MT. Or, when "ISIN" is
used at the beginning of line one in field 35B it must never be
composed of lower-case letters, nor a mix of upper and lower-case
letters. Or, in the ISITC MT521 or MT523 in field 35B the second line is
mandatory and must not begin with any of the code words defined for
the third and subsequent lines.

Sterling Commerce, Inc. 258


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T13 916 The field tag is not expected at this location in this MT. Either a
mandatory field is missing, the sequence of fields is not correct, the
specified field is not allowed at this point in the MT, or the specified field
is not a defined SWIFT field (for example, the field tag is invalid), an
end-of-text sequence (CRLF-) was encountered when it was not
expected, or more than one end-of-text sequence occurs in this
message.
Or in a common group message (i.e. n92,n95,n96) within the list of
"Copy of any field(s) of the original message", there are generic fields
and non-generic fields that are not allowed to be mixed in the same
message.
Or in one of the following ISO15022 messages: MT502, 503, 504, 505,
506, 507, 508, 509, 513, 514, 515, 518, 524, 527, 528, 529, 530, 535,
536, 537, 538, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 558,
564, 565, 566, 567, 568, 569, 575, 576, 578, 584, 586, 587, 588, 589,
an optional sequence of fields was used, however a field or field
qualifier which is required within that sequence is missing, or field 16R
is present but its related code word is inappropriate.
Or in a qualifier table, for a particular generic field, in a "repeatable"
order, there is a list of "OR" qualifiers but more than one qualifier has
been used in the repetitions of the generic field in this sequence.

Sterling Commerce, Inc. 259


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T14 917 Subfield[N] (negative indicator) must not be used when the amount,
number, or number count component is equal to zero. This check
applies to:
Š Field 19A in
MT502,513-515,518,527-529,535-537,540-548,558,564,566-567,
569,575,578,584,586-588.
Š Field 32H in MT306, 320,330,340, 362,571.
Š Field 32N in MT646.
Š Field 33N in MT646,
Š Field 34E in MT320,330,341,571.
Š Field 34N in MT646
Š Field 35H in MT571,581.
Š Field 37G in MT320,330,362,644.
Š Field 37M in MT340,341,362,644.
Š Field 37R in MT341,360,361,362,644.
Š Fields 60A,62A,62B in MT572.
Š Field 60B in MT571,572.
Š Field 92A in
MT502,506,513-515,518,527-529,540-547,558,564-566,568-569,
576,578,584,586-588.
Š Field 92E in MT564,566.
Š Field 93B in MT535,536,564-566,568.
Š Field 93C in MT535,564-566,568.
Š Field 93D in MT575.
Š Field 98D in MTs 564, 566.
Š Field 98E in MTs 513-515, 518, 528, 529, 540-548
Š 578, 586.Field 99A in
MT506,513-515,518,528-529,535-536,540-547,569,575,578,586.
Š Any of the above fields in common groups n92,n95,n96.

T15 918 Sign is not valid. <SIGN> must be either '+' or '-'.

T16 919 Time offset is not valid. <OFFSET> has the same format as time
<HHMM>.

T17 920 Field, line, subfield, or component consists of blanks, <CRLF>, or it is


missing a mandatory line, subfield, or component.

Sterling Commerce, Inc. 260


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T18 921 Component is not in the format 3!n and/or it is not within the range
100-999. This check applies to:
Š Field 11R,11S: the first component must have the format 3!n and
must be within the range 100-999.
Š Field 12, and MT105,106: this component must have the format 3!n
and must be within the range 100-999.
Š Field 12, and MT NOT=(M105,106): this component must have the
format 3!n.
Š Refer to T88 for additional special exception checking.
Š Field 61: if the first character of subfield 6 is 'S' then the next three
characters must have the format 3!n and must be within the range
100-999.

T19 922 Code word error. This check applies to:


Š Subfield 1 of field 87E,87F.
Š Field :25D:4!c//<Status> subfield 3 (Status) in MT507 when Data
Source Scheme (DSS) is not present.
Š Field :22H:4!c//<Indicator> subfield 3 (Indicator) in MT 307,321.

T20 923 Code word error in subfield 1, component 3, of field 32K or 33K.

T21 924 (Available).

T22 925 A common reference mismatch exists between field 22, subfield 2,
component 2 and one of the following:
Š Field 36 in MT305.
Š Field 33G subfield 2 in MT600.
Š Field 32B subfield 2 in MT601.

Or, a common reference mismatch exists between field 22C,


component 2, and one of the following:
Š Field 30P, YYMM of YYYYMMDD in MT360-362,364-365.
Š Field 36 sequence B in MT300.
Š Field 36 sequence B in MT303.
Š Field 36A sequence C in MT303.
Š Field 36 sequence D or field 37U sequence G in MT306.
Š Field 37G sequence B in MT320,330.
Š Field 37M sequence B in MT340,341.
Š Field 37J sequence B in MT350.

T23 926 Subfield 8 in field 61, subfield 5 in field 66A, or subfield 6 in field 26C is
too long or contains only '//', or subfield 2 in fields 26A or 26B is too long
or contains only '/'.

Sterling Commerce, Inc. 261


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T24 927 Subfield 7 in field 61, subfield 4 in field 66A, subfield 5 in field 26C,
subfield 1 in fields 26A or 26B is missing or is too long.

T25 928 Subfields 7 or 8 in field 61, subfield 4 or 5 in field 66A, subfield 5 or 6 in


field 26C, subfield 1 or 2 in fields 26A or 26B has improper content.

T26 929 Subfield 7 or 8 in field 61, subfield 4 or 5 in field 66A, subfield 5 or 6 in


field 26C, subfield 1 or 2 in fields 26A or 26B has improper content.
This check applies to:
Š fields 20,20C,21,21A,21F,21G,21P,21R.

T27 930 BIC incorrectly formatted or invalid.

T28 931 SWIFT BIC is not a valid destination.

T29 932 SWIFT BIC contains an invalid branch code.

T30 933 Excessive lines, subfields, or components were found in this field.

T31 934 The line, subfield, or component separator or delimiter is missing or


incorrect.

T32 935 An expected subfield, component, or component separator was not


found.

T33 936 The length of the field, line, subfield, or component contents is too long,
or, the component consists of one or more hidden characters, or, the
component consists of one or more imbedded characters which are
inconsistent with the defined field format, or the characters do not
belong to the correct character set.

T34 937 The length of the field, line, subfield, or component contents is too
short.

T35 938 Code word error in subfield 1, field 26C.

Sterling Commerce, Inc. 262


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T36 939 Code word error. This check applies to:


Š Field 14A in MT360,361.
Š Field 14D in MT320,330,340,350,360,361.
Š Field 14J in MT360,361.
Š Field 17A in MT206,300,303,306,360,361,405.
Š Field 17B in
MT500-505,513-515,518-519,527-529,535-538,540,547,558,564,
569,574W8BENO,574IRSLST,575-578,584,586-588.
Š Field 17F in MT304,306,340,360,361,405.
Š Field 17G,17N,17O in MT304.
Š Field 17T,17U in MT300.
Š Field 22A in
MT293,300,303,304,306,320,330,340,341,350,360,361,362,364,36
5.
Š Field 23B in MT 103_not_STP,103_STP,303.
Š Field 94A in MT 300, 303, 304, 305, 306, 320, 330, 340, 341, 350,
360, 361, 362, 364, 365, 600, 601.

T37 940 Code word error. This check applies to:


Š Subfield 2, field 35H when used with MT581 and with any message
appended in common groups n92,n95,n96.
Š Subfield 2, field 35T when used with MT552 and with any message
appended in common groups n92,n95,n96.

T38 941 Illogical time specified.

T39 942 Time of UTC Indicator (HH[MM]) is not in the valid range
(00<=HH<=23, 00<=MM<=59). This check applies to:
Š Field 98E in MTs 500-510, 513-515, 517, 518, 519, 524, 527, -530,
535-538, 540- 548, 558, 569, 574-IRSLST, 574-W8BENO, 575,
576, 578, 584, 586-589.
Š Field 98F in MTs 564.

T40 943 Missing amount/number or incorrect amount/number first character.

T41 944 Code word error in subfield 3, field 66A.

T42 945 Code word error in subfield 3, field 35U.

T43 946 The decimal separator in the amount/number subfield or component is


missing, is not a valid character, or more than one separator is present.

T44 947 The SWIFT BIC exists but it is not enabled for FIN, or the BIC is active
but it is not published in the current BIC directory, or it is not cutover.

T45 948 Invalid non-SWIFT BIC.

Sterling Commerce, Inc. 263


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T46 949 A Test-and-Training destination must not be used in a LIVE message.

T47 950 In an ERI field the data part of a code word /OCMT/, or /CHGS/ was
being validated but the ending separator (such as, the third '/') is
missing. This error is also a code word error that applies to:
Š Field 14G, subfield 1, in MT360-361.
Š Field 22, subfield 1, in MT305.
Š Field 23A, subfield 1, in MT360-362,364-365.
Š Field 23E. subfield 1, in
MT101,103_not_STP,104,107,206,207,256,405,416.
Š Field 35B, in ISITC MT521,523: invalid or duplicated code word in
line 3 or following.
Š Field 39P, subfield 1, in MT303.
Š Field 57D, line 1, in ISITC MT521,523.
Š Field 61, subfield 9, duplicated code words: /OCMT/ or /CHGS/.
Š Field 72 (narrative), duplicated code words: /OCMT/ or /CHGS/.
Š Field 72 (structured), duplicated code words: /OCMT/, /CHGS/, or
/INS/.
Š Field 77A, duplicated code words: /OCMT/ or /CHGS/.
Š Field 72, in ISITC MT521,523: invalid or duplicated code word, or in
ISITC MT523 mandatory code word is missing.
Š Field 77D, line 1, sequence C in MT303.
Š Field 77D, lines 1-6, in ISITC MT521,523: invalid or duplicated code
word.
Š Field 77H, subfield 1, in MT306,340,360,361, 600, 601.
Š Field 79, duplicated code words: /OCMT/ or /CHGS/.
Š Field 85D, line 1, in ISITC MT521.
Š Field 86, duplicated code words: /OCMT/ or /CHGS/.
Š Field 87D, line 1, in ISITC MT521,523.
Š Field 88D, line 1, in ISITC MT521,523.

Sterling Commerce, Inc. 264


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T48 951 Code word error. This check applies to:


Š Field 14G, subfield 2, in MT360-361.
Š Field 22K, subfield 1, in MT306.
Š Field 23A, subfield 2, in MT360-362,364-365.
Š Field 23D, in MT340-341.
Š Field 23E, subfield 1, in MT103_STP.
Š Field 31P, subfield 2, in ISITC MT521,523.
Š Field 35B, in ISITC MT521,523: invalid code word in line 1.
Š Field 38E, subfield 2, MT360-361.
Š Field 38G, subfield 2 or 4, MT340,360-361.
Š Field 38H, subfield 2 or 4, MT360-361.

T49 952 (Available).

T50 953 Date error. Either Invalid Date subfield (this check applies to all MTs
with a Date subfield) OR Invalid year <YY> in a Value Date subfield of
the MTs that are candidate for the Value Date Ordering process.
The valid range for <YY> is:
00-60 for the years 2000-2060
80-99 for the years 1980-1999
This check applies to:
Š Field 30, in MTs: 101, 104, 107, 110, 111, 112, 201, 203, 204, 207,
210,
Š 256
Š Field 32A, in MTs: 102, 103, 110, 111, 112, 200, 202, 205, 256,
910.

T51 954 Code word 'C','D','RC','RD','EC','ED' error.

T52 955 Invalid currency code or price code 'PCT','REN', or 'YLD'.

T53 956 Code word error in subfield 6, component 1 of field 61.

T54 957 The format of the first line of Field 50F (Party Identifier) is invalid. This
check applies to:
Š Field 50F in MTs 101, 102, 102_STP, 103, 103_STP, 210, 910.
Š This check applies to all MTs containing field 50F, when appended
to Common Group MTs n92, n95, n96.

T55 958 Code word error. This check applies to Subfield 1, component 1:
Š Field 50F in MTs 101, 102, 102_STP, 103, 103_STP, 210, 910.
Š This check applies to all MTs containing field 50F, when appended
to Common Group MTs n92, n95, n96.

Sterling Commerce, Inc. 265


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T56 959 Code word error. This check applies to Subfield 2, component 1:
Š Field 50F in MTs 101, 102, 102_STP, 103, 103_STP, 210, 910.
Š This check applies to all MTs containing field 50F, when appended
to Common Group MTs n92, n95, n96.

T57 960 Code word error in subfield 2 of fields 31H, 31J, or 31X.

T58 961 Code word error. This check applies to:


Š Subfield 1 of field 35A,35N,35P,35S.
Š Subfield 2 of field 35H,35T.
Š Subfield 1 in the 2nd occurrence of field 35A in MT550.

T59 962 (Available).

T60 963 Code word error. This check applies to:


Š Field 26F in MT306.
Š Field 40A in MT700,705.

T61 964 Code word 'D' or 'M' error. This check applies to:
Š Field 32K, subfield 1, in MT400,405,410,416,420,422,430.
Š Field 33k, subfield 1, in MT430.
Š Field 37(A-F), subfield 2, in MT516,644,646.
Š Field 38J, subfield 1, in MT320,330.

T62 965 Either the first subfield <DATE2>[<HHMM>] or the second subfield 7!a
but not both must be present. If optional subfield 1 is used, component
1 <DATE2> of this subfield must be present. This check applies to:
Fields 31H,31J,31X.

T63 966 Error in component 2 of field 22C or subfield 2, component 2, of field


22. When the last character of this component is zero '0' and the
preceding character is not one '1' then the entire component must
consist of zeros.

T64 967 Code word error. This check applies to:


Š Field 12F in MT306.
Š Field 40B, line 1, in MT710,720.

T65 968 (Available).

T66 969 Code word error. This check applies to:


Š Field 12E in MT306.
Š Field 40B, line 2, in MT710,720.

Sterling Commerce, Inc. 266


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T67 970 Code word error. This check applies to:


Š Field 17R in MT320,330.
Š Field 17V in MT306.
Š Field 49 in MT700,710,720.

T68 971 Code word error. This check applies to:


Š Field 24D, subfield 1, in MT300,306,320,330,240,360,361.
Š Field 41A, subfield 2, in MT700,705,710,720,740.
Š Field 41D, subfield 2, in MT700,705,710,720,740.

T69 972 (Available).

T70 973 Either the Account number, the Place, or both must be present.

T71 974 Code word error. This check applies to:


Š Field 22D in MT360,361,364,365,405.
Š Field 22E in MT405.
Š Field 22G in MT306.

T72 975 Code word error. This check applies to:


Field 22J in MT306.
Field 23C, subfield 1, in MT405.
Field 23F, subfield 1, in MT405.

T73 976 Invalid country code. Please refer to the BIC Directory General
Information -Country Codes-.

T74 977 The currency code must be the same for each indicated subfield in the
field.

T75 978 In MTs 405, n92, n95, n96:


Field 38B.
When subfields 1 and 2 contain "MONT/OTHR" then subfield 3 is
mandatory, otherwise subfield 3 is not allowed.

T76 979 The first character in the first line of this field must be a '/', and there
must be at least another line, but not more than 5 lines. This check
applies to field 50H.

T77 980 If the first character of the first line of this component or sub-component
is a '/', then there must be at least another line, but not more than 5
lines. Otherwise, no more than 4 lines are allowed. This check applies
to:
Fields 42D,50K,(50-58)D,59,(82-88)D, and subfield 2 of field 87F.

Sterling Commerce, Inc. 267


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T78 981 Invalid or duplicated code word, or a mandatory code word is missing.
This check applies to:
Š Field 53J, subfield 1 of each line, in MTs 300, 303 and 304, 306,
320, 330, 340, 341, 350.
Š Field 56J, subfield 1 of each line, in MTs 300, 303 and 304, 306,
320, 330, 340, 341, 350.
Š Field 57J, subfield 1 of each line, in MTs 300, 303 and 304, 306,
320, 330, 340, 341, 350.
Š Field 58J, subfield 1 of each line, in MTs 300, 303 and 304, 306,
320, 330, 340, 341, 350.
Š Field 82J, subfield 1 of each line, in MTs 300, 303 and 304, 305,
306, 320, 330, 350, 600, 601.
Š Field 83J, subfield 1 of each line, in MTs 300, 303 and 304, 305,
306, 320, 330, 350, 600, 601.
Š Field 84J, subfield 1 of each line, in MTs 300, 306, 320, 330.
Š Field 85J, subfield 1 of each line, in MTs 300, 320, 330.
Š Field 86J, subfield 1 of each line, in MTs 306, 320, 330, 340, 341,
350.
Š Field 87J, subfield 1 of each line, in MTs 300, 303 and 304, 305,
306, 320, 330, 350, 600, 601.
Š Field 88J, subfield 1 of each line, in MTs 300, 320.

T79 982 (Available).

T80 983 <Field 72 Reject/Return> or <Field 79 Reject Return> code word error,
or mandatory code word missing, or code word not in proper sequence.

T81 984 Format of <Field 72 Reject/Return> is not allowed in this message. This
check applies to:
Field 72, MT102_STP,103_STP.

T82 985 ERI format is not allowed in this message. This check applies to: Field
72, MT102_STP,103_STP.

T83 986 (Available).

T84 987 (Available).

T85 988 Code word error. This check applies to Field 23G, subfield 2, in MTs
307, 321, 380, 381, 500-510, 513-515, 517-519, 524, 527-529, 530,
535-538, 540-549, 558, 564-569, 574IRSLST, 574W8BENO, 575, 576,
578, 584, 586-589, or in any message appended in common groups
n92, n95 or n96.

Sterling Commerce, Inc. 268


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T86 989 Code word error. This check applies to:


Field 23G, subfield 1, in MTs 307, 321, 380, 381, 500-510, 513-515,
517-519, 524, 527-529, 530, 535-538, 540-549, 558, 564-569,
574IRSLST, 574W8BENO, 575, 576, 578, 584, 586-589, or in any
message appended in common groups n92, n95 or n96.

T87 990 In a generic field the colon ':' delimiter is not present at the expected
position.

T88 991 Field 12 in MT570 may only consist of 571,572,573,577.


Field 12 in MT920 may only consist of 940,941,942,950.
Field 12 in MT973 may only consist of 971,972,998.
Field 13A in MT507 may only consist of 503,504,505.
Field 13A in MT549 may only consist of
509,535-538,548,567,575-577,584, 586,589.

T89 992 In a generic field either the qualifier is invalid, the qualifier is duplicated,
a mandatory qualifier is missing, or the qualifier format is not valid.

T90 993 In a generic field either the issuer code format is invalid, the mandatory
issuer code is missing, or the generic field format is invalid.

T91 994 In a generic field the slash '/' delimiter is not present at the expected
position.

T92 995 Code word error. This check applies to:


Š Field 16R in ISO15022.
Š Field 16S in ISO15022.

T93 996 Code word error. This check applies to:


Field 22B in MT320,330,364,365.

T94 997 In field 22, subfield 2, or in field 22C, the components 1 and 3, the
values '0' and '1' are not permitted in <LC1> and <LC2>. However, the
value '0' is allowed in the second (rightmost) position if the sender or
receiver is a test and training user.

T95 998 In field 22, subfield 2, or in field 22C, the components 1 and 3 do not
contain the bank code and location code of the message sender, and/or
the bank code and location code of the message receiver.

T96 999 In field 22, subfield 2, or in field 22C, the components 1 and 3 are not in
alphabetical sequence.

T97 1000 Code word error. This check applies to:


Field 28E, subfield 2, in
MT206,506,535-538,569,574WBENO,574IRSLST,575, 576,584,586.

T98 1001 (Available).

Sterling Commerce, Inc. 269


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

T99 1002 A special function has been declared in the validation syntax that is not
recognized.
Note: If you receive this error, it indicates that a special function
was declared in a syntax that was not recognized by the
translator.

Specific Error Codes for MUG-textval Rules


The following table contains the specific error codes for SWIFT MUG-textval rules:
Note: If the Translator Report Error Number column is blank, this indicates that there is not currently a
translator code equivalent for the SWIFT Error Code. The translator report codes are used to
generate errors from within extended rules using the cerror() function. If you want to validate the
conditions corresponding to G18 through G24 in an extended rule, we recommend that you use the
translator report code for a similar error (G01 (1003) through G17 (1019)).

SWIFT Error Code Translator Report Error Description


Error Number

G01 1003 AU/PDS: in MT100,103,202, the letter option of the "selected field" is not
A or D.

G02 1004 AU/PDS: in MT100,103,202, the format of the "selected field" option A is
not valid.

G03 1005 AU/PDS: in MT100,103,202, the format of the "selected field" option D is
not valid.

G04 1006 AU/PDS: the "selected field" is missing. At least one of the following
fields must be present: MT100,103: fields 56a, 57a.

G05 1007 LVTS: if 2 LVTS members and the first 6 characters of their destination ID
are different, exchange a SWIFT message type 100,103,205, and if the
currency code used in tag 32A is "CAD" then the tag 103 must be present
in the User Header and it must contain the code "CAD".

G06 1008 REMIT: in a SWIFT message MT103, the field 77T and the tag 119 with
the code word "REMIT" (in the User Header) must either both be present
or absent.

G07 1009 CLS: in an MT300 eligible for the FIN-Copy service CLS or CLT, any field
53 present in sequence B must be used with the letter option 'A'.

G08 1010 CLS: in an MT300 eligible for the FIN-Copy service CLS or CLT, both
fields 57 in sequences B1 and B2 (index 20,24) must be used with the
letter option 'A', field 57a: of subsequence B1 must contain the "CLSB"
BIC bank code.

G09 1011 CLS: in an MT300 eligible for the FIN-Copy service CLS or CLT, if the tag
17U is used it must contain the value "N".

Sterling Commerce, Inc. 270


SWIFT Error Codes

SWIFT Error Code Translator Report Error Description


Error Number

G10 1012 CLS: in an MT300 eligible for the FIN-Copy service CLS or CLT, any field
56 present in sequence B must be used with the letter option 'A'.

G11 1013 CLS: in an MT300 eligible for the FIN-Copy service CLS or CLT, if field 82
is present in sequence A it must be used with letter option 'A'.

G12 1014 CLS: in an MT300 eligible for the FIN-Copy service CLS or CLT, if field 87
is present in sequence A it must be used with letter option 'A'.

G13 1015 CLS: in an MT304 sent to the CLSB server, field 94A must contain the
code "ASET".

G14 1016 CLS: in an MT304 sent to the CLSB server, field 82 in sequence A must
be used with letter option 'A'.

G15 1017 CLS: in an MT304 sent to the CLSB server, field 87 in sequence A must
be used with letter option 'A'.

G16 1018 CLS: in an MT304 sent to the CLSB server, any field 53 present in
sequence B must be used with the letter option 'A'.

G17 1019 CLS: in an MT304 sent to the CLSB server, both fields 57 in sequence B
must be used with letter option 'A' and must contain the ""CLSB"" BIC
bank code.
Note: Field 57A, index 19, is mandatory.

G18 1751 AU/PDS: in MT103 the format of the “selected field letter option C” is
invalid.

G19 1752 In MT 305 eligible for the FIN-Copy service CLS or CLT, field 53a must
be used with option A.

G20 1753 In MT 305 eligible for the FIN-Copy service CLS or CLT, field 56a must
be used with option A.

G21 1754 In MT 305 eligible for the FIN-Copy service CLS or CLT, field 57A must
be present.

G22 1755 In MT 305 eligible for the FIN-Copy service CLS (or CLT,) when the
emitter and receiver are both CLS (or CLT) members, then field 57A
must contain CLSB.

G23 1756 In MT 305 eligible for the FIN-Copy service CLS (or CLT), when the
emitter is CLS (or CLT) member and receiver is not, and field 34R is
present, then field 57A must contain CLSB. When the emitter is CLS (or
CLT) member and receiver is not, and field 34P is present, then field 56A
must contain CLSB.

G24 1757 In MT 305 eligible for the FIN-Copy service CLS (or CLT), both fields 56A
and 57A must not contain the CLSB BIC bank code at the same time.

Sterling Commerce, Inc. 271


SWIFT Error Codes

Special Error Codes for Value-Added Service Messages


The following table contains the special error codes for SWIFT value-added service messages:

SWIFT Error Code Translator Report Error Number Error Description

B01 1020 PAC Trailer used for non-Premium


service message. Message has PAC
trailer but sender or receiver, or both,
are not members of Premium
service.

B02 1021 (Available)

B03 1022 103:LCH present in the message, but


sender, receiver, or both are not
members of LCH, or the message
type is not allowed for LCH, or,
'103:TPS' present in the message,
but sender, receiver, or both are not
members of TPS, or the message
type is not allowed for TPS.

B04 1023 (Available)

B05 1024 A system error has occurred. The


user should contact their local
Customer Service Center for further
information.

Message Syntax and Semantic Rule Codes


The following section contains the error codes for SWIFT message syntax and semantic rules.
The C, D, and E error code ranges refer to rule numbers (these represent the message validation rules), are
documented as follows:
✦ Rules 000-099 as C00-C99
✦ Rules 100-199 as D00-D99
✦ Rules 200-299 as E00-E99

Rules 000-099

SWIFT Error Code Translator Report Error Number

C00 1025

C01 1026

C02 1027

C03 1028

Sterling Commerce, Inc. 272


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

C04 1029

C05 1030

C06 1031

C07 1032

C08 1033

C09 1034

C10 1035

C11 1036

C12 1037

C13 1038

C14 1039

C15 1040

C16 1041

C17 1042

C18 1043

C19 1044

C20 1045

C21 1046

C22 1047

C23 1048

C24 1049

C25 1050

C26 1051

C27 1052

C28 1053

C29 1054

C30 1055

C31 1056

C32 1057

C33 1058

C34 1059

Sterling Commerce, Inc. 273


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

C35 1060

C36 1061

C37 1062

C38 1063

C39 1064

C40 1065

C41 1066

C42 1067

C43 1068

C44 1069

C45 1070

C46 1071

C47 1072

C48 1073

C49 1074

C50 1075

C51 1076

C52 1077

C53 1078

C54 1079

C55 1080

C56 1081

C57 1082

C58 1083

C59 1084

C60 1085

C61 1086

C62 1087

C63 1088

C64 1089

C65 1090

Sterling Commerce, Inc. 274


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

C66 1091

C67 1092

C68 1093

C69 1094

C70 1095

C71 1096

C72 1097

C73 1098

C74 1099

C75 1100

C76 1101

C77 1102

C78 1103

C79 1104

C80 1105

C81 1106

C82 1107

C83 1108

C84 1109

C85 1110

C86 1111

C87 1112

C88 1113

C89 1114

C90 1115

C91 1116

C92 1117

C93 1118

C94 1119

C95 1120

C96 1121

Sterling Commerce, Inc. 275


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

C97 1122

C98 1123

C99 1124

Rules 100-199

SWIFT Error Code Translator Report Error Number

D00 1125

D01 1126

D02 1127

D03 1128

D04 1129

D05 1130

D06 1131

D07 1132

D08 1133

D09 1134

D10 1135

D11 1136

D12 1137

D13 1138

D14 1139

D15 1140

D16 1141

D17 1142

D18 1143

D19 1144

D20 1145

D21 1146

D22 1147

D23 1148

D24 1149

Sterling Commerce, Inc. 276


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

D25 1150

D26 1151

D27 1152

D28 1153

D29 1154

D30 1155

D31 1156

D32 1157

D33 1158

D34 1159

D35 1160

D36 1161

D37 1162

D38 1163

D39 1164

D40 1165

D41 1166

D42 1167

D43 1168

D44 1169

D45 1170

D46 1171

D47 1172

D48 1173

D49 1174

D50 1175

D51 1176

D52 1177

D53 1178

D54 1179

D55 1180

Sterling Commerce, Inc. 277


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

D56 1181

D57 1182

D58 1183

D59 1184

D60 1185

D61 1186

D62 1187

D63 1188

D64 1189

D65 1190

D66 1191

D67 1192

D68 1193

D69 1194

D70 1195

D71 1196

D72 1197

D73 1198

D74 1199

D75 1200

D76 1201

D77 1202

D78 1203

D79 1204

D80 1205

D81 1206

D82 1207

D83 1208

D84 1209

D85 1210

D86 1211

Sterling Commerce, Inc. 278


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

D87 1212

D88 1213

D89 1214

D90 1215

D91 1216

D92 1217

D93 1218

D94 1219

D95 1220

D96 1221

D97 1222

D98 1223

D99 1224

Rules 200-299

SWIFT Error Code Translator Report Error Number

E00 1225

E01 1226

E02 1227

E03 1228

E04 1229

E05 1230

E06 1231

E07 1232

E08 1233

E09 1234

E10 1235

E11 1236

E12 1237

E13 1238

E14 1239

Sterling Commerce, Inc. 279


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

E15 1240

E16 1241

E17 1242

E18 1243

E19 1244

E20 1245

E21 1246

E22 1247

E23 1248

E24 1249

E25 1250

E26 1251

E27 1252

E28 1253

E29 1254

E30 1255

E31 1256

E32 1257

E33 1258

E34 1259

E35 1260

E36 1261

E37 1262

E38 1263

E39 1264

E40 1265

E41 1266

E42 1267

E43 1268

E44 1269

E45 1270

Sterling Commerce, Inc. 280


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

E46 1271

E47 1272

E48 1273

E49 1274

E50 1275

E51 1276

E52 1277

E53 1278

E54 1279

E55 1280

E56 1281

E57 1282

E58 1283

E59 1284

E60 1285

E61 1286

E62 1287

E63 1288

E64 1289

E65 1290

E66 1291

E67 1292

E68 1293

E69 1294

E70 1295

E71 1296

E72 1297

E73 1298

E74 1299

E75 1300

E76 1301

Sterling Commerce, Inc. 281


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

E77 1302

E78 1303

E79 1304

E80 1305

E81 1306

E82 1307

E83 1308

E84 1309

E85 1310

E86 1311

E87 1312

E88 1313

E89 1314

E90 1315

E91 1316

E92 1317

E93 1318

E94 1319

E95 1320

E96 1321

E97 1322

E98 1323

E99 1324

Knn: Code Word Validation in Generic Fields


The two digits nn indicate the field ID.

SWIFT Error Code Translator Report Error Number

K00 1325

K01 1326

K02 1327

Sterling Commerce, Inc. 282


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

K03 1328

K04 1329

K05 1330

K06 1331

K07 1332

K08 1333

K09 1334

K10 1335

K11 1336

K12 1337

K13 1338

K14 1339

K15 1340

K16 1341

K17 1342

K18 1343

K19 1344

K20 1345

K21 1346

K22 1347

K23 1348

K24 1349

K25 1350

K26 1351

K27 1352

K28 1353

K29 1354

K30 1355

K31 1356

K32 1357

K33 1358

Sterling Commerce, Inc. 283


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

K34 1359

K35 1360

K36 1361

K37 1362

K38 1363

K39 1364

K40 1365

K41 1366

K42 1367

K43 1368

K44 1369

K45 1370

K46 1371

K47 1372

K48 1373

K49 1374

K50 1375

K51 1376

K52 1377

K53 1378

K54 1379

K55 1380

K56 1381

K57 1382

K58 1383

K59 1384

K60 1385

K61 1386

K62 1387

K63 1388

K64 1389

Sterling Commerce, Inc. 284


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

K65 1390

K66 1391

K67 1392

K68 1393

K69 1394

K70 1395

K71 1396

K72 1397

K73 1398

K74 1399

K75 1400

K76 1401

K77 1402

K78 1403

K79 1404

K80 1405

K81 1406

K82 1407

K83 1408

K84 1409

K85 1410

K86 1411

K87 1412

K88 1413

K89 1414

K90 1415

K91 1416

K92 1417

K93 1418

K94 1419

K95 1420

Sterling Commerce, Inc. 285


SWIFT Error Codes

SWIFT Error Code Translator Report Error Number

K96 1421

K97 1422

K98 1423

K99 1424

Header Validation Error Codes


The following table contains the specific H and U error codes for SWIFT header validations that the
application supports:

SWIFT Error Code Translator Error Code or Description of How Error Description
This Validation is Handled and Enforced

H01 Translator Error Code 1425—enforced by the Basic Header no present or format
envelope map error block 1

H02 Translator Error Code 1426 (inbound)—the Application Identifier not ‘A’ (GPA) or
application generates this error ‘F’ (FIN)

H03 Translator Error Code 1427(inbound and Invalid Service Message identifier
outbound)—the application generates this error (must be 01 or 21)

H4-H9 Not used Available

H10 Translator Error Code 1434—not generated or Bad LT address or application not
enforced by the application enabled for the LT

H15 Translator Error Code 1439—not generated or Bad session number


enforced by the application

H20 Translator Error Code 1444—not generated or Error in the ISN


enforced by the application

H21 Translator Error Code 1445 (outbound)—the Error in the message sender’s branch
application generates this error code

H25 Translator Error Code 1449—enforced by the Application header format error or not
envelope map present when mandatory

H26 Translator Error Code 1450—enforced by the Input/output identifier not “I” (on input
envelope map from LT)

H30 Translator Error Code 1454 (inbound and Message type for a SWIFT message
outbound)—the application generates this error not found in code list.

H40 Translator Error Code 1464 (inbound and Message priority other than S
outbound)—the application generates this error (System) for a message type < 100,
or message priority of S for message
type < 100

H50 Translator Error Code 1474 (inbound and Receiver ID (ID + ‘X’ + branch code)
outbound)—the application generates this error not found in code list.

Sterling Commerce, Inc. 286


SWIFT Error Codes

SWIFT Error Code Translator Error Code or Description of How Error Description
This Validation is Handled and Enforced

H51 Translator Error Code 1475 (outbound)—the Message Type < 100 must have a
application generates this error receiver ID of SWFTXXX and a
branch code of XXX.

H52 Translator Error Code 1476—not generated or MT 072, selection of Test and
enforced by the application Training mode/version, MT 077
Additional Selection Criteria for
SWIFT are not allowed while a
SWIFT session is open

H55 Translator Error Code 1479—not generated or Message type not allowed for fallback
enforced by the application session for MT 030

H80 Translator Error Code 1504—enforced by the Delivery option error


envelope map

H81 Translator Error Code 1505—enforced by the Obsolescence period error


envelope map

H98 Translator Error Code 1522 (inbound and Sender ID (ID + ‘X’ + branch code)
outbound)—the application generates this error not found in code list.

H99 Translator Error Code 1523—enforced by the Error can be one of the following:
envelope map
Š Invalid receiver destination
(invalid character or LT
identification is not “X”)
Š Invalid date or time (not numeric
or not within range)

U00 Translator Error Code 1524—enforced by the Bad block 3 format


envelope map

U01 Translator Error Code 1525—enforced by the Bad bank priority


envelope map

U02 Translator Error Code 1526—enforced by the Bad MUR


envelope map

U03 Translator Error Code 1527—not generated or Neither bank priority nor MUR present
enforced by the application

U07 Translator Error Code 1531 (outbound)—the User Header not permitted for
application generates this error user-to-system messages (that is,
message type < 100)

Sterling Commerce, Inc. 287


SWIFT Error Codes

SWIFT Error Code Translator Error Code or Description of How Error Description
This Validation is Handled and Enforced

U08 Translation Error Code 1532 (inbound and Tag 119 is not one of the following:
outbound)—the application generates this error
Š REMIT (any message)
Š RFDD (any message)
Š STP (102 or 103)
Š COMM (503, 504, 505, 506, or
507)
Š CRPR (503, 504, 505, 506, or
507)
Š CRSP (503, 504, 505, 506, or
507)
Š CRTL (503, 504, 505, 506, or 507)
Š EXTD (503, 504, 505, 506, or
507)
Š FIXI (503, 504, 505, 506, or 507)
Š FORX (503, 504, 505, 506, or
507)
Š LIQU (503, 504, 505, 506, or 507)
Š OTCD (503, 504, 505, 506, or
507)
Š PAYM (503, 504, 505, 506, or
507)
Š REPO (503, 504, 505, 506, or
507)
Š SBSB (503, 504, 505, 506, or
507)
Š SCRP (503, 504, 505, 506, or
507)
Š SECL (503, 504, 505, 506, or
507)
Š SLEB (503, 504, 505, 506, or 507)
Š TCRP (503, 504, 505, 506, or
507)
Š W8BENO (574)
Š IRSLST (574)

U09 Translation Error Code 1533 (inbound and Tag 119 present for a message type
outbound)—the application generates this error other than 102, 103, 104, 503, 504,
505, 506, 507, 521, 523, and 574.

Sterling Commerce, Inc. 288


SWIFT Error Codes

Error Codes for SWIFT MX Messages


The following are the error codes the translator uses for SWIFT MX messages and their corresponding
SWIFT error code:

Translator Error Code SWIFT Error Code

1633 AccruedInterestAmountSignRule

1634 BalanceAtSafekeepingPlaceRule

1635 BalanceForAccountOrSubAccountDetailsRule

1636 Party1Rule

1637 StreetNameAndOrPostOfficeBoxRule

1638 ValueRule

1639 AccumulationPeriodRule

1640 AddressRule

1641 AmountAndOrRateRule

1642 AmountSignRule

1643 BalanceForSubAccountRule

1644 BeneficiaryRule

1645 BulkCashSettlementDetails1Rule

1646 BulkCashSettlementDetails2Rule

1647 BulkCashSettlementDetails3Rule

1648 BulkCashSettlementDetails4Rule

1649 BulkCashSettlementDetails5Rule

1650 BulkCashSettlementDetails6Rule

1651 CalculationBasisRule

1652 CashSettlementDateRule

1653 ClientReferenceRule

1654 CommercialAgreementRule

1655 CorporateRule

1656 CurrencyPredefinedPeriodsRule

1657 CurrencyPriceChangeRule

1658 CurrencyUserDefinedPeriodsRule

1659 CurrentYearRule

1660 CurrentYearSubscriptionDetailsRule

Sterling Commerce, Inc. 289


SWIFT Error Codes

Translator Error Code SWIFT Error Code

1661 CurrentYearTypeRule

1662 DateOrDateCodeRule

1663 DeliverersCustodianDetailsRule

1664 DeliverersCustodianRule

1665 DeliverersIntermediaryDetailsRule

1666 DesignationRule

1667 ExceptionalCashFlowIndicatorRule

1668 ExchangeConversionRule

1669 MultipleSwitchExecutionRule

1670 ExtendedPartyRole2Rule

1671 ExtendedPartyRoleRule

1672 FinancialInstrumentQuantity1Rule

1673 FloorAmountRule

1674 FutureSettlementDateRule

1675 GoodTIllOrderRule

1676 InvestmentAccountDetailsRule

1677 InvestmentAccountIdentificationRule

1678 InvestmentAccountRule

1679 InvestorRule

1680 MailingIndicatorRule

1681 MessageNameAndReferenceGuideline

1682 MessageNameRule

1683 NameAndAddress1Rule

1684 NetAmountGrossAmountRule

1685 OrderOriginatorEligibility1Rule

1686 OrderOriginatorEligibility3Rule

1687 OrderOriginatorEligibility4Rule

1688 OrderPriceAndForeignExchangeRule

1689 OrderPriceAndLimitOrderRule

1690 OtherCodeRule

1691 OtherReferenceRule

Sterling Commerce, Inc. 290


SWIFT Error Codes

Translator Error Code SWIFT Error Code

1692 OtherStatusRule

1693 PEPISARule

1694 PendingAdditionalInformation

1695 PhysicalDeliveryDetailsRule

1696 PhysicalTransferDetailsRule

1697 PorfolioRule

1698 PreviousOrOtherReferenceOrAccountApplicationIdentificationRule

1699 PreviousReferenceRule

1700 PriceDetailsRule

1701 ReceiversCustodianDetailsRule

1702 ReceiversCustodianRule

1703 ReceiversIntermediaryDetailsRule

1704 ReferenceRule

1705 ReferredPlacementAgentRule

1706 RegistrationAddressIndicator1Rule

1707 RegistrationAddressIndicator2Rule

1708 RelatedPartiesDetailsRule

1709 RelatedReferenceRule

1710 RequestedSettlementCurrencyRule

1711 RoundingDirectionAndModulusRule

1712 RoundingMethodRule

1713 RoundingRule

1714 SettlementCurrency1Rule

1715 SettlementCurrency2Rule

1716 SettlementCurrency3Rule

1717 SettlementCurrency4Rule

1718 SettlementCurrency5Rule

1719 StatisticsCurrency1Rule

1720 StatisticsCurrency2Rule

1721 StopPriceAndStopOrderRule

1722 TaxRule

Sterling Commerce, Inc. 291


SWIFT Error Codes

Translator Error Code SWIFT Error Code

1723 TotalAmountYearToDateRule

1724 TotalNumberRule

1725 TotalRedemptionAmountRule

1726 TotalUnitsNumberRule

1727 TransactionOnAccountOrSubAccountDetailsRule

1728 TransactionOnSubAccountRule

1729 TransactionTypeLegExecutionIdentificationRule

1730 TransactionTypeLegIdentificationRule

1731 TypeAmountRateRule

1732 UserDefinedRule

1733 BilateralBalanceRule

1734 CreditDebitIndicator1Rule

1735 EntryAmountCreditDebitIndicator1Rule

1736 EntryAmountCreditDebitIndicator2Rule

1737 InstructedAmountCreditDebitIndicator1Rule

1738 InstructedAmountCreditDebitIndicator2Rule

1739 InstructedAmountCurrencyRule

1740 PaymentInstructionStatusRule

1741 ReturnCriteriaAndOrSearchCriteriaRule

1742 SettlementAmountCreditDebitIndicator1Rule

1743 SettlementAmountCreditDebitIndicator2Rule

1744 SettlementAmountCurrencyRule

1745 TransactionCreditDebitIndicatorRule

1746 TransferValueDateRule

1747 OrderOriginatorEligibilityGuideline

1748 NomineeAccountServicerRule

1749 TotalSubscriptionAmountRule

1750 AccountIdentificationRule

1751 BilateralBalanceRule

1752 BilateralLimitCounterparty1Rule

1753 BilateralLimitCounterparty2Rule

Sterling Commerce, Inc. 292


SWIFT Error Codes

Translator Error Code SWIFT Error Code

1754 BilateralLimitCounterparty3Rule

1755 BilateralLimitCounterparty4Rule

1756 BilateralLimitRule

1757 CashAccountIdentificationGuideline

1758 ChargeRule

1759 CounterpartyIdentification1Rule

1760 CounterpartyIdentification2Rule

1761 CreditAccountRule

1762 CreditDebitIndicator1Rule

1763 CreditDebitIndicatorGuideline

1764 CurrencyGuideline

1765 DebitAccountRule

1766 DebitCreditIndicatorGuideline

1767 DeliverersIntermediaryGuideline

1768 EntryAmountCreditDebitIndicator1Rule

1769 EntryAmountCreditDebitIndicator2Rule

1770 ExchangeConversionRule

1771 ExchangeOrConversionRateRule

1772 FloorAmountRule

1773 InstructedAmountCreditDebitIndicator1Rule

1774 InstructedAmountCreditDebitIndicator2Rule

1775 InstructedAmountCurrencyRule

1776 IssuerAndOrMessageNameRule

1777 LimitCriteriaGuideline

1778 MailingIndicatorRule

1779 MandatoryValueRule

1780 MemberIdentificationRule

1781 ModifyStandingOrderRules

1782 PaymentInstructionStatusRule

1783 PaymentMessageTypeRule

1784 ReceiversIntermediaryGuideline

Sterling Commerce, Inc. 293


SWIFT Error Codes

Translator Error Code SWIFT Error Code

1785 ReturnCriteriaAndOrSearchCriteriaRule

1786 SearchAndReturnCriteriaAndStatementReportRule

1787 SettlementAmountCreditDebitIndicator1Rule

1788 SettlementAmountCreditDebitIndicator2Rule

1789 SettlementAmountCurrencyRule

1790 StreetNameAndOrPostOfficeBoxRule

1791 TaxRule

1792 TransactionCreditDebitIndicatorRule

1793 TransferValueDateRule

1794 AvailabilityAndTypeRule

1795 CertificateIdentificationAndOrTaxTypeRule

1796 DomainAndProprietary1Rule

1797 DomainAndProprietary2Rule

1798 FamilyAndSubFamilyRule

1799 ReturnReasonRule

1800 StatusAndBookingDateRule

Sterling Commerce, Inc. 294


SWIFTNet Routing Rule

SWIFTNet Routing Rule


The SWIFTNet Routing Rule is created by you as the Responder, because you are expecting a server request
message from SWIFTNet. This rule is used by the SWIFTNet Server adapter to manage interactive
messages from the SWIFTNet MEFG Server, and enables you to configure how you want to process when
you receive either an InterAct request payload or FileAct file that was transferred. The rule routes an
incoming request message to a user-defined business process based on the following parameters:
✦ requestorDN
✦ responderDN
✦ requestType
✦ serviceName
You configure these four parameters and create the SWIFTNet routing rule through the SWIFTNet Routing
Rule interface. The SWIFTNet Routing Rule page enables you to assign any business process to a set of
Requestor, Responder, Service, and Request Type. The rules are applied to the routing of SWIFTNet
messages (Funds, MX, or generic XML format), and the server response messages are constructed and sent
back to SWIFTNet through the SWIFTNet MEFG Server.
You can also use a wildcard (*) for these parameters. Using a wildcard, you can configure a generic routing
rule that handles multiple messages from different requestors. The wildcard can be used at the beginning,
middle, or end of the pattern. Additionally you can set the priority of the routing rule to determine which
rule supersedes another if there are two or more routing rules with different business processes that match
an incoming request or file because you are using the wildcard feature.
Also, the priority function for the SWIFTNet routing rules necessitates that the application only allow one
user to perform update on the priority at any particular time. So, when a user is creating, editing, deleting or
importing a SWIFTNet routing rule, a lock will be created so that no other user is allowed to perform those
operations.
Note: The wildcard must appear only once in routing criteria. For example: *,o=swift is allowed, but
*,o=swift,* is not allowed because in the latter example the wildcard appears twice in the string.
You would want to use the wildcard function if, for example, the responder has 1,000 requestors that he or
she might receive InterAct messages from, and would therefore need to configure 1,000 routing rules even
though he or she intends to invoke the same business process for all the requestors. In this scenario, the user
can create one SWIFTNet routing rule and use the wildcard feature to solve his or her business problem.
Note: If you are using CHIPS adapter with SWIFTNet as transport interface, the SWIFTNet Routing Rule
will be automatically created for you.
You can also export and import SWIFTNet routing rules.
Note: Each time a user adds, modifies, or deletes a SWIFTNet routing rule, the action is logged to create
an audit trail based on the user who performed the event.

Creating a SWIFTNet Routing Rule and Associating it with a Business

Sterling Commerce, Inc. 295


SWIFTNet Routing Rule

Process
To create a SWIFTNet routing rule and associate it with an appropriate business process to process
incoming SWIFTNet requests:
1. Create a business process to which the inbound messages will be routed by the SWIFTNet Server
adapter.
2. From the application Deployment menu, select Adapter Utilities > SWIFTNet Routing Rule.
3. To the right of Create new SWIFTNet routing rule, click Go!.
4. Complete the following parameters and click Next:

Parameter Description

SWIFTNet Routing Rule Type the name of the SWIFTNet routing rule. Required.
Name Note: Special characters such as ! @ # % ^ ( ) + ? , < > { } [ ] | ; " ' / are not permitted.

Requestor DN Type the distinguished name of the requestor or use a wildcard (*) in the string.
Required.
Note: If you use a wildcard in the string for this value, SWIFTNet specifies that a valid
DN always ends with o=swift, so the wildcard character is only allowed at the
beginning of the string. For example, *,o=abcd,o=swift is allowed, but
o=abcd,*,o=swift is not allowed.
Note: This value should be taken from the Requestor’s SWIFTNet Client service
configuration (or from the BPML parameters passed to the service), in
accordance with the arrangement made between requestor and responder.

Responder DN Type the distinguished name of the responder or use a wildcard (*) in the string.
Required.
Note: If you use a wildcard in the string for this value, SWIFTNet specifies that a valid
DN always ends with o=swift, so the wildcard character is only allowed at the
beginning of the string. For example, *,o=abcd,o=swift is allowed, but
o=abcd,*,o=swift is not allowed.
Note: This value should be taken from the Requestor’s SWIFTNet Client service
configuration (or from the BPML parameters passed to the service), in
accordance with the arrangement made between requestor and responder.

Service Name Type the name of the SWIFTNet Client service instance configuration that you created in
step 1 or use a wildcard (*)in the string. Required.
Note: This value should be taken from the Requestor’s SWIFTNet Client service
configuration (or from the BPML parameters passed to the service), in
accordance with the arrangement made between requestor and responder.

Request Type Type the request type (message type and name) supported by the file transfer responder
or use a wildcard (*) in the string. Optional.
Note: If you use a wildcard, it must appear at the end of the string. The SWIFT
Request Type generally specifies the category first (for example,
pain.001.01.01). Therefore, pain.* is allowed but *.001.01 is not allowed.
Note: This value should be taken from the Requestor’s SWIFTNet Client service
configuration (or from the BPML parameters passed to the service), in
accordance with the arrangement made between requestor and responder.

Sterling Commerce, Inc. 296


SWIFTNet Routing Rule

Parameter Description

Business Process Select the business process that will be invoked to manage the request and handle the
response to a SWIFTNet message (this is the business process that you created in step
2 that will be called when the requestor DN, responder DN, service name, and requestor
type match). Required.

Assign Priority for this Enables you to assign priority to the routing rule, if the routing parameters using the
Routing Rule (relative to wildcard are matched to an existing routing rule. This resolves the issue that occurs
other match rules) when you are using wildcards and an incoming request corresponds to two existing
routing rules. In this case, the rule with higher priority will be invoked. Optional.
Note: If no other rules match the routing parameters used for this rule, the priority will
be assigned automatically.

Note: The application attempts to locate any other routing rule defined in the system that matches with
your routing rule. You can specify the priority of your rule in relation to those matches rules.
5. Click Finish to save the routing rule. The rule is now in effect for all incoming SWIFTNet messages
(Funds, MX, or generic XML format).

Searching for a SWIFTNet Routing Rule


To edit or delete a SWIFTNet routing rule you must first specify the appropriate rule. You can locate a
specific routing rule in two ways:
✦ Search for the routing rule by name.
✦ Select the routing rule from an alphabetical list.
Searching for the routing rule by name is more precise and provides fewer results. Searching from an
alphabetical list will result in a list of all routing rules or all rules beginning with a specified letter or digit.
Once you search for the routing rule, you can easily edit or delete it from the SWIFTNet Routing Rule
interface. You can also update an existing rule by changing its priority.
Note: While creating, editing, or deleting a routing rule, a lock is held on the routing rule. Therefore, when
you are creating, editing, or deleting a routing rule, no other routing rule can be created, modified,
or deleted.

Searching for a Routing Rule by Name


To search for a routing rule by name:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Routing Rule.

2. In the Search section, type the name of the routing rule. Case does not matter and you can type part of
a name.
The application returns a list of matches unless no routing rules meet the criteria you specified.

Searching for a Routing Rule from a List

Sterling Commerce, Inc. 297


SWIFTNet Routing Rule

To select a routing rule from a list:


1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Routing Rule.
2. In the List section, select one of the following:
Š Alphabetically – Select All and click Go!
Š Alphabetically – Select a specific letter or digit (0 - 9) and click Go!
The application returns a list of matches unless no routing rules meet your criteria.

Deleting a Routing Rule


If you delete a routing rule that has matching rules applied to it, the priority of other lower-priority routing
rules is changed.
You can also delete a routing rule by assigning it priority X.

Exporting and Importing a SWIFTNet Routing Rule


The application Import/Export feature enables you to save time and increase the accuracy of duplicating
supported resources on different environments that are set up for unique purposes. To import and export
resources from one application environment to another application environment, both environments must
be the same version.
When you import a matching routing rule that uses wildcards and choose Update = Yes during the import,
the Import Routing Rule function overrides routing rules whose name is an exact match with the imported
one.
The system does not allow two routing rules (two rules with different names) to have the same combination
keys (Requestor DN, Responder DN, Service Name, and Request Type). Therefore, during the import
process, if the imported rule has the same combination keys as another routing rule in the system, the import
(update) is rejected.
When you import a rule that does not use combination keys that duplicate a combination that already exists
in the system (insert cases), the rule is assigned to the lowest sequential priority.

Sterling Commerce, Inc. 298


SWIFTNet Service Profile

SWIFTNet Service Profile


The HeaderInfo block is optional, except for those services that mandate it. If the HeaderInfo block is not
used, it must not be present, and if it is used, it must be validated by the schema.
The SWIFTNet Service Profile enables you to easily port Service Profiles from one application instance to
another. This function allows you to associate SWIFTNet Request Type with a Schema for Header
Validation. You need to create the SWIFTNet Service Profile and associate the request type with the
selected schema. This allows the application to validate the HeaderInfo when it is present in the request.
Note: The schema must be saved in application.
The Request Type parameter can accept a wildcard (*) to be used only at the end of the string. To determine
which Service Profile to be used for a particular Request Type, the application uses a best-match policy. For
example, if there are two Service Profile defined, for pain.* and pain.001.*, and the actual request type is
pain.002.001, then the first one will be selected.
Two SWIFTNet Service Profiles are preloaded into application. The pacs.* and pains.* service profiles are
associated with the Transaction Count schema and set to Required for validation. The Transaction Count
and Payment Summary schemas are also preloaded into the application.
You can also import and export SWIFTNet Service Profiles from one application instance to another.

Creating a SWIFTNet Service Profile


To create a SWIFTNet service profile:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Service Profile.
2. To the right of Create new SWIFTNet service profile, click Go!.
3. Complete the following parameters and click Next:

Parameter Description

Request Type Type the request type. A wildcard (*) is only allowed at the end of the string, for example
for example, pacs.* or pacs.001.*. Required.

Schema Name Select the schema used to validate the header information for this request type.
Required.

Validation Type Select whether validation is mandatory or should only be used if header information is
specified. Optional. Valid values are:
Š Validates only if Header Information is specified (default)
Š Validation of Header Information is required

4. Click Finish to save the service profile.

Sterling Commerce, Inc. 299


SWIFTNet Service Profile

Searching for a SWIFTNet Request Type


To edit or delete a SWIFTNet request type, you must first locate the appropriate request type. You can locate
a specific request type in two ways:
✦ Search for the request type by name.
✦ Select the request type from an alphabetical list.
Searching for the request type by name is more precise and provides fewer results. Searching from an
alphabetical list will result in a list of all request type or all types beginning with a specified letter or digit.
Once you search for the request type , you can easily edit or delete it from the SWIFTNet Service Profile
interface.

Searching for a Request Type by Name


To search for a request type by name:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Service Profile.

2. In the Search section, type the name of the request type. Case does not matter and you can type part of
a name.
The application returns a list of matches unless no request type meet the criteria you specified.
3. When the list of matches is returned, click edit next to the request type you want to modify, or click
delete next to the request type you want to remove.

Searching for a Request Type from a List


To select a request type from a list:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Service Profile.
2. In the List section, select one of the following:
Š Alphabetically – Select All and click Go!
Š Alphabetically – Select a specific letter or digit (0 - 9) and click Go!
The application returns a list of matches unless no request type meet your criteria.
3. When the list of matches is returned, click edit next to the request type you want to modify, or click
delete next to the request type you want to remove.

Exporting and Importing a SWIFTNet Service Profile


The application Import/Export feature enables you to save time and increase the accuracy of duplicating
supported resources on different environments that are set up for unique purposes. To import and export
resources from one application environment to another application environment, both environments must
be the same version.

Sterling Commerce, Inc. 300


SWIFTNet Copy Service Profile

SWIFTNet Copy Service Profile


The SWIFTNet Copy Service Profile page enables you, as a third party, to specify the relationship between
a Service Name and Copy Mode (for T- or Y-Copy). With T-Copy, the third party copy is for information
only. For Y-Copy, third party authorization is needed.
Note: You cannot define both T-Copy and Y-Copy for the same service.

Creating a SWIFTNet Copy Service Profile


To create a SWIFTNet copy service profile:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Copy Service
Profile.
2. To the right of Create new SWIFTNet copy service profile, click Go!.
3. Complete the following parameters and click Next:

Parameter Description

Service Name Type the copy service name. Required.

Copy Mode Select whether the copy mode is T-Copy (third party copy is for information only - this is
the default) or Y-Copy (third party authorization is needed). Optional.

4. Click Finish to save the copy service profile.

Searching for a SWIFTNet Copy Service Profile


To edit or delete a SWIFTNet Copy Service Profile, you must first locate the appropriate Copy Service
Profile. You can locate a specific Copy Service Profile in two ways:
✦ Search for the Copy Service Profile by service name.
✦ Select the Copy Service Profile from an alphabetical list.
Searching for the copy service profile by service name is more precise and provides fewer results. Searching
from an alphabetical list will result in a list of all Copy Service Profile or all types beginning with a specified
letter or digit.
Once you search for the copy service profile, you can easily edit or delete it from the SWIFTNet Service
Profile interface.

Searching for a Copy Service Profile by Name


To search for a Copy Service Profile by name:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Service Profile.

Sterling Commerce, Inc. 301


SWIFTNet Copy Service Profile

2. In the Search section, type the service name of the Copy Service Profile. Case does not matter and you
can type part of a name.
The application returns a list of matches unless no Copy Service Profile meet the criteria you specified.
3. When the list of matches is returned, click edit next to the Copy Service Profile you want to modify, or
click delete next to the Copy Service Profile you want to remove.

Searching for a Routing Rule from a List


To select a routing rule from a list:
1. From the application Deployment menu, select Adapter Utilities > SWIFTNet Copy Service
Profile.
2. In the List section, select one of the following:
Š Alphabetically – Select All and click Go!
Š Alphabetically – Select a specific letter or digit (0 - 9) and click Go!
The application returns a list of matches unless no Copy Service Profile meet your criteria.
3. When the list of matches is returned, click edit next to the Copy Service Profile you want to modify, or
click delete next to the Copy Service Profile you want to remove.

Sterling Commerce, Inc. 302


Configuring the WebSphere MQ Adapter/Suite to Communicate with SWIFT

Configuring the WebSphere MQ Adapter/Suite to


Communicate with SWIFT
The WebSphere MQ adapter and the WebSphere MQ Suite enable you to configure the application to send
and receive SWIFT messages to/from SWIFTNet through the WebSphere MQ Interface for SWIFTAlliance
Access (MQSA). Also enables you to send and receive messages to/from SWIFTNet though SWIFTNet
Alliance Access (SAA) and the SWIFTNet Remote API Host Adapter (RAHA).
This table describes the tasks necessary to configure the application to communicate with SWIFTNet
through either the WebSphere MQ adapter or the WebSphere MQ Suite:

Number Task For More Information

1 Configure the application to retrieve messages Configuring the Application to Retrieve


through SAA and MQSA. Messages on page 303

2 Configure the application to send messages through Configuring the Application to Send
SAA and MQSA. Messages on page 304

3 Disable the UMID and Block S options for all queues Configuring the UMID and Block S Options
within the MQ interface. on page 305

Configuring the Application to Retrieve Messages


Complete these steps to configure the application to retrieve messages from SWIFTNet through SAA and
MQSA:
Note: See WebSphere MQ Adapter and WebSphere MQ Suite documentation for more details on the
general MQ options.
1. Configure an MQ Adapter service instance:
2. Go to Deployment > Services > Configuration.
3. Next to New Service, click Go!.
4. Select WebSphere MQ Adapter and click Next.
5. Type a name for the service and a description, and click Next.
6. On the “WebSphere MQ Parameters page, type the following information and click Next:
Š Set Host Name to the name or IP address of the machine hosting the WebSphere MQ that receives
messages from SWIFT.
Š Set Listening Port to the port number for the MQ installation (if it is something other than the
default).
Š Set Queue Manager to the name of the queue manager that contains the SWIFTNet message
queues.
Š Set Queue Name to the name of the queue set up to receive messages from SWIFT.

Sterling Commerce, Inc. 303


Configuring the WebSphere MQ Adapter/Suite to Communicate with SWIFT

Š Set Server Connection Channel to the name of the connection channel associated with the queue
manager.
Š Set User ID and Password to the login information for the queue that is configured to receive
messages, if required.
Š Select the Receiving messages from WebSphere MQ (Sync) or Receiving messages from
WebSphere MQ (Async) option, depending which mode you wish to use.
Š Set the other parameters based on the specific MQ configuration desired.
7. Click Finish to save the configuration.
8. Create a business process to retrieve the messages. The following example business process retrieves a
message from MQ in synchronous mode, assuming the service configuration FromSAA was created
in step 1. Optional parameters have been set to make the business process wait for up to 10 seconds for
a message to appear before timing out:
<process name="FromSAABP">
<operation name="WebSphere MQ Adapter">
<participant name="FromSAA"/>
<output message="WebsphereMQInputMessage">
<assign to="." from="*"></assign>
<assign to="rcv_MQGMO_wait">Yes</assign>
<assign to="rcv_MQGMO_waitInterval">10000</assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>
</process>

Configuring the Application to Send Messages


Complete the following steps to configure the application to send messages to SWIFTNet through SAA and
MQSA:
1. Configure an MQ Adapter service instance:
2. Go to Deployment > Services > Configuration.
3. Next to New Service, click Go!.
4. Select WebSphere MQ Adapter and click Next.
5. Type a name for the service and a description, and click Next.
6. On the “WebSphere MQ Parameters page, type the following information and click Next:
Š Set Host Name to the name or IP address of the machine hosting the WebSphere MQ that receives
messages from SWIFT.
Š Set Listening Port to the port number for the MQ installation (if it is something other than the
default).
Š Set Queue Manager to the name of the queue manager that contains the SWIFTNet message
queues.

Sterling Commerce, Inc. 304


Configuring the WebSphere MQ Adapter/Suite to Communicate with SWIFT

Š Set Queue Name to the name of the queue set up to receive messages from SWIFT.
Š Set Server Connection Channel to the name of the connection channel associated with the queue
manager.
Š Set User ID and Password to the login information for the queue that is configured to receive
messages, if required.
Š Select the Sending messages to WebSphere MQ option.
Š Set the other parameters based on the specific MQ configuration desired.
7. Click Finish to save the configuration.
8. Create a business process to send the message. The following example business process sends a
message from MQ in synchronous mode, assuming the service configuration ToSAA was created in
step 1. .
<process name="ToSAABP">
<operation name="WebSphere MQ Adapter">
<participant name="ToSAA"/>
<output message="WebsphereMQInputMessage">
<assign to="." from="*"></assign>
<assign to="snd_MQMD_msgType">DATAGRAM</assign>
</output>
<input message="inmsg">
<assign to="." from="*"></assign>
</input>
</operation>
</process>

Configuring the UMID and Block S Options


The application does not support the UMID and block S options, so those must be disabled for all Queues
within the MQSeries Interface.
Complete these steps to disable the UMID and Block S options:
1. Open the SWIFTAlliance Workstation application.
2. Double-click the MQSeries Interface.
3. Open each queue and verify the following options:
Š For both From MQ and To MQ queues, Include UMID must be set to No.
Š For the To MQ queues, Include Block S must be set to Without Block S.

Sterling Commerce, Inc. 305

You might also like