webMethods FIX Module 7.2 FCS
Sample Package User’s Guide
About webMethods FIX Module Sample Package
The WmFIXSample package provides samples that illustrate how to use webMethods
FIX Module. Using two Integration Servers, the samples allow you to simulate sending
and receiving messages between two partners and demonstrate the usage of Integration
Server document types for processing incoming FIX messages. The samples include the
following:
 Sample Trading Networks configuration items, including sender and receiver
profiles, a document type that corresponds to the FIX message types included with
the sample, and a processing rule for processing incoming messages.
 Sample FIX Module services to demonstrate sending FIX messages. The sample
includes an “Execution Report” message type for both FIX version 4.4 and FIX 5.0, as
well as an encoded “Execution Report” message type for FIX version 4.4.
 A sample FIX Module service to demonstrate the processing of a received FIX
(version 4.4) message and a sample Integration Server document type that maps to
Execution Report FIX messages.
The following diagram illustrates a high-level configuration for using the WmFIXSample
package.
WmFIXSample Package Configuration
1
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
Before You Begin
Important! FIX Module samples only demonstrate the features of the module and must not
be used in the production environment. You must delete the WmFIXSample package
before you go into production.
The information in this guide assumes that you are familiar with Integration Server,
Trading Networks, and Designer. Before installing the sample package, complete the
following tasks:
 Install two Integration Servers on different machines so that one can serve as the
seller (sender) and the other as the buyer (receiver). You cannot run the entire sample
package on a single computer where two Integration Servers are installed. For
information about installing Integration Server, see the webMethods Installation
Guide that corresponds to your release.
 Install webMethods FIX Module 7.2 and all its dependent components on each
Integration Server. For information about installing webMethods FIX Module, see
webMethods FIX Module Installation and User’s Guide. Install My webMethods and My
webMethods Server on each Integration Server. For more information, see the
webMethods Installation Guide that corresponds to your release.
Setting up Seller and Buyer (Sender and Receiver)
The following diagram illustrates the high-level steps for setting up the seller (sender)
and buyer (receiver). You will execute these steps once to set up the sender and once to
set up the receiver.
For instructions, see “Set Up a Sample Seller (Sender)” on page 3 and “Set Up a Sample
Buyer (Receiver)” on page 5.
2
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
WmFIXSample Package Configuration Steps
Set Up a Sample Seller (Sender)
To use the packages to simulate sending messages, on one Integration Server, define the
FIX engine connection for the seller by executing the following tasks:
 Define the seller’s connection to the FIX engine and the corresponding values for the
local_firm_id and the remote_firm_id (as described below). FIX Module uses the
values of the local_firm_id and the remote_firm_id to distinguish the seller (sender)
from the buyer (receiver). The values you use to define the seller will be reversed
when you define the buyer’s connection information.
 Set up the seller’s enterprise profile.
 Import the document types and buyer’s partner profile into Trading Networks.
The remainder of this section explains how to complete these tasks.
Step 1: Define the Seller’s (Sender’s) Connection
Define the connection to the FIX engine as the seller by specifying the following values in
the seller’s Appia.ini configuration file.
 Define the connection = “SELLER”
3
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
 Define the value of the local_firm_id = COMP2
 Define the value of the remote_firm_id = COMP1
The configuration file should resemble the following:
[MAIN]
….
connection = [SELLER]
….
[SELLER]
local_firm_id = COMP2
remote_firm_id = COMP1
….
Step 2: Set Up the Seller’s (Sender’s) Enterprise Profile
The enterprise profile must have a FIX_ID that matches the value of the local_firm_id
defined in the seller’s Appia.ini configuration file.
To set up the seller’s enterprise profile
1
In My webMethods, create the seller’s enterprise profile using the instructions for
defining and managing profiles as described in the Trading Networks user’s guide
that corresponds to your release.
2
Define the value of the External ID Type, FIX_ID = “COMP2”
Step 3: Import the Document Type and Buyer’s Trading Profile into
Trading Networks
The WmFIXSample package includes the following items relating to the buyer’s
(receiver’s) side of the message transaction:
 Trading partner profile named “BUYER”
 Trading Networks document type “FIX Execution Report.” This corresponds to the
message type that is also included in the package.
To import these items from the sample package into Trading Networks
1
In My webMethods, select Administration > Integration > B2B > Asset Management.
2
In the Upload File Group box, click Choose file.
3
Open the file IntegrationServer_directory/packages/WmFIXSample/data/
Buyer_TN_Import.
4
Click Extract Assets.
4
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
Step 4: Ensure the Sender’s FIX Module is Configured with the Appia
Engine
To ensure the sender’s FIX Module is configured with Appia connection details, perform
the following:
1
At the Appia engine, run the middleware_stats command. This displays a list of
connections.
2
Ensure there is a connection listed for each of the sessions you configured in FIX
Module.
Using Services for Sending
The following sample services illustrate how to send “Execution Report” type FIX
messages:
 sendExecutionReport44 sends FIX version 4.4 messages
 sendExecutionReport44_encodedField sends encoded FIX version 4.4 messages
 sendExecutionReport50 sends FIX version 5.0 messages
