Set Up Pending Transactions

If you plan to manage pending transactions prior to processing transactions in the STAR accounting engine, review the pending trade workflow and consider how you plan to use it to manage transactions from upstream systems. You can identify transactions as pending in your upstream systems. You can alternatively have the Eagle system assign transactions received from upstream systems as pending transactions if they meet the criteria defined in pending trade rules. You can use pending trade rules to set up criteria for how the system manages open, close, and cancel transactions.

If you use pending trade rules, you must set up those rules and identify the entities that use pending trade rules. If you do not plan to use pending trade rules but still plan to manage pending transaction activity, you must ensure that incoming transactions include the proper information.

You can also perform setup tasks to improve system performance when you manage pending transactions.

On this page

1 Set Up Entities
2 Set Up Pending Trade Rules
3 Set Up Transactions
4 Set Up Engine Thresholds in boot.ini

Set Up Entities

The Pending Trade Eligible Indicator (tag 3679) field at the entity level allows the system to apply pending trade rules to an entity that allow the system to classify the transaction as pending. If you plan to set up pending trade rules that enable the Eagle system to identify certain transactions as pending transactions, you must identify the entities for which you plan to utilize pending trade rules before you can process pending transactions for those entities. For each entity for which you plan to use pending trade rules to determine whether to pend a trade, set the entity's Pending Trade Eligible Indicator field to Yes. The Pending Trade Eligible Indicator field indicates if any entity is eligible for use with pending trade rules, but does not indicate whether an entity is eligible for use with pending transaction activity. Any entity is eligible for use with pending trade activity so long as you identify transactions as pending in an upstream system, and do not require the system to use pending trade rules to pend the transaction. Whenever the system receives a transaction from an upstream system for an entity, if the incoming transaction's Pending Trade Flag field (tag 3695) has a value of Y, the system does not need to apply pending trade rules to the transaction. The system does not consider the entity's Pending Trade Eligible Indicator field value in this case. The Pending Trade Eligible Indicator option is available when you create or edit an entity or master fund in the Create/Edit Entity panel, the Create Master Fund panel, and the Edit Master Fund/Sector panel.

The PT Rule Name (tag 17026) option is available when you create or edit an entity in the Create/Edit Entity panel and you set the Pending Trade Eligible Indicator field to Yes. This option specifies the name of the pending trade (PT) rule to use for the selected entity. If you identify a PT Rule Name for one or more entities at the entity level, the system can apply only pending trade rule details that uses this PT Rule Name to the selected entity. Otherwise, if you do not specify a value, the system does not consider the PT Rule Name value when identifying the appropriate pending trade rule details to apply to the entity. For more information, see Manage Pending Trade Rule Names.

Set Up Pending Trade Rules

Pending trade rules, previously called flagged position rules, specify the criteria that the system uses to assign a pending status to transactions that require evaluation prior to processing. For detailed information about setting up pending trade rules, see Manage Pending Trade Rules.

If you want the system to apply only certain pending rules to an entity, you can use several approaches. In one approach, you can assign a PT Rule Name to one or more entities at the entity level and also assign the PT Rule Name to the corresponding pending trade rule details so that the system applies those pending trade rules only to entities that use the PT Rule Name. In this scenario, the system applies generic rules with no PT Rule Name specified only to those entities with no PT Rule specified.

In another approach, you do not use PT Rule Names. Instead, you can specify an entity at the pending trade rule detail level to indicate that the system can apply the pending trade rule details only to that entity. If you set up pending trade rule details with no entity specified in the rule details, the system can apply those rules to any entity eligible for use with pending trade rules.

When you set up pending trade rules, you can identify numerous criteria for each rule detail. For example, a pending trade rule can apply to a specific

Set Up Transactions

When the system receives a transaction from an upstream system for an entity, if the transaction is already identified as eligible for pending transaction processing because the incoming transaction's Pending Trade Flag field (tag 3695) has a value of Y, the system does not need to apply pending trade rules. The system does not consider the Pending Trade Eligible Indicator field value. The system routes the transaction to the Pending Trades table for further evaluation. It also assigns the appropriate status to the transaction.

When the system receives a transaction from an upstream system for an entity where the Pending Trade Eligible Indicator field is set to Yes, if the incoming transaction meets the criteria for a pending trade rule details and passes the Message Center panel edits that validate the transaction date, the system assigns the transaction's Pending Trade Flag field (tag 3695) to Y. For transactions with a Pending Trade Flag field (tag 3695) to Y, the system routes the transaction to the Pending Trades table for further evaluation. It also assigns the appropriate status to the transaction.

Set Up Engine Thresholds in boot.ini

You can configure configurable threshold limits in the STAR engine's boot.ini file to reject transactions that may affect a very large position with many lots. This can prevent processing transactions that can have significant impact on system performance. The STAR engine checks certain threshold limits as a pre-processing step. If the limits are exceeded, then the engine does not process the transactions, but routes them to the Workflow Manager for subsequent exception handling.

You can configure the limits based on the amount of records in either the Cost or Cash positions to be acted on by a transaction. You can also configure the limits based on the number of records rolled back by a transaction or the number of loopbacks produced as a result of processing a transaction.

Once you set up the thresholds, before processing a transaction against a position, the system uses these thresholds to determine if there would be a significant impact to processing. If any of these thresholds are exceed, the system rejects the transaction and sends the failed transaction to the Workflow Manager for subsequent exception processing. The system can then process the transaction in a dedicated engine so that it does not impact normal processing.

The processing thresholds, which are disabled by default, include the following:

RollbackThreshold. Maximum allowed number of rows to be rolled back. The default value is 25000.
CostPositionMaxRowThreshold. Maximum allowed number or rows in a Cost position. The default value is 25000.
CashPositionMaxRowThreshold. Maximum allowed number or rows in a cash position. The default value is 25000.
LoopbackMaxCountThreshold. Maximum allowed number of loopbacks produced. The default value is 10000.

You can enable the first three thresholds by adding the following parameter to the engine's book.ini file.

ProcessingThresholdsEnabled = 1

You can enable the LoopbackMaxCountThreshold by adding the following parameter to the engine's book.ini file.

LoopbackMaxCountThresholdEnabled = 1