Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

If you plan to use 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 some or all of the following types of information: 

  • Entities
  • Pending trade rule details
  • Transactions
  • Boot.ini file
PanelborderColor#9F9F9FtitleColor#F7F9F9titleBGColor#B48436borderStyledashedtitleContent on this page:

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

Table of Contents
maxLevel2
indent2 px
Highlight

WRITERS NOTE: This entity info duplicates what was in the About topic. remove it there? also update entity info in Entity/MF/BASIS.

Set Up Entities

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

create

utilize pending trade rules

as eligible for pending trade activity

before you can process pending transactions for those entities. For each entity

eligible for pending transaction activity

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

(tag 3679)

to Yes.

This field is available in the Create/Edit Entity panel, the Create Master Fund panel, and the Edit Master Fund/Sector panel. When the system receives a transaction from an upstream system for an entity that is eligible for pending transaction activity, and the transaction meets the pending trade rule criteria, the system identifies the transaction as a pending transaction. Otherwise, when

 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

that is not eligible for pending transaction activity, and the transaction meets the pending trade rule criteria, the system does not identify the transaction as a pending transaction.
Info

The Pending Trade Eligible Indicator field at the entity level allows the system to apply pending trade rules to an entity to classify the transaction as pending. However, it does not indicate whether the entity is eligible for use with transactions already classified as pending transactions. If you identify transactions as pending, and do not require the system to apply a pending trade rule to the transaction, the system can track 

You do not need to set the Pending Trade Eligible Indicator field to Yes in order to process pending transactions for an entity in cases where the system receives a transaction from an upstream system for an entity, and that transaction is already identified as eligible for pending transaction processing. The the Pending Trade Eligible Indicator field enables the use of pending trade rules for an entity. When

, 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

and

. The system does not consider the Pending Trade Eligible Indicator field value. The system routes the transaction to the

PENDING_TRADES table in the TRADES database

Pending Trades table for further evaluation.

If the incoming transaction's Pending Trade Status field (tag 3720) has a value equal to a custom status code value, the system applies the custom status. Otherwise, if no status is provided on the incoming transaction, the system sets the status to Pending.

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

Set Up Threshold Logic in BOOT.INI

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.

If a limit is exceeded, the transaction fails and the system can

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.

In addition, the database stored procedure and Batch Release Pending Trades panel allow a delay in a batch release. An interval based in seconds can be submitted to the procedure that the system compares to the most recent transaction's time stamp in the Pending Trades table to determine if that most recent transaction was inserted within the time interval. If it was, the procedure waits to the next execution to release the batch. For example, if the interval is ten seconds and the most recent transaction was inserted five seconds prior, then nothing is done.

The

reason for this is that if many transactions are being loaded into the Pending Trades table, it is best to gather the set and order them to be more optimal when processing in STAR.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 

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

LoopbackMaxCountThresholdEnabled

=

1