afstrade.ini file

The afstrade.ini file contains initialization information for all AFS applications including afs:TRADE, Lookups, and all reports. For example, it provides the database driver used (e.g. SYBASE, ORACLE, etc.), the location and name of the database and the directory of the overnight log files. Below is an example of the file, including all supported entries. The file must be placed in the same directory as AfsTrade.exe.

[AFS]
; SMTP mail host to which mail is sent
;SMTPMailHost=mail.mysite.com
; Address to which support email messages are sent
;SMTPToAddress=support@mysite.com
;SMTPAuthenticateUser - User name used for SMTP Authentication. If set,
;SMTP will authenticate.
;SMTPAuthenticateUser=myuser
;SMTPAuthenticatePass - Password for user Authentication.
;SMTPAuthenticatePass=mypass

[AFSTrade]
; Prepend the FormTitlePrefix text to all form titles.
; Not required.
;FormTitlePrefix=[QA Version]
; Define the maximum number of characters used to the left
; of the decimal place when displaying some price values (e.g.
; the price/cost in the position scan panel).  Default value
; is 10. 
; Not required.
;PriceCushion=12
; Set the directory where AFS logs are written
LogFileDirectory=f:\AFS\logs
; Set SlowConnection=1 if you are running afs:TRADE through
; a slow network connection, e.g. a dialup modem.  In this
; case, Finders are set, by default, not to auto find, and
; lookup tables are only fetched the first time they are
; used (as opposed to all being loaded when the application
; is first started).
;SlowConnection=1
; Set MinEventPollInterval to the minimum number of seconds afs:TRADE
; will wait before polling for events.  The lower this number, the
; lower users will be able to set their default polling interval.
MinEventPollInterval=5
; Set MaxEventPollInterval to the maximum number of seconds afs:TRADE
; will wait before polling for events.  The higher this number, the
; higher users will be able to set their default polling interval.
; Events are used to update real time forms like Position Scans and
; Ticket Blotters.  Events also notify users of shut downs and are
; responsible for performing automatic shutdowns (so if this number
; is too large, afs:TRADE may not be shut down as the result of 
; a Shut Down event).
MaxEventPollInterval=100
; HistoryDir points to the directory, on the database server, where
; the database dump files are placed.
HistoryDir='C:\temp'
; Set DoAutoSearch=1 if you want AutoSearch on Finders to be set on.
; Set DoAutoSearch=0 if you do not want AutoSearch on Finders to be set 
; on.  AutoSearch may still be disabled on some forms if the amount of 
; data they search is large
DoAutoSearch=1
; Set LogExceptions=1 if you want exceptions logged to a file, 
; AfsException.log.  Exceptions logged are those that reach the top level
; of the runtime.  Default = 0, no logging.
;LogExceptions=1
; Set ExceptionLogDir to the directory where exceptions are logged.  
; Default is c:\temp.
;ExceptionLogDir=c:\temp
; Set UseRowLocking=1 to indicate the database server uses row locking.
UseRowLocking=1
; Set DoIncrementalSearch=1 if finders should perform a search, while the 
; user is typing.  Incremental searching may still be disabled on some forms
; if the amount of data they search is large.  Incremental searching
; is never enabled on a date field since partial dates (e.g. '4/') are 
; typically invalid in a database search.  If this is turned off, searching
; is performed when a user tabs out of a field.  Default=0
;DoIncrementalSearch=1
; Set IncrementalSearchDelay to the number of milliseconds to wait before
; performing an incremental search.  For example, if this is set to its
; default value of 333 (on third of a second), finders will wait a third
; if a second, after a user types a character in a finder criteria field,
; before performing a search on the database.  If the user types in 
; another character before the third of a second, the search is not 
; performed and is again delayed by another third of a second.  
; Default=333.  Only used if DoIncrementalSearch=1
;IncrementalSearchDelay=333
; Set AutomaticallyIncrementCode to 1 if you want to allow afs:TRADE to 
; automatically maintain codes on some items, e.g. Brokers.  Set it to 0,
; the default value, to disable this feature.
;AutomaticallyIncrementCode=0
; If PositionCreateDateUsesSettleQty=1, when a position's settle quantity
; goes from 0 to non-0, set the creation_date = settlement date, 
; otherwise, use and set based on trade_date.
;PositionCreateDateUsesSettleQty=0
; If PropogateCommentsToPositions=1 then when a ticket is saved, if
; its comment is not blank, set the position's comment to this comment
;PropogateCommentsToPositions=0
; Set RetainSoldOutPositions to 1 if you want afstrade to keep positions
; whose trade date par and settlement date par = 0. (>= V2001.09.07)
; 1 = never delete sold out positions
; 0 = always delete sold out positions
; BUT if RetainSoldOutPositions = 0 AND POSITION_KEEP_DAYS is greater than 0, 
; then sold out positions will be retained for the number of days 
; specified by POSITION_KEEP_DAYS (see Nightly section).
;RetainSoldOutPositions=0
; Set RequiredTableList to a comma separated list of database table names, 
; used by the Mandatory Fields Form
;RequiredTableList=product,account
; ExtendedGlobalParentLimits=1 will include guarantors, LOCs, and liquidity 
; providers in the global parent calculation. Default (value = 0) is parent
; code(s) only.
;ExtendedGlobalParentLimits=0
; ForceEffectiveMaturityDate, if set to 1, all date calculations in the 
; limit engine that reference a maturity date will use the effective 
; maturity date. Otherwise, the stated maturity date will be used 
;ForceEffectiveMaturityDate=0

; You can localize afstrade by creating substitutions for various
; labels with afstrade.  The following section defines substitutions
; for common labels in afstrade.  For example, it says to substitute
; "Account" for "Fund".  Not all labels are currently set to be 
; localized.  If you find a label that needs to be localized, but is
; not, notify AFS. (Localization)
;[LabelNames]
;Fund=Account
;Broker=BKR/Sub
;BKR=BKR/Sub
;CUSIP=Product

[Database]
; Define the database driver used
; REQUIRED
DriverName=SYBASE
; Define the prefix the database uses for tables.
; afs:TRADE sets this to 'dbo.' by default.  This is
; valid for databases like Sybase and MSSQL.  You might
; change this to 'DBA.' for SQLAnywhere.  Typically you
; do NOT need to set this
TablePrefix='dbo.'

[DBParams]
; items in this section define the PARAMS that are set on the 
; database
; REQUIRED - The name of the database server you created with 
; your database software.
SERVER NAME=pine
; REQUIRED - The name of the afstrade database you created
; on your database server.
DATABASE NAME=afstrade

[TicketMaster]
; Define the value used for Broker on transferred positions.  If no value
; is provided, the broker is left blank.
; Not required.
TransferBroker=LOAD
; Define the value used for Custodian on transferred positions.  If no value
; is provided, the custodian is left blank.
; Not required.
TransferCustodian=LOAD
; Define the value used for Broker on cross trades.  The value for this
; field must be a valid ID on the Other Party/Broker form.
; Required if you perform cross trades.
;CrossTradeBroker=CROSS
; Define the value used for Broker on customer principal trades.  The value 
; for this field must be a valid ID on the Other Party/Broker form.
; Required if you perform customer principal trades.
;CustomerPrincipalBroker=CUSTPRIN

;[TicketQueue] ; Old section name used prior to version 2005.12.31
; Note that new section name must match name of executable.
[afsTicketQueue] 
;[afsQueueService] ; Use this section name if running the service
; Set the default desk assigned to a ticket when no desk is passed in.
;DEFAULT_DESK=D
; Set the default account assigned to a ticket when no account is passed in.
;DEFAULT_ACCOUNT=AVG
; Set the USER NAME to be used to run the afsTicketQueue process.  This 
; database ID is assumed to be used to run only the afsTicketQueue.
; REQUIRED
USER NAME=afsqueue
; Set the PASSWORD if you do not want to enter it every time
;[PASSWORD]=mypass
; Set Service_Port = port number on which Queue listens for requests from
; the QueueViewer.  This value should be unique among AFS applications
SERVICE_PORT=5039
; Set ConnectionDropAutoRestart=1 when queue should try to restart when
; an error is encountered (e.g. Nightly not yet run, database connection
; dropped, etc)
ConnectionDropAutoRestart=1
; Set RepeatLoginSeconds = number of seconds to wait after an error
; before reconnecting to the database
RepeatLoginSeconds=15
; Set START_TIME = the time the service should connect to the database and 
; run
START_TIME=607 ; 6:07 am
; Set END_TIME = the time the service should disconnect from the database 
; and stop
END_TIME=2027  ; 8:27 pm
; Set addressed to/from for error messages to be emailed
SMTPToAddress=support@mysite.com
SMTPFromAddress=support@mysite.com

; The following section is referenced by many tools including 
; the afsTicketQueue and afsTicketImporter
[TradeModule]
; Set AutoCreateBroker=1 so that, if a ticket is processed, and the
; Broker is not found in the database, the broker is automatically
; created.
;AutoCreateBroker=1
; Set AutoCreateProduct=1 so that, if a ticket is processed, and the
; Product is not found in the database, the product is automatically
; created.
;AutoCreateProduct=1
; Set AutoCreateParent=1 so that, if a ticket is processed, and the
; Parent/Customer is not found in the database, the parent/customer
; is automatically created.
AutoCreateParent=1
; Set AutoCreateParentEmail to send an email message whenever a 
; parent is automatically created
;AutoCreateParentEmail=1

[Nightly]
; Define the location of the log output by the nightly 
; program. Default s c:\temp
;LogDirectory=C:\temp
; Set RunProductReport=1 to create a separate log file for 
; the product information (put and variable rate resets, coupon payments)
;RunProductReport=0
; Set PrintDebugData=1 to print additional information to the nightly log files.
; This is helpful in pinpointing the problem in the event of a nightly crash.
; If PrintDebugData=1, the following information will be printed to the screen
; and to the log file.
; Nightly Log File--The Average Maturity Calculation (including account, CUSIP, 
; effective days to maturity, & adjusted basis) will be printed during the Position Reset 
; section of the nightly program.
; Product Log File (if RunProductReport=1, else prints to nightly log file)--The 
; CUSIP number will be printed BEFORE the CUSIP is processed during the Product Reset 
; section of the nightly program.  (This section resets puts and variable rate information.)
; This will help to determine which CUSIP has bogus data and caused the nightly program to crash.
;PrintDebugData=0
; Set POSITION_KEEP_DAYS to the number of days after settlement a position should
; remain after it has been sold out.  Default value = 10. Nightly V2000.01.31.
;POSITION_KEEP_DAYS=10
; Set PRICE_TO_DEFAULT=1 if the Nightly should price your positions using
; a settle date = the product/cusip's default settlement date (as opposed to
; using today).  Default = 0. (>= V2001.02.08)
;PRICE_TO_DEFAULT=0 
; USE_DE_MINIMIS---used in position reset portion of nightly program
;    set to 1 to use deminimis in after-tax yield calculation.
; default 'use deminimis' value
;USE_DE_MINIMIS=0
; TCKQUEUE_KEEP_DAYS - indicates number of tckqueue records to keep
; A value of 0 means keep all. (>= V2002.11.8.0)
;TCKQUEUE_KEEP_DAYS=7
; FIXEVENT_KEEP_DAYS - indicates number of fixevent records to keep
; A value of 0 means keep all. (>= V2002.11.8.0)
;FIXEVENT_KEEP_DAYS=7
; AFSEVENT_KEEP_DAYS - indicates number of afsevent records to keep
; A value of 0 means keep all. (>= V2002.11.8.0)
;AFSEVENT_KEEP_DAYS=0
;ShouldMaturePositions - indicates whether or not to automatically
; mature positions, setting their quantity to zero on maturity.  If
; you do not want Nightly to automatically mature positions, set this
; value to 0. Default = 1.
;ShouldMaturePositions=1
; BACKUP_SERVER_DIRECTORY and BACKUP_LOCAL_DIRECTORY indicate where the
; database will be dumped.  BACKUP_SERVER_DIRECTORY is the directory name
; (can be drive based, e.g. c:\temp, or UNC, e.g. \\RemoteMachine\c\temp)
; as seen by the database server.  BACKUP_LOCAL_DIRECTORY is the directory
; name (must be drive based) as seen by the machine running Nightly.exe.
;BACKUP_SERVER_DIRECTORY=\\RemoteMachine\c\Temp
;BACKUP_LOCAL_DIRECTORY=C:\Temp
; BACKUP_REMOTE_DIRECTORY is the directory where the dump file is copied. It
; is the directory name (must be drive based) as seen by the machine running
; Nightly.exe.
;BACKUP_REMOTE_DIRECTORY=F:\Temp
; BACKUP_COMPRESS_FILE - set to 1 if the backup file should be compressed.
;BACKUP_COMPRESS_FILE=0
; ForceProductData (default is False) that will force the overnight
; program always to use the maturity_date, issue_date, and coupon from the
; product table, rather than using the tckmast value as an override.
;ForceProductData=0

[Calculator]
; This section includes default values for the calculator form.  Some of these
; values are also used in the nightly program calculations.
; Default Tax Values for Calculator Form
FedIncTaxRate=39.6
CapGainsRate=20.0
; Default Volatility Values---calculated for 1 basis point
YieldVolatilityMultiplier=1
PriceVolatilityMultiplier=1
; Alternative Volatility values---calculated for 5 basis points and $1
;YieldVolatilityMultiplier=5
;PriceVolatilityMultiplier=3.2