Page Comparison

...

You can manage message streams as follows:

• Test a Message Stream
• Run a Message Stream Ad Hoc
• View Message Stream Messages

Image Removed

About Data Triggered Message Streams

When you create message streams that will be triggered by events outside of Automation Center, such as arrival of data files from third party vendors, you can only monitor the stream status and resolve any generated exceptions in the Automation Center. These message streams cannot be scheduled.

About Scheduled Message Streams

When you create message streams that will be scheduled, you can add them to jobs, and schedule Message Stream events to run on demand or on a schedule.

About Default Message Streams

Eagle provides a set of default message streams that you can copy and modify to suit the needs of your business. Eagle's default message steams display a negative number in the Message Stream ID column (for example, -2108) and have the following naming convention:

eagle_*

Note

Eagle recommends that you do not create custom message streams with eagle_* names and that you do not change or delete Eagle's default message streams.

About Data Formatting Files

From the Events workspace, you can access and modify data formatting files used by message streams to transform and prepare data for loading into and out of Eagle databases. Reviewing and modifying data formatting files may be useful when troubleshooting message stream issues.

Each message stream specifies data delivery instructions (inbound or outbound in relation to Eagle databases), supports a single data format, and uses a single Ruleset file. A Ruleset file directs data in the message stream to the appropriate Rule file for formatting based on the message type. For example, if the message stream is designed to load security reference data, the Ruleset file may route fixed income securities to one Rule file for processing and equity securities to another Rule file.

For inbound message streams, the Rule file parses the incoming data and performs any additional lookups and validations. The data elements are then mapped to the Eagle tag format to allow loading into Eagle databases. For outbound message streams, the Rule file maps the data extracted from Eagle databases to the external system's specified format and performs any additional processing, if required.

Note: Eagle also supports the Eagle ML 2.0 XSD specification with a set of generic XML-based interfaces described as XSD and implemented on the Message Center framework as message streams. Eagle ML allows you to exchange data with increased accuracy and achieve optimal data exchange efficiency. For more information about EagleML, visit the EagleML wiki pages.

You can test message streams to ensure they are valid prior to being run.

...

1. In Automation Desk, click Events in the left navigation. Or, click Monitor in the left navigation and in the upper left corner of the Monitor workspace, under Select Type, click Message Streams.
2. In Events workspace, search for message streams and filter by status (Disabled Streams or Enabled Streams). You can add other search criteria as needed. In the Monitor workspace, search by Stream Name, Stream Category, or DB Partition.
3. Click the message stream you wish to test and click Test.
   Image Removed
4. Click OK in the confirmation dialog box.
5. If the message stream did not pass the test, click the message stream and click Edit to make the edits.

In Automation Desk, you can run message streams ad hoc with or without overrides, or send a data file to the message stream to trigger it to run. For example, you can run a scheduled message stream outside of the existing schedule if the required data files are available. To monitor the status of message streams submitted ad hoc, access the Monitor workspace.

Run a Message Stream without Overrides

To run a message stream without overrides:

...

...

...

Run a Message Stream with Overrides

To run a message stream with overrides:

1. In Automation Desk, click Events or Schedule in the left navigation. Or, click Monitor in the left navigation and in the upper left corner of the Monitor workspace, under Select Type, click Message Streams.
2. In Events or Schedule workspace, search for message stream(s) and you can add other search criteria as needed. In the Monitor workspace, search by Stream Name, Stream Category, or DB Partition.
3. If needed, you can test the message stream before running.
4. Click the message stream you wish to run, click the Submit drop down and click Submit with Overrides.
   Image Removed
5. If the QueryEvent Rule file does not exist, click OK in the information dialog box.

6. In the Run with Overrides dialog box:

   • Click the Tags tab and click the green plus sign to add an override. Click the red X to remove an override.
     Image Removed 
   • Click the Parameters tab and click the green plus sign to add a parameter. Click the red X to remove a parameter.
   • If applicable, click the Load From Rules button to read the MSGEXCHANGE definition in the query event rule and parse it into parameters.
   • Click OK in the Run with Overrides dialog box to save your changes.
7. Click OK in the confirmation dialog box.
8. To view the message stream status, click Monitor in the left navigation.

Trigger Message Stream with a File

To trigger a message stream with a file:

1. In Automation Desk, click Events in the left navigation. Or, click Monitor in the left navigation and in the upper left corner of the Monitor workspace, under Select Type, click Message Streams.
2. In Events workspace, search for message streams and you can add other search criteria as needed. In the Monitor workspace, search by Stream Name, Stream Category, or DB Partition.
3. If needed, you can test the message stream before running.
4. Click the message stream you wish to run, click the Submit drop down and click Send File.
   Image Removed
5. In the Open dialog box, select the appropriate file and click Open.
6. Click OK in the confirmation dialog box.
7. To view the message stream status, click Monitor in the left navigation.

You can view messages processed by each stream by accessing the Message Status workspace from the Message Streams workspace or from the Monitor workspace.

View Message Streams

To view message stream messages:

...