Home > Technical > INI Files > DYNAMIC.INI Settings

DYNAMIC.INI Settings

The DYNAMIC.INI is the main configuration file used by the system. A basic DYNAMIC.INI is generally not very big. However, there are a number of options that can be added to DYNAMIC.INI.

DRS

DRSBackup

ClockInOut

DynaPOS

DRSServers

DRSAltComms1

Security

Directories

DRSServerPoolSizes

StatisticsService

Miscellaneous

MLS

Quick Item

MMPlus

[DRS]

This section is set by all clients that want to communicate with an MCS.

ComputerID={AD202158-C836-4D47-951D-BD384A25ED94}

This is a unique number assigned by the InitDRSSystem.exe. It should be unique for every computer as its recorded with some audit information in the database.

In reality many people just copy the INI file and the same ComputerID is used on all computers. This does not particularly matter but you do lose some auditing information.

ComputerLocation=ALL

 

ConnectionMethod=3

The connection method used to connect to the MCS. These can be set initially by InitDRSSystem.exe. However, if the system is set up to use Communications Configurations, POS and MainMenu will copy the equivalent setting from the Comms Config to this value when they start up.

1=TCP Stateless
2=HTTP Stateless
3=TCP Stateful
4=TCP Mixed

UseLocalServer=T

 

AddressBasic=10.1.1.4

AddressData=10.1.1.4

AddressBusiness=10.1.1.4

AddressReport=10.1.1.4

AddressPOS=10.1.1.4

The address of the MCS that each of the five services needs to connect to. You can have different addresses for each service. You could have POS going to one MCS and the other services going to a different MCS.

These can be set initially by InitDRSSystem.exe. However, if the system is set up to use Communications Configurations, POS and MainMenu will copy the equivalent setting from the Comms Config to this value when they start up.

PortBasic=8302

PortData=8312

PortBusiness=8322

PortReport=8332

PortPOS=8342

The port of the MCS that each of the five services needs to connect to. You can have different ports for each service. You could have POS going to one MCS and the other services going to a different MCS.

These can be set initially by InitDRSSystem.exe. However, if the system is set up to use Communications Configurations, POS and MainMenu will copy the equivalent setting from the Comms Config to this value when they start up.

PortLocalServer=8351

The port number that is used by MerchantLocalServer. POS will connect to this port number. It doesn't need an actual address because POS will 'discover' the address automatically. If this setting is not entered, the system will simply default to 8351. It must be manually entered if you do want to set it.

Timeout=1000

The timeout value (in milliseconds) for connections to MCS.

This is only set if the system is using Communication Configurations (although it could be set up manually). POS and MainMenu will copy the equivalent setting from the Comms Config to this value when they start up.

TimeoutLocal=1000

Similar to Timeout above, it is used when connecting to MerchantLocalServer. If this setting is not entered, the system will simply default to 1000. It must be manually entered if you do want to set it.

CompressBasic=T

CompressData=T

CompressBusiness=T

CompressReCompress=F

CompressPOS=F

These flags determine whether the client programs will compress their data when they send it to the MCS. You can control compression for each of the five services.

These are only set if the system is using Communication Configurations (although they could be set up manually). POS and MainMenu will copy the equivalent setting from the Comms Config to this value when they start up.

TimeSync

When set to F, the Back Office and DynaPOS will not synchronise their system time with the time on the server. Used for users with profiles that have insufficient priviledge to change the system Date/Time settings.

[DRSBackup]

PortBasic=8302

PortData=8312

PortBusiness=8322

PortPOS=8342

PortReport=8332

At one stage we had problems on some POS with the port numbers in the INI file getting corrupted. When POS starts up it takes a copy of the port settings from above and writes it to this section as a back up.

ServerName=MYCOMP

This setting can be used in conjunction with running exes. When an option is selected from the menu, the system will ask MCS what exe to run. MCS will return the path of the exe. The exe path can contain a keyword < SERVERNAME>. The system will replace the keyword with this INI file setting. So you could have an exe path of:

 \\< SERVERNAME>\ drapps\DataEntryItems.exe ITEM

which would be translated to: \\ MYCOMP\drsapps\DataEntryItems.exe ITEM

The setting is made manually.

ConfigVersion=060426092643628

This records the last time a configuration update was received. It is compared to the servers' configuration details to determine if new configuration files are available.

ChunkSize=16384

When a file is downloaded by POS, for example an upgraded executable or new POS data, the file will be downloaded in chunks. This setting controls the chunksize (in bytes).

[ClockInOut]

These settings allow users without access to the POS (that is without the use of a swipe card or dallas key) to clock in and out from a Back Office PC.

