IM Relationship Resolution Information Center, Version 4.2

Configuring routing rules

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:
Procedure:
  1. Click the Setup tab.
  2. Click the General tab.
  3. Click the Routing Rules tab.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. Required: In the Document drop-down list, select the UMF document type to indicate the message type to route to the destination.
  9. 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.
  10. Required: In the Enabled drop-down list, select Yes to enable this routing rule.
  11. 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.


Feedback

Last updated: 2009