Friday, February 3, 2017

Search SWIFT messages by ID and Content

Purpose

Use the ID & Content tab to search for messages based on their format, Unique Message Identifier (UMID), or the content of the message.
You can search for messages on the basis of the sender, receiver and what the message contains. You can search for a particular type of message, such as financial messages, and then search on some aspect of their contents, such as their amount fields. You can search for messages by specifying a search text. You can also search for messages based on a FINCopy service, a Banking Priority, or on a MUR.
Use the ID & Content tab to search for the following types of messages:
  • Any
  • FIN
  • File
  • Internal
  • Other Standard

UMID

The UMID is the most common criteria to use in searches. You can search for all input or all output messages using a general UMID search. Alternatively, you can specify a full UMID to search for a specific message.
The fields in the UMID panel contain the format and UMID of the messages to be searched for. The fields displayed in this panel depend on the format of the message.

To specify ID and Contents criteria:

  1. Click the ID & Content tab.
  2. The items in the Standards list depend on the packages for which you are licensed and the MX Message Standards that are installed.
    The Service Name field is filled automatically with the service that corresponds to the standard selected (for example, swift.if.ia).
    If you select Any, FIN, or Internal, then only the Standard field appears in this pane.
    The fields FIN Copy Service, Banking Priority, and MUR are only available if Standard FIN is selected.
    In the Standard field, if you select an MX standards (for example, Funds), then the Service Name, Message Name, and Identifier fields appear.
    The search returns messages for the "live" service only. The extension is always present to type additional characters such as %, p or x. Entering % as an extension returns messages for the live service as well as any messages that may have been created for any other implementation of that service, for example (!pu1).
    Select the required Message Name from the drop-down list. The system automatically completes the Identifier field. If the Message Name field is empty, then all the messages for the selected Standard are used for the search.
    If you select File, then you can specify a Service in the Service Name field. If you leave this field empty, then the search returns all the messages (of all the services) of type File.
    If you select Other Standard, then you must enter a Service in the Service Name field, and optionally, in the Identifier field (entries cannot be made in the Message Name field). If the Service Name field is left blank, then Input and Output messages appear for all Services.
  3. The UMID or Other (for MX message standards) pane allows you to define the structure of the message UMID. In these fields, you can either specify the UMID in full, to locate an individual message, or you can specify messages, in part, by using wildcard characters.
    Wildcard characters are as follows:
    • _, to replace one unknown character in a string
    • %, to replace zero, one or more contiguous unknown characters in a string
    When searching for Correspondent or Reference, the use of the "%" wildcard is not recommended, because the search results may not be as expected. Instead, you should search for Sender or Receiver (in the Content part), as appropriate.
    In the I/O field, select:
    • I, to search for input messages, that is, messages that have been created for input to a network, for example, SWIFT network
    • O, to search for output messages, that is, messages that have been received from a network
    • %, to search for both input and output messages.

For SWIFT MT message format

  1. In the Correspondent field, type the eleven-character BIC address of the sender (if the message was output from the network) or the receiver (if the message was input to the network). If no specific branch code is given, then the last three characters of the BIC address default to ___ (for example, three wildcard characters).
    For messages with a directional indicator of:
    • I, the BIC address identifies the receiver of the message
    • O, the BIC address identifies the sender of the message.
    The other fields in this panel vary depending on the message format that you selected.
  2. In the Type field, enter the SWIFT message type that is the object of the search. If only a partial message type is entered (or the complete message type in the case of message type allowing multiple formats) and the Tab key is pressed, then a list is shown of all message types starting with the entered message type. For example, in the case of message type 103, the options MT103, MT103.STP and MT103.REMIT appear, where STP and REMIT are the Qualifiers.
  3. In the Qualifier field, if an entry has not been selected through the Type field, then enter either the Qualifier Name to be used or a wild-card symbol, % or _. If no entry is made, then the system default is %.
  4. In the Reference field, enter the transaction reference number. The transaction reference number is located field 20 of the MT message.

For SWIFT MX message format

  1. In the Correspondent field, type the eight-character BIC address of the sender (if the message was output from the network) or the receiver (if the message was input to the network).
  2. In the Reference field, enter the user reference.

For all other message formats

  • Type a reference number in the Reference field. This number is taken from the header or message text.

To specify content criteria for MT messages:

  1. Click the Sender and Receiver in the Content panel and select the message sender and receiver for your search. If you select Institution, Department, Application or Individual, then additional text fields appear for you to type the name of the institution, department, application, or individual.
    Note
    For more information about sender and receiver definitions, see updating the correspondent information file in the System Management Guide.
  2. Click Nature and select the exact business nature of the messages that you are searching for:
    • All
    • Financial
    • Text
    • Network
    • Security
    • Binary
    • Service
    Note
    If you selected Templates in the Source & Creation tab or All as the message nature, then no other fields appear in this panel.
  3. In the Transaction reference field, type a transaction reference number.
  4. In the Related reference field, type a related transaction reference number. A related transaction reference number is often included in a message to connect it to one previously issued by the correspondent. In other words, a related transaction reference number is the transaction reference number of a previous message. This information is taken from field 21 of the SWIFT message text.
  5. In the Search text field, type a text string.
    Note that there are search restrictions:
    • Input information is case-sensitive.
    • The search is limited to block 4 of the message.
    For improved results, use wildcards. You can specify the character string fully or partially by using the following wildcard characters:
    • o _, to replace one unknown character in a string. For example, type A_Z to match both AUZ and ABZ.
    • o %, to replace zero or more contiguous unknown characters in a string. For example, type A%Z to match both ABCDEZ and AZ.
  6. In the FIN Copy Service field, select a FINCopy service. Select All to find messages that have a FINCopy service value. If you leave this field empty, then this criteria is not taken into account.
  7. In the Banking Priority field, specify a banking priority of four alphanumeric characters maximum.
  8. In the MUR field, specify a MUR of 16 characters maximum. You can type alphanumeric characters, wildcards characters (%_), and /-?:().,'+.
Note
The fields FIN Copy Service, Banking Priority, and MUR are only available if Standard FIN is selected.

For Financial message nature

  1. If you selected Financial as the message nature, then additional fields appear.
  2. In the Amount fields, type an amount range. If you want to search for a message that contains a specific amount, then enter this amount in both the From and To fields.
  3. In the Cur field, type a 3-character currency code. The currency is in ISO format, for example, GBP or USD. You must complete this field if you specified an amount.
  4. In the Value Date fields, type a date range.
Note
The formats for the amount and date values are set by configuration parameters in the System Management application. For more information, see configuring system parameters in the System Management Guide.

To specify content criteria for MX messages:

If you select an MX message-related option in the Standards field in the Message Format pane (such as Cash Reporting or Funds), then three additional fields appear to enter MX keywords as search criteria:
  1. Click the Sender and Receiver in the Content pane and select the message sender and receiver for your search. If you select Institution, Department, Application or Individual, then additional text fields appear for you to type the name of the institution, department, application, or individual.
  2. In the MX Keyword 1, MX Keyword 2, and MX Keyword 3 fields enter search data as required. Wildcard characters can also be used in the search.
  3. In the Search text field, type a text string.

1 comment: