This is an old revision of the document!
Table of Contents
Single Sided Subtraction
link to 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:
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:
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