So Tired !_! 逆水行舟, 不进则退!

Configuration at Startup

The client terminal can be launched with some predefined settings. For this purpose, the configuration file name will be passed to the client terminal as a parameter.

For example:

terminal.exe configstart.ini
  terminal.exe test1.txt
  terminal.exe "C:Program FilesMetaTrader 4configsettings25.ini"

If the full path to the file (Drive:SubDirectoryFileName) is not given, the file will be searched for in the client terminal directory. The configuration file contains lines of the following appearance:
[Parameter] = [Value]

Comments start with a semicolon ( and are not processed.

The configuration file parameters can be divided into several groups: common settings, proxy server settings (the "Server" tab in the terminal settings), FTP settings (the "Publisher" tab in the server settings), EA settings (the "Expert Advisors" tab in the server settings), the expert or script single-launch settings, settings of the Strategy Tester launch.

Common Settings
Profile - the subdirectory name in the /profiles directory. The charts will be opened in the client terminal according to the given profile. If this parameter is not specified, the current profile will be opened.

MarketWatch - file name (the symbolsets directory) that contains the symbol list to be shown in the Market Watch window. A file like this can be obtained using the window context menu command of the "Market Watch - Sets - Save As...".

Login - the number of the account to connect to at startup. If this parameter is not specified, the current login will be used.

Password - the password that allows entering the system. This parameter will be ignored if the client terminal stores personal data on the disk and the account to be connected is in the list.

Server - the name of the trade server to be connected to. The server name is the same as the name of the corresponding .srv file stored in the /config directory. This patameter will be ignored if the information about the account to be connected was stored on the disk.

AutoConfiguration - "true" or "false" depending on whether the autoconfiguration setting should be enabled or not. If this parameter is not specified, the value from the current server settings will be used.

DataServer - address of the data center. This record can be ignored if the server autoconfiguration s enabled. If this parameter is not specified, the value from the current server settings will be used.

EnableDDE - "true" or "false" depending on whether DDE server should be enabled or not. If this parameter is not specified, the value from the current server settings will be used.

EnableNews - "true" or "false" depending on whether receiving of news should be allowed or not. If this parameter is not specified, the value from the current server settings will be used.

Example:

  ; common settings
  Profile=test 3
  MarketWatch=set2.set
  Login=12345
  Password=xxxxxx
  Server=MetaQuotes-demo
  AutoConfiguration=false
  DataServer=192.168.0.1:443
  EnableDDE=true
  EnableNews=false

Proxy Server Settings

ProxyEnable - "true" or "false" depending on whether or not a proxy server should be used for connection to the trade server.

ProxyServer - proxy server address.

ProxyType - proxy server type.It can be "HTTP", "SOCKS4", or "SOCKS5".

ProxyLogin - login to be authorized on proxy server.

ProxyPassword - password to access to proxy server.

If any of the above parameters are not specified, the current settings of the client terminal are used (proxy settings in the "Server" tab of the client temrinal settings).

Example:

 ; proxy settings
  ProxyEnable=true
  ProxyServer=proxy.company.com:3128
  ProxyType=HTTP
  ProxyLogin=user45
  ProxyPassword=xxx

FTP Settings
FTPEnable - enable/disable publishing. The possible values are "true" or "false".

FTPPassiveMode - enable/disable the passive mode of data transfer. The possible values are "true" or "false".

FTPAccount - the number of the account the state of which to be sent to the FTP.

FTPServer - FTP server address.

FTPLogin - the login for authorization on the FTP server.

FTPPassword - the password to access to the FTP server.

FTPPath - the name of the FTP server directory in which the report is placed.

FTPPeriod - the periodicity, in minutes, of the reporting to the FTP server.

If any of the above-listed parameters are not specified, the current client terminal settings are used (the "Publisher" tab in the server settings).

Example:

; ftp settings
  FTPEnable=true
  FTPPassiveMode=false
  FTPAccount=12345
  FTPServer=ftp.company.com
  FTPLogin=admin
  FTPPassword=pAssWOrd123
  FTPPath=/inetpub
  FTPPeriod=10

EA Settings
ExpertsEnable - enable/disable experts.

ExpertsDllImport - enable/disable DLL imports.

ExpertsDllConfirm - enable/disable manual confirmation of DLL-functions calling.

ExpertsExpImport - enable/disable import of functions from external experts or MQL4 libraries.

ExpertsTrades - enable/disable the experts trading.

ExpertsTradesConfirm - enable/disable manual confirmation of the trade operation performed by the expert.

If any of the above-listed parameters is not specified, the current client terminal settings will be used (the "Expert Advisors" in the server settings).

Example:

 ; experts settings
  ExpertsEnable=true
  ExpertsDllImport=true
  ExpertsDllConfirm=true
  ExpertsExpImport=true
  ExpertsTrades=true
  ExpertsTradesConfirm=false

The Expert and/or Script Single-Launch Settings
Symbol - the symbol of the security the chart of which should be opened immediately after the terminal startup. After the client terminal has been closed, the information about this extra chart is not saved. At the terminal restart, without the configuraiton file, this chart will not be opened. If this parameter is not specified, no extra chart will be opened.

Period - the chart timeframe (M1, M5, M15, M30, H1, H4, D1, W1, MN). If this parameter is not specified, H1 is used.

Template - the name of the templatre file (the templates directory), which should be applied to the chart.

Expert - the name of the expert that should be launched after the client terminal has started. The expert is launched in the chart, which has been opened according to the data specified in Symbol and Period. If the Symbol parameter has not been not specified, no extra chart opens, and the expert will be launched in the first chart of the current profile. If there are no charts in the current profile, the expert will not be launched. If this parameter has not been specified, no expert is launched.

ExpertParameters - the name of the file containing the expert parameters (the expertspresets directory). This file can be created in the expert properties window by pressing of the "Inputs - Save" button. It is normally used to save the inputs other than the default ones. If this parameter has not been specified, the default inputs are used.

Script - the name of the script, which must be launched after the client terminal startup. The script is launched according to the same rules that are eligible for the expert (described above).

ScriptParameters - the name of the file containing the script parameters (the expertspresets directory). This file is made in the same way as that for the expert.

Example:

 ; open chart and run expert and/or script
  Symbol=EURUSD
  Period=H4
  Template=popular.tpl
  Expert=MACD Sample
  ExpertParameters=macd.set
  Script=period_converter
  ScriptParameters=

Settings of the Strategy Tester Launch
TestExpert - the name of the expert to be launched for testing. If this parameter has not been specified, no testing is launched.

TestExpertParameters - the name of the file containing parameters (the tester directory). The file can be created in the Properties window of the expert under test by clicking the "Inputs - Save" button. It is normally used to save parameters other than the default ones. Other parameters of the expert under test in the "Testing" and "Optimization" tabs (as well as in the "Inputs" tab if this parameter has not been specified) are filled up with the values automatically saved in the tester[the expert name].ini file after the latest test.

TestSymbol - the name of the symbol used for the expert testing. If this parameter has not been specified, the latest value used in the tester is used.

TestPeriod - the chart period (M1, M5, M15, M30, H1, H4, D1, W1, MN). If this parameter has not been specified, H1 is used.

TestModel - 0, 1, or 2, depending on the testing model (Every tick, Control points, Open prices only). If this parameter has not been specified, 0 is used (Every tick).

TestOptimization - enable/disable optimization. The values that can be taken are "true" or "false". If this parameter had not been specified, the "false" value is used.

TestDateEnable - enable/disable the "Use date" flag. The values that can be taken are "true" or "false". If this parameter had not been specified, the "false" value is used.

TestFromDate - the date, from which to start testing, appeared as YYYY.MM.DD. If this parameter has not been specified, this date is 1970.01.01.

TestToDate - the date, on which to finish testing, appeared as YYYY.MM.DD. If this parameter has not been specified, this date is 1970.01.01.

TestReport - the name of the test report file. The file will be created in the client terminal directory. A relative path can be specified, for example: testerMovingAverageReport". If the extension has not been specified in the file name, the ".htm" will be set automatically. If this parameter has not been specified, the test report will not be formed.

TestReplaceReport - enable/disable the repeated report file record. The values that can be taken are "true" or "false". If the "false" value is specified and a report file named in the same way exists already, the number in square brackets will be added to the file name. For example, "MovingAverageReport[1].htm". If this parameter had not been specified, the "false" value is used.

TestShutdownTerminal - enable/disable shutdown of the terminal after the testing has been finished. The values that can be taken are "true" or "false". If this parameter had not been specified, the "false" value is used. If the user has pressed the "Stop" button, the value of this parameter will be flushed to "false" since the control has been given to the user.

Example:

; start strategy tester
  TestExpert=Moving Average
  TestExpertParameters=ma0.set
  TestSymbol=EURUSD
  TestPeriod=H1
  TestModel=2
  TestOptimization=false
  TestDateEnable=true
  TestFromDate=1970.01.01
  TestToDate=2006.06.06
  TestReport=MovingAverageReport
  TestReplaceReport=false
  TestShutdownTerminal=true

struct HistoryHeader
{
  int               version;            // database version
  char              copyright[64];      // copyright info
  char              symbol[12];         // symbol name
  int               period;             // symbol timeframe
  int               digits;             // the amount of digits after decimal point in the symbol
  time_t            timesign;           // timesign of the database creation
  time_t            last_sync;          // the last synchronization time
  int               unused[13];         // to be used in future
};

#pragma pack(push,1)
//---- standard representation of the quote in the database
struct RateInfo
{
  time_t            ctm;                // current time in seconds
  double            open;
  double            low;
  double            high;
  double            close;
  double            vol;
};
#pragma pack(pop)

Export of Quotes

 Source data serving as a basis for the entire analytical work of the terminal user are those about security price changes. This information is provided by the brokerage company. Price data allow to draw symbol charts, research in financial markets, use various trading tactics, and make trade decisions. Quotes represent files with records in format of "SYMBOL, BID, ASK, DATE" (security symbol, bid price, ask price, date and time) and income in the terminal automatically as soon as connection to the server has been established.

 The terminal allows to export the current quotes to other programs in the real-time mode through "DDE" (Dynamic Data Exchange) protocol. This is a protocol of operational systems of MS Windows used for dynamic data exchange among various applications. Quotes are given through DDE only at incoming of new ticks (ADVISE mode), but not immediately on request (REQUEST mode) where the latest price is shown. N/A is shown on the first REQUEST, and after the new price has been income, quotes will appear.

 To activate the export of quotes from the terminal through DDE, one has to enable the "Enable DDE server" option in the terminal settings.

DDE request formats and their possible results by the example of "DDE-sample.xls" file:

  BID   request:    = MT4|BID!USDCHF         result:  1.5773  
   ASK   request:    = MT4|ASK!USDCHF         result:  1.5778  
   HIGH  request:    = MT4|HIGH!USDCHF        result:  1.5801  
   LOW   request:    = MT4|LOW!USDCHF         result:  1.5741  
   TIME  request:    = MT4|TIME!USDCHF        result:  21.05.02 9:52  
   QUOTE request:    = MT4|QUOTE!USDCHF       result:  21.05.02 9:52 1.5773 1.5778 1.5776

Attention: For data to be shown properly in MS Excel, one has to enable "Tools — Options... — Translation — Translation formula entry" menu option of MS Excel.


Global Variables
 
 Several experts can be launched in the client terminal at the same time. Sometimes, there is a need them to interchange with information. To provide possibility of prompt transfer of moderate amounts of information among experts, as well as organize conflict-free simultaneous working of several experts, there are global variables in the terminal. Unlike variables claimed at a global level in the expert source code and available only within the corresponding module, global variables exsist independently on experts. Their values are saved between terminal launches, unlike those of variables claimed at a global level (they are set at every expert launch and lost at expert remove). Global variables are available within four weeks since their last call from experts or manual modifying.
 
 There is a special window in terminal that manages global variables. It can be opened by execution of the "Tools — Global Variables" menu command or by pressing of F3. All global variables, their values and times of their last calls are listed in a table in this window. Using buttons located in the right part of the window, one can add a new global variable or delete an existing one. To change the name or value of a global variable, one has to double-click with the left mouse button on the corresponding cell of the table. The last call time will be changed automatically for this variable. 


Contract Specification
 
 This message window allows to view securities contract specifications. The main parameters are grouped in table with following fields:
 
 Spread — difference between Bid and Ask prices in points;
 
 Digits — the amount of digits after decimal point in the price representation;
 
 Stops level — minimum distance to the current price in points at which Stop Loss and Take Profit orders can be placed;
 
 Pendings are good till cancel — forced closing of pending orders at the end of a session. "Yes" means that pending orders will not be closed forcedly;
 
 Contract size — one-lot price in deposit currency;
 
 Tick price — the size of minimal price change in quote currency;
 
 Tick size — minimal symbol price change interval in points;
 
 Profit calculation mode — accepted profit calculation technique (Forex, CFD, Futures);
 
 Swap type — rollover calculation type (in points, in deposit currency, or in per cents);
 
 Swap long — rollover size for a long position;
 
 Swap short — rollover size for a short position;
 
 Margin calculation mode — accepted free margin calculation technique (Forex, CFD, Futures)
 
 Margin hedge — size of margin for hedged positions.
 
 The symbol specification window can be called by pressing of "Properties" button in the Market Watch window or the "Symbol properties" of the "Tester — Settings" window.

Languages Support
 
 The Client Terminal interface is multilingual. It can be represented in any available language. This feature makes the program not only easy-to-use, but also allows to reduce the amount of errors that occur during trading because of lack of understanding of foreign terms and notions. The list of all available languages can be found in the "View — Languages" menu. One can switch one's terminal to a language by selecting of this language in the list. The language can be changed actually only after restart of the terminal. 

  ;----------------
  ;comment
  ;----------------
  MetaQuotes-demo1  192.168.1.4:443
  MetaQuotes-demo2, 192.168.1.4:444
  ;----------------
  MetaQuotes-demo3  192.168.1.5:445
  MetaQuotes-demo4, 192.168.1.5:446