SWIFT Correlation Repository Sample

The SWIFT Correlation Repository (SCR) is a Java CAPS utility used to visualize SWIFT workflows. In addition, the SCR:

• Reconciles Messages into Transaction Processes

• Provides Message Browsing and Message Monitoring

• Offers services for Duplicate Checking and validation of MX and MT messages

• Allows for Message Repair and Resubmit

Prerequisites

The following prerequisites are needed in order to run the SRC project:

• Windows Operating System

• Java CAPS 5.1.3, with the following modules:

  • eGate

  • eVision

  • Oracle eWay

  • File eWay

• SWIFTOTDLibrary.sar

• Oracle 9.2

• Internet Explorer

Installation steps

1. Ensure all prerequisites are installed.

2. Install Hotfix 109645 for the Enterprise Designer.

3. Install the database schema from the SCR_CreateUser.sql and SCR_CreateTable.sql files (located in the SCR_Create_Cleanup zip file).

4. Extract the contents of the SampleSCR.zip file into your local drive.

5. Import the SampleSCR.zip file into Enterprise Designer.

6. Set the environment variables (as shown in the figure below).

   

7. Create a deployment profile in the SCR project.

8. Create a deployment profile in the TesterGatekeeper project.

9. Deploy both the SCR and TesterGatekeeper deployment profiles.

Preparing an SCR flow

The SCR Workflow follows the tasks, procedural steps, required input and output information, for each step in the business process. The SCR workflow is used to view, manage, and enforce the consistent handling of work. The following figure is an example of a design of an SCR flow.

Designing an SCR flow

1. Start the Enterprise Designer.

2. Open the imported SCR project.

3. Choose both a short name and a long name for the flow (example: t2 :: Target2).

4. Choose a string name for each event / message / direction (as shown in the SCR flow example above: TO_SWIFT_INIT).

5. Add the flow name as a new choice in the viewer by navigating to the Viewer on the SCR page, then to the 1TrxList, and then to the pgTrxList.

   1. On the Properties tab, select SelDomain.

   2. Right-click the highlighted area on the design canvas, and select Edit Options. The Edit Options window opens.

   3. Add new flow elements to the properties of the control SelDomain. This project already ahs defualted values entered (t2 :: Target2).

Linking the Domain Name and Direction to a Color

You can link the name of a Domain to specific pointer directions and colors within the monitoring application.

1. Link the domain name and the direction to a color by opening the SCR.properties file located in c:\SampleSCR\properties.

2. A list of available directions and colors are listed in the SCR properties file. Possible Colored Directions (CD) for message lists include:

   • DEFAULT

   • LGREY, RGREY

   • LBLUE, RBLUE

   • LGREEN, RGREEN

   • LORANGE, RORANGE

   • LRED, RRED

3. Link the Domain to a specific pointer directin and color by using the following Syntax: CD_<Direction String> = <Colored Directions>.

Using the SCR for Monitoring Flows

Applications that send events to the SCR must do two things:

1. Create a message following the input format shown below. Do not use the field whose usage is indicated as “Gatekeeper only”.

   

2. Send the message to either:

   • A file in the c:\SampleSCR\In location, with a .txt extension and a name starting with Loader.

   • A JMS message to the JMS queue, qSCRInEnv, in SCR/Loader.

Using the Viewer for Monitoring Transactions

1. Use an Internet browser and navigate to the URL http://localhost:18001/scr. The Select Transaction window opens.

2. Use one of the following criteria for monitoring transactions:

   • Select the 10 most recently updated transactions from the drop-down list.

   • Use the domain selector to restrict the transaction list.

   • Search for a transaction with a specific ID.

   • Search for a transaction that contains a message with a specific ID.

3. Click the Search button.

Using the SCR as Gatekeeper

Applications sending events to the SCR as Gatekeeper must do two things:

1. Create a message following the input format (as shown in the previous section)

2. Send the message to the JMS queue “qGKeeperIn” in SCR/Gatekeeper. Make sure to add a JMS topic to the message. A code sample is shown below.

   com.stc.connectors.jms.Message outMsg = jmsPublish.createTextMessage(); outMsg.storeUserProperty( "SCRDestination", "DEST1" ); outMsg.setTextMessage( input.getText() ); jmsPublish.send( outMsg );

3. Subscribe to the JMS queue ”qGKeeperOut” in SCR/Gatekeeper.

4. Subscribe to the JMS topic that you used to publish the message.

A complete test setup is located in the project TesterGatekeeper.

Using the Viewer to Repair Messages

1. Use an Internet browser and navigate to the URL http://localhost:18001/scr. The Select Transaction window opens.

2. Select the 10 most recently updated transactions from the drop-down list. Messages that have been held for review and resubmittion (e.g. messages that are duplicates, incorrect, or awaiting approval) are displayed.

3. Select the message you wish to examine and click the Repair button. The Message Repair window opens, displaying detailed information regarding the message.

4. You can resolve the message in the following ways:

   • Correct the message error and click the Resubmit button.

   • Examine a message that requires approval and click the Approve button.

   • Delete the message by clicking the Delete button