DefaultTillID=2

The till ID that will be used when entering the clock in records into the tables.

TradeCode=ALL

The Trade Code for the location.

[DynaPOS]

This section contains settings used by DynaPOSTouch.

Version0=5.19.0.36

The version of DynaPOSTouch currently running. DynaPOSTouch uses this when it starts up to determine if its got a new version and needs to reload the data. These is maintained by DynaPOSTouch.

PreprintSaleIDFirst=

PreprintSaleIDLast=

PreprintExpiry=30/12/1899

PreprintSaleID=00000043

These settings are used to generate the preprint tax numbers for Taiwan receipts. Originally the numbers were added in DynaPOSTouch and written to here for storage. The system now uses database tables to store the list of available numbers. In order not to break the way DynaPOSTouch was working, DynaPOSTouch simply reads the required record from the database table and updates these fields.

These are maintained by DynaPOSTouch.

ReceiptImage=\drsapps\bmps\logo.bmp

This is the name of the file that contains the image that needs to be printed on a receipt. It needs to be added manually.

EFTPOS1=

This is written out by DynaPOSTouch when using an Ingenico EFTPOS device. It will write the date/time out just before it asks for the EFTPOS transaction to be done and it will be cleared just after the EFTPOS transaction completes. This is used as an audit feature if the POS crashes while doing an EFTPOS transaction and is a requirement of the Ingenico EFTPOS.

SaleID1=57

The current receipt number for the DynaPOSTouch. Note the 1 after SaleID. This is the till number. So if you run multiple tills, each till keeps track of its own receipt number. This is maintained by DynaPOSTouch.

TillID=1,2,3

The till number for the DynaPOSTouch that runs on this computer. This will generally be a single number, but if you have alternative tills set up (as for Stena), this can be a comma-delimited list of numbers.

These numbers should be manually added.

Status1=TRADE

The current status of DynaPOSTouch. This is equivalent to the status codes you would see in Till Control. Note the 1 after Status. This is the till number. So if you run multiple tills, each till keeps track of its own status.

This is maintained by DynaPOSTouch.

CurrTillID=1

The current till number being used.

StartupWait

This is a delay time you can use to control how fast DynaPOSTouch starts up. It can be used if you have lots of programs starting up. This is in milliseconds. It is set up manually.

WaitRun=T

If this option is manually added, it tells DynaPOSTouch to wait when a program is run from the POS menu. Any function run from MERCHANTPOS.EXE is automatically run as if WaitRun=T. So this setting will only effect programs run from other exes.

LogKeyboard=T

If this option is manually added, DynaPOSTouch will create a file called DynaPOSTouchKeys.log which will contain the keystrokes the user has pressed during the operation of the POS.

FACTS=T

FACTS is the name of a golf reservation system. Setting this to T indicates that we need to interface to FACTS. This needs to be manually entered.

ysnSendFiscalItems=T

 

ShiftCode3=1

 

ShiftName3=Breakfast

 

KBCode3=0

 

ItemMenu3=

 

DefaultFastkey3=2

 

DefaultFastKeyTakeaway3=3

 

POSImages=0

 

AskTradeDate3=F

 

Float3=0

 

Return=225

To show Returns in red in the POS Search screen for Return Sales transaction.

[DRSServers]

This section is only required in INI files on which the services (MCS, TillIncoming, StatisticsUpdater, and so on) and end of day processes run.

Database=MSSQL1

This setting indicates the type of database being used. MSSQL1 = SQL Server and ODAC= Oracle. It is set when you run InitDRSDBSystem.exe.

MSSQL1=SDAC? Database=retdata;

UserID=xxx; Password=xx; Server=server

These are the connection strings. You will generally only have one (either MSSQL1 or ODAC). In this example, the connection string can be read because of the Encrypt setting (see below). If encryption was on, this would just appear as a string of unreadable characters.

They are set when you run InitDRSDBSystem.exe.

MaxConnectionsBasic=40

MaxConnectionsItems=40

MaxConnectionsBusiness=40

MaxConnectionsPOS=40

MaxConnectionsReports=40

Every time a client calls a function on MCS and MCS needs to access the database, it requires a database connection. Opening a database connection and then closing it when finished, adds time to every database access. MCS maintains a pool of database connections for each section. When it needs to access the database, it gets a connection from the pool. These settings are the maximum number of database connections for each of the five services.

See Merchant Central Server Settings for further details.

HTTPThreadsBasic=50

HTTPThreadsData=50

HTTPThreadsBusiness=50

HTTPThreadsReport=50

HTTPThreadsPOS=50

TCPThreadsBasic=50

TCPThreadsData=50

TCPThreadsBusiness=50

TCPThreadsReport=50

TCPThreadsPOS=50

The HTTP Stateless and TCP Stateless communication methods work by using a pool of threads (one thread is one client connection). A separate pool is kept for each section. The default pool size is 50. If a connection cannot be obtained the client will get a network error (normally 10061).

Note: The TCP Stateful method is handled differently and does not use a pool of threads.

See Merchant Central Server Settings for further details.

HTTPPortBasic=8310

HTTPPortData=0

HTTPPortBusiness=0

HTTPPortReport=0

HTTPPortPOS=8074

Used to set port numbers for different services within MCS.

 

See Merchant Central Server Settings for further details.

Name=Main

The name of the services that use this ini file. This is used when configuring multiple services to run on one computer.

See Configuring Services for more details.

ReportThreads=10

Reports are requested by a client but are actually generated by MCS. MCS maintains a pool of threads specifically for processing reports. Each thread is able to generate one report. Reports are quite intensive to generate so you will want to limit the number of threads generated at any point in time. By default, 10 reports can be generated at one time. If you are running multiple MCS on one database, you may want to set this value to zero on some of the MCS so they don't generate any reports at all.

See Merchant Central Server Settings for further details.

LockTimeout=1000

The maximum amount of time (in milliseconds) that the system will wait for a lock in SQL Server to be released. If you want it to wait indefinitely, set it to -1. If you want it to fail immediately, set it to 0.

DebugServer=F

This setting can be used to turn on some debug features in POS. It was used when trying to track down the hanging issues we were having in MCS. It should only be manually added when directed. The setting should not be in the INI file otherwise.

[DRSAltComms1]

ConnectionMethod=3

Timeout=1000

AddressBasic=10.1.1.4

AddressData=10.1.1.4

AddressBusiness=10.1.1.4

AddressReport=10.1.1.4

AddressPOS=10.1.1.4

PortBasic=8402

PortData=8412

PortBusiness=8422

PortReport=8432

PortPOS=8442

CompressBasic=T

CompressData=T

CompressBusiness=T

CompressReCompress=T

CompressPOS=T

If you have set the system up to use Communication Configurations, this section records the details of the first backup connection. If you set up a second backup connection, it would be in a section called [DRSAltComms2]

The settings here are the same as the equivalent settings above in the [DRS] section above.

[Security]

This section records the details of who is currently logged in.

UseWinLogon

T or F.

UserCode=

The user currently logged in to MainMenu. This is maintained by MainMenu and will be cleared when the user logs off.

UserSecurityGroups=1,2,3

The security groups in which the currently logged in user belongs. This is maintained by MainMenu and will be cleared when the user logs off.

UserDepts=

The departments which the currently logged in user is allowed to see (based on the user's management area). This is maintained by MainMenu and will be cleared when the user logs off.

UserClasses=

The classifications which the currently logged in user is allowed to see (based on the user's management area). This is maintained by MainMenu and will be cleared when the user logs off.

UserSecurityProfileCode=0

This is written by MainMenu. It was a setting used in very early versions but not used any more.

TradeCode=ALL

The location code to which the user was assigned. This is maintained by MainMenu and will be cleared when the user logs off.

ReportTradeCode=ALL

The location code for which reports will be written. This is maintained by MainMenu and will be cleared when the user logs off.

ReportUserCode=

This is written whenever a report program is run and a report is requested. When the Preview button is pressed , the report is generated and MerchantReportManager started. MRM uses this setting to determine the user. It is required because of the way POS fires off a report and can log off automatically (which means when MRM runs there is no user and you would get errors). It is cleared when the report program is shutdown (after MRM starts up).

POSUserCode=ADMINISTRATOR

POSUserName=ADMINISTRATOR

POS UserNum=

The user code and name of the user currently logged in to POS. When the POS user logs out, these values are cleared.

[Directories]

This section contains special directories

LogFiles=c:\ drsapps\logfiles

The directory in which log files generated by the services should be placed. If this is not set the files will be placed in the windows temp directory. You need to manually add this setting to the INI file.

Bitmaps=c:\drsapps\bmps

This is used by POS to determine the location of any bitmap files. It is only used by POS and it is only required if you want to place the bitmaps in a non-default directory. The default directory is the bmps subdirectory in the directory from where the app is run. So if apps are run from \drsapps, the default directory is \drsapps\bmps.

Reports=c:\drsapps\reports

 

ImportDir=\drsapps\import

The system is able to import sales from external systems. This was used in the past to interface with a golf system. The reservation was taken on the golf system and it would generate a sale file into this directory. It would then move focus to DynaPOSTouch. DynaPOSTouch would import the sales file and add the items to the transaction. The user could then pay the transaction. This must be manually entered but is only required if you are using this particular feature.

ImportBulkSales=\drsapps\import

The system is able to import sales from external systems. This was used in the past to interface with a golf system. The golf system would generate a series of files, each file being a basic transaction. DynaPOSTouch can import these files (this is the Import Member Sales option on the Supervisor menu). Each file is loaded as a transaction and tendered to the member's account. A summary of the processed transactions is printed to the receipt printer. This must be manually entered but is only required if you are using this particular feature.

[DRSServerPoolSizes]

MerchantCentralServer is divided into many services. Each service performs a specific set of operations. MCS can invoke multiple instances of each service in order to meet the demand of client requests. This section contains an entry for each service indicating the maximum number of instances that can be used. If you are getting messages about poolsizes, these numbers can be increased.

CacheService=10

The maximum number of instances of the cache service. This line has been left as an example, to see all the available options see the document.

See Merchant Central Server Settings for further details.

[StatisticsService]

 

MaxRecords = 100000

Used to limit the number of unprocessed records updated at a time in each loop of the stats service (for each thread). Default of 0 will leave the loop unchanged - updating all unprocessed records it finds.

[Miscellaneous]

This section is for miscellaneous settings.

DebugLog=T

If this is set to T, the programs will generate a log file when they run. The log file will be placed in the directory specified by LogFiles above. The amount of information logged is dependent on the program. The developers will often use this to try to track down a specific problem. Enough debug is added to work through the problem at head. Some programs log almost nothing, others log lots of information. You need to be careful with this setting. The name of log file is based on the application name. If you try to run two functions in the same exe, the second exe may generate an IO Error 32 indicating the file is locked.

If you set the option to S, the system will generate a log text file and show the log to the screen.

A value of F indicates no logging is occurring and is equivalent to removing the setting from the INI file.

This setting needs to be manually added when it is required.

LogoBmp=c:\ drsapps\bmps\logo.bmp

The name of the file to include as the logo on an A4 receipt in POS. At the moment it needs to be set manually. Loading this image in this way is a throwback to v4 and needs to be improved.

Encrypt=F

By default, this flag will not exist in the INI file. If the setting is not in the INI file, the system assumes Encrypt=T and turns encryption on. You would generally add the setting only if you want to turn the encryption off.

You need to be consistent about adding this flag to all INI files that use the system otherwise you can get a mismatch between computers expecting encryption and others not expecting encryption.

The data which is encrypted is the database connection string (as above) and the password for users (stored in the database). So if you want to turn encryption off, the settings need to be added into the system before you do anything on the system.

LanguageExt=ENA

The three character code identifying the file extension to use when translating language. Any entry here will override the locale setting.

The extension for a specific Windows locale setting is identified in this web page: http://www.loc.gov/standards/iso639-2/php/code_list.php

If a language file matching your locale setting is found it will be used - if you want to restore the defaults you need to delete the language files.

ClearCache=F

When MainMenu starts up it will use the existing cache files for drop down combo boxes. If this flag is T, the cache will be cleared each time MainMenu is started. This is less efficient but useful in cases where a user may connect to multiple systems from the one computer.

MultipleServices=F

This setting allows a service to be run over multiple computers to the one database. See Configuring Services for more details.

EncryptComms=F

If this flag is set to T, the data sent between clients and services will be encrypted.

KeepStats=T

 

LogExcept=T

 

[MLS]

 

TillID=99

The till number that should be used when Merchant Local Server starts up. Only required in the DYNAMIC.INI of the computer on which Merchant Local Server is running.

TillCode=TILL99

The till code that should be used when Merchant Local Server starts up. You need this and TillID. Only required in the DYNAMIC.INI of the computer on which Merchant Local Server is running.

Address=127.0.0.1

If this entry exists, POS will connect to the Merchant Local Server at this address instead of using discovery. This would be in the DYNAMIC.INI of each POS.

Autostartup=

If this is not F (which is equivalent to not having the setting in the INI file at all) then when MLS starts up, it will add a link to itself to the desktop, start menu and startup group so that the MLS will be started automatically. If you are shipping pre-configured computers and you don't want MLS to start automatically and add those links, set Autostartup=F.

[Quick Item]

 

IPN=

 

Family

 

[MMPlus]

 

DisplayImageTimeout=5

Version 5 of Multi Media Plus (MMPlus) supports images of the purchased items being displayed. This option specifies the length of time (in seconds) that an image is displayed for. This example sets the timeout to 5 seconds.

Converted from CHM to HTML with chm2web Pro 2.85 (unicode)