Routing tab

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

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

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

The combination of aim_ayt and aim_proc and flavor defines the DFC function of the delivery application servayt@12.
Type – select the destination type—AIM (delivery AIM), SFM, 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 have the output transaction sent to a real destination. When the output of a production object gets recycled back through transaction production, using the ODL command resubmitTransaction(), you would discard the first iteration by sending it to NULL.
Max Retries – enter the maximum number of times the SFM tries routing the message to the named destination.
Retry Interval – enter at what interval, in seconds and milliseconds, at which the SFM retries routing the message to the named destination. Set this value to zero to stop trying to route the message.
Enable Alerts – select this option to activate alerts for this destination.
- Notification Interval – enter the interval (in seconds) at which alerts should be issued if the Max Queue Depth and Max Queue Times options are met.
- Max Queue Depth – select this option to specify the maximum number of records that a queue can hold before generating an alert. Enter a positive number to indicate the maximum number of transactions.
- Max Queue Time – select this option to enable alert notification when the top transaction in the delivery queue reaches the queue time limit (in seconds). Enter a positive number to indicate the maximum number of seconds.

Click Add to add the destination to the list.

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

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

Click New below the Routes box. Routes allow destinations to be arranged together into logical routing groups. When the SFM sends a transaction to a route, it sends the transaction to all the destinations grouped within that route in the order in which the destinations are listed.

Routes Add – enter the route name.
Priority – enter a value (from 0 to 255) that specifies the order in which transactions are processed and dispatched through this route.

All transactions that use this route have this priority unless the transactions receive a different priority from a production object, or use the route_recx priority value. 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.
Destinations – 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 that are processed by this SFM.

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 SFM Production Object Info dialog box.

Production Objects Add – enter the name for a production object, which you may have already created or will create later in TRAN-IDE.
Priority – enter a value (0 to 255) that specifies the order in which transactions are processed and dispatched to this destination.

All transactions that go to 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 priority functions set for production objects in TRAN-IDE.
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 or will create later in TRAN-IDE that should be processed by this SFM.

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

To create production object audits, right-click in the production object list and select Set Audits. This allows you to specify the production objects through which incoming and outgoing transactions must go before being sent to their destination. You see the Production Object Audits dialog box.

Entry – enter the name of the production object, or select a production object from the list, through which the SFM should process all incoming transactions before performing transaction qualification or sending transactions to their respective destinations.
Exit – enter the name of the production object, or select a production object from the list, through which the SFM should process all outgoing transactions before sending the transactions to their respective destinations.

Click Add/Modify to save your entries.

WARNING! Sybase recommends that the referenced production object not perform any data manipulation or processing because, when the entrance audit record is present, every transaction sent to this SFM passes through this production object.

Click New below the Engines box to specify one engine, or to group multiple production objects into one engine routing package. An SFM engine works with the route_veng DFC, allowing 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_veng to send a transaction.
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 SFM.