Routing tab

Select the Routing tab. Routing consists of four components—destinations, routes, production objects, and engines—which determine how transactions are sent through the router.

Click New below the Destinations box. Destinations associate a name with a flavor of aim_ayt and aim_proc. When the router sends a transaction to a specific destination, it is making aim_ayt and aim_proc calls of a specific flavor. The Router Destination Info dialog box appears.

Name (function) – enter a name that defines the destination.
Flavor (function) – enter the flavor that defines the destination.

The flavor references the aim_ayt of the expected MQDel (delivery AIM).
Type – select the destination type—AIM (delivery AIM), or NULL.

NULL is used under certain conditions when your system may produce transactions you do not want to process further. For example, when testing a new production object, you may not want to send the output transaction to a real destination. When the output of a production object is recycled back through transaction production, you must still define where the first iteration of the data should go.
Max Retries – enter the maximum number of times the router attempts to route the message to the named destination, and at what interval (in seconds). Set this value to zero if you do not want to retry routing the message.
Retry Intervals – enter the interval (in seconds) after which the router retries routing the message to the named destination.

Click Add to add the destination to the list.

Repeat this step for each destination you want to make available to this router.

To group multiple destinations into a single routing package, use the Routes box.

Click New below the Routes box. Routes allow destinations to be grouped into logical routing groups. When the router sends transactions, it is sending to all the destinations grouped in that route.

Routes Add – enter the route name.
Priority – this value determines the order in which transactions are processed and dispatched to the specified destinations.

All transactions that use this route have this priority unless the transactions receive a different priority from a production object. Priority is used by the delivery queue to determine which transaction is delivered first. This option works in conjunction with the built-in functions priority set for production objects in TRAN-IDE.
Grouped Dests – allows you to group destinations. The destinations that display are from the Destinations box on the Routing tab. Select a destination, then use the arrow keys to move destinations to the Grouped Dests list.

Click Add. Repeat this step for all routes processed by this router. Click Cancel to cancel the route without saving the changes.

Click New below the Production Objects box to specify one route or to group multiple routes into one production object routing package. You see the Router Production Object Info dialog box.

Production Objects Add – enter the name for a production object, which you must have already created in TRAN-IDE.
Priority – this value determines the order in which transactions associated with this production object are processed and dispatched to the specified destinations. Production object priority supersedes route priority.
Grouped Routes – allows you to group multiple routes into one production object. The routes that display are from the Routes box on the Routing tab. Select a route, then use the arrow keys to move routes to the Grouped Routes list.

Click Add. Repeat this step for all production objects you have created in TRAN-IDE to be processed by this router.

To enlarge the Production Objects box, right-click in the box and select DoubleWide.

Click New below the Engines box to specify one engine or to group multiple production objects into one engine routing package. A router engine works with the route_sync, which allows you to limit the number of production objects used to parse and qualify a transaction.

Engines Add – enter the engine name to specify in the Engine parameter when using route_sync to send a transaction.
Grouped ProdObjs – the objects that display are from the Production Objects box on the Routing tab. Select a production object, then use the arrow keys to move the object to the Grouped ProdObjs list.

Click Add. Repeat the procedure for all engines processed by this router.

Click Apply to save the entries.