For more information about send services, see “WmFIXSample Package Services” on
page 7.
Set Up a Sample Buyer (Receiver)
To use the packages to simulate receiving messages-Monica on a different Integration
Server from where you defined your seller (sender) information, define the FIX engine
connection for the buyer (receiver) by executing the following tasks:
 Define the connection to the FIX engine and the corresponding values for the
local_firm_id and the remote_firm_id (as described below). FIX Module uses the
values defined for the local_firm_id and the remote_firm_id to distinguish the seller
(sender) from the buyer (receiver). To define the buyer, reverse the values of the
local_firm_id and the remote_firm_id from the values you previously defined for
the sender.
 Set up the buyer’s enterprise profile.
 Import the document type and seller’s partner profile into Trading Networks.
Step 1: Define the Buyer’s (Receiver’s) Connection
Define the connection to the FIX engine as the buyer by specifying the following values in
the buyer’s Appia.ini configuration file:
 Define the connection = “BUYER”
 Define the value of the local_firm_id = COMP1
5
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
 Define the value of the remote_firm_id = COMP2
The configuration file should resemble the following:
[MAIN]
….
connection = [BUYER]
….
[BUYER]
local_firm_id = COMP1
remote_firm_id = COMP2
….
Step 2: Set Up the Buyer’s (Receiver’s) Enterprise Profile
The enterprise profile must have a FIX_ID that matches the value of the local_firm_id
defined in the buyer’s Appia.ini configuration file.
To set up the buyer’s enterprise profile
1
In My webMethods, create the buyer’s enterprise profile using the instructions for
defining and managing profiles as described in the Trading Networks user’s guide
that corresponds to your release.
2
Define the value of the External ID Type, FIX_ID = “COMP1”
Step 3: Import the Document Types and Profiles into Trading
Networks
TheWmFIXSample package includes the following items relating to the seller’s side of the
message transaction:
 Trading partner profile named “SELLER”
 Trading Networks document type “FIX Execution Report”
 A processing rule named “ReceiveExecutionReport44.” This processing rule saves
“ExecutionReport44” FIX messages to the Integration Server document format
pipeline directory in IntegrationServer_directory/pipeline.
To import these items from the sample package into Trading Networks
1
In My webMethods, select Administration > Integration > B2B > Asset Management.
2
In the Upload File Group box, click Choose file.
3
Open the file IntegrationServer_directory/packages/WmFIXSample/data/
Seller_TN_Import.
4
Click Extract Assets.
6
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
Step 4: Ensure the Buyer’s FIX Module is Configured with the Appia
Engine
To ensure the sender’s FIX Module is configured with Appia connection details, perform
the following:
1
At the Appia engine, run the middleware_stats command. This displays a list of
connections.
2
Ensure there is a connection listed for each of the sessions you configured in FIX
Module.
Services Used for Receiving
When FIX Module receives a FIX message type of “Execution Report,” the processing
rule invokes the receiveExecutionReport44 service.
For more information, see “WmFIXSample Package Services” on page 7.
WmFIXSample Package Services
TheWmFIXSample package contains services to simulate sending and receiving
messages to help you with configuring FIX Module. This section describes the sample
services in the WmFIXSample package.
wm.fix.sample.outbound:sendExecutionReport44
Sends a FIX message of type Execution Report, version 4.4, to the Appia engine using the
session "SELLER". After this service is executed the FIX message is persisted in Trading
Networks and sent to the Appia engine. To send an encoded FIX message, use
sendExecutionReport44_encodedField.
Input Parameters
None.
Output Parameters
None.
7
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
wm.fix.sample.outbound:sendExecutionReport44
_encodedField
Sends an encoded FIX message of type Execution Report, version 4.4, to the Appia engine
using the session "SELLER". After this service is executed the FIX message is persisted in
Trading Networks and sent to the Appia engine. This service provides a layer of security
when sending FIX messages. To send a non-encoded FIX message, use
sendExecutionReport44.
Input Parameters
None.
Output Parameters
None.
wm.fix.sample.outbound:sendExecutionReport50
Sends a FIX message of type Execution Report, version 5.0, to the Appia engine using the
session "SELLER". After this service is executed the FIX message is persisted in Trading
Networks and sent to the Appia engine.
Input Parameters
None.
Output Parameters
None.
wm.fix.sample.inbound:receiveExecutionReport44
Converts the FIX message into the IS Document format.
In the sample, this is set as a service to be executed for the Trading Networks processing
rule "Receive Execution Report 44". Therefore, whenever a FIX message of type
ExecutionReport is persisted in Trading Networks, this service is executed.
Input Parameters
bizdoc
Document The business document (FIX message) received. For details
about the structure of this document, see the description for
wm.tn.rec:BizDocEnvelope in webMethods Trading Networks Built-in
Services Reference.
8
webMethods FIX Module 7.2 FCS Sample Package User’s Guide
Output Parameters
ExecutionReport
Document The IS Document type of the incoming FIX message.
9