DependQ Documentation and Downloads

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Single Sided Subtraction ======

link to [[clients:downloads:msmqconnector]]

===== Overview =====
This operation is used to decrease the balance in an instrument for a particular account.

It can be accessed as follows:
  * Select Subtraction from the Insert section of the Transactions menu
==== Related Topics ====
You may also want to refer to:
  * [[OffMarketTransactions]]
  * [[SingleSidedAddition]]
  * [[TwinSidedTransfer]]
  * [[InstrumentSelector]]
  * [[AccountSelector]]
  * [[AccountConfirmation]]
==== Configuration ====
The following configuration options affect the behaviour of this operation:
  * [[ConfigTransactionType]] - the list of transaction types configured for subtractions
===== Operation =====
The screen below is used for entering the parameters for a new subtraction:

{{dependsubtraction.png|Subtraction Insert screen}}
===== Parameters =====
The parameters to be entered for a subtraction are shown in the table below; **mandatory fields** are shown in bold text on the screen.

Use the ~~test~~ directive
☛P_SINGLESIDED_SUBSTRACTION
^Parameter ^Description ^
|ISIN Code\\ PARAM_SUB_ISIN_CODE |Select the instrument to be updated from the pulldown list provided, enter its ISIN Code, or press the [...] button at the right of the field to invoke an instrument search screen\\  The status of the selected instrument must allow transaction entry |
|Debit Account\\ PARAM_SUB_AC_REF |Enter the reference of the account to be updated or press the [...] button at the right of the field to invoke an account search screen\\  The status of the selected account must allow transaction entry |
|Broker Code\\ PARAM_SUB_BROKER |Select the broker that handled the transaction from the pulldown list provided |
|Bargain Reference\\ PARAM_SUB_BARG |The broker's bargain reference for the transaction |
|Quantity\\ PARAM_SUB_QTY |The number of securities to be subtracted\\ This can be up to 8 decimal places depending on the selected instrument's configuration |
|Certificate List\\ PARAM_SUB_CERTS |The list of certificate numbers being used to support the subtraction\\ Enter the list of numbers separated by commas or press the [...] button at the right of the field to invoke a certificate selector screen |
|Balance Amount\\ PARAM_SUB_BAL |The number of securities to be accounted for on a balance certificate\\ Leave this empty to let the [[ApplicationServer]] calculate it automatically |
|Record Date\\ PARAM_SUB_DATE |The record date of the transaction\\ Leave this empty to allow the [[ApplicationServer]] to use the current date and time |
|Transaction Reference\\ PARAM_SUB_REF |The reference code to be applied to the transaction\\ Leave this empty to allow the [[ApplicationServer]] to generate a reference automatically |
|Remarks\\ PARAM_SUB_REM |Comments or remarks in respect of the subtraction transaction |
|Transaction Type\\ PARAM_SUB_TYPE |Select the transaction type from the pulldown list provided |
|Unit Price\\ PARAM_SUB_PRICE |The price of the subtraction transaction |
|Consideration\\ PARAM_SUB_CONSID |The consideration of the subtraction transaction\\ Usually calculated as Quantity*Price |
|Currency Code\\ PARAM_SUB_CCY |Select the currency of the price and consideration from the pulldown list provided |
===== Update =====
Key the information into the fields provided and press the Save button.  You will be required to confirm the selection of instrument and account in the standard [[AccountConfirmation]] screen.

The following should happen if there are no errors in the information you entered:
  * The [[ApplicationServer]] will create a new subtraction transaction with the information you entered on the screen
  * The balance of the account in the selected instrument will be decreased by the quantity entered
  * The total number of securities in issue for the selected instrument will be decreased by the quantity entered
  * If the transaction was physical, the list of certificates supplied will be cancelled and if necessary, a balance certificate will be created to hold any residual balance; if the instrumemt is physical, but the account balance is dematerialised, the balance of securities will be subtracted from the open item for that account and instrument

Please fill all the letters into the box to prove you're human. Please keep this field empty:

Edit summary