Routing rules allow you to route the results of pipeline processing
or acquisition program to a database, a pipeline, or an external system. You
configure routing rules in the Configuration Console on the Routing
Rules tab, but you can only route from pipelines or acquisition
programs that have been registered with the application monitor. You can either
configure a new routing rule from scratch or based on an existing routing
rule.
Before you begin
- The pipeline or acquisition program you want to route from must be registered
with the application monitor.
- You must know the exact unique name that was used to register the pipeline
or acquisition program.
- You must know which transport method to use and the specific transport
URI syntax you must use to route to the destination.
- Click the Setup tab.
- Click the General tab.
- Click the Routing Rules tab.
- Do one of the following:
- To configure a new routing rule, click the New button.
- To configure a new routing rule based on an existing routing rule,
select the check box next to the routing rule you want to base the new rule
on and click the Clone button.
- Required: In the From Pipeline field,
enter the registered name of the pipeline or application program that you
want to route from. The name you type must be an exact match to
the name registered on the Pipelines tab.
- Required: In the Order field,
enter a number from 0-999 that represents the order in which the system should
use this routing rule. The system defaults this field to 0, which
is the first routing rule processed for any pipeline or acquisition program.
The number in this field must be unique for this pipeline or acquisition program,
especially if there are multiple routing rules already configured for the
pipeline or acquisition program.
Note: Look in the left pane on this tab
at the list of pipelines or acquisition programs that have existing routing
rules configured. If you see this pipeline or node in the list, look for the
highest number following the colon after the pipeline or acquisition program
name, and then enter the next highest number. For example, if you are configuring
a new routing rule for PIPE08, and you see PIPE08:0 in the left pane list,
you must enter the number 1 or higher in the Order field.
- Required: In the Destination field,
enter the transport URI for the destination of the routed information. This
informs the system on how to route to the intended pipeline, database, or
external system destination.
Note: For routing to be successful,
the destination process must be accessible using the same transport URI that
is specified. For example, if the destination is a pipeline, the pipeline
must be started using the same transport URI.
- Required: In the Document drop-down
list, select the UMF document type to indicate the message type to route to
the destination.
- Optional: In the Route Filter field,
enter a filter to apply to the information to be routed, so that the system
only routes particular information to the destination. Filters
are an advanced routing rules feature. You type a filter expression MODDIST(UMF_tag_name ,
where (UMF_tag_name indicates the
name of the UMF tag the system uses to distribute the records.
- Required: In the Enabled drop-down
list, select Yes to enable this routing rule.
- Required: Click the Save button.
What to do next
The name of the pipeline or acquisition program displays in the
Routing
Rules tab with the details of the routing rule you just configured.
The system begins routing information from the pipeline or acquisition program
to the destination, using the configured routing rule.