Cable Gridder Manual v1.2

From JTAWiki
(Redirected from Manual Cable Gridder)
Jump to: navigation, search

JTA_Sales.png   Cable Gridder Manual v1.2 
From JTAWiki, a project by J Talon LLC

Warning.png Please note that Cable Gridder v1.2 can only be used on MT4 build 600+, and all previous builds can only be used on MT4 build 509 and previous.


Cable Gridder is an Expert Advisor which is designed to run on the GBPUSD 30 minute chart, although you are quite welcome to test using different time frames and symbols.

It uses the Adaptive RSI indicator and/or a MARSI cross as its Entry Method, which can also be filtered using RSI Trend protection. Further trades will be added if required by the placing of a grid. It uses two separate baskets of trades - one long and one short - which can both be active at the same time if allowed. Additional trades can be added to the basket when the price goes against it, or even if the basket is making a profit. All trades are placed using market orders, and the EA does not use pending orders.

The lot size for each trade can be fixed, or based on the portion balance using money management. If your account is held in a currency other than USD and you are using Money Management then our proprietary Currency Convertor will ensure that the starting lot size is based on the same formula as used in our back tests.

There are three different methods for taking profits, and all three can utilize a trailing stop if required.

But Cable Gridder is not only about making profits, it is also about protecting your account balance when things do not go according to plan, by using Equity Protection. This is achieved by using portion control, maximum drawdown limits, power out stop losses and Emergency Close All.

There are several methods you can use to specify Trading Times, including a Time filter, Holiday Shut Down times, and ShutDown after basket close.

Cable Gridder can also provide you with Information, through the use of the Display Overlay, as well as lines to show BE and TP points and buttons for manual trade execution. You can view the main details of every open chart by using the JTA Dashboard. It can also save Account Balance and Equity statistics in order to allow you to create an equity chart.



You can download the installation file from our store by using the link in the email sent to you confirming your payment. You should bookmark this link, to ensure that you always have access to download the installation file.


Please follow the instructions on the EA Installation page of our Wiki.


As long as you remain a subscriber, or if you have purchased Cable Gridder, then you are entitled to receive all upgrades of the EA for free. When an upgrade is released, you will be advised via email to the email address used when you made your payment. If you would like to change your email address, then please send details of the new address to

The EA will automatically download any new version to a folder on your hard drive through the Auto Update function, and will display a button on the chart to inform you that a new releae is available. Read more about where the file is stored, and how to install it from the Auto Update page of the Wiki.


If you have problems when installing the files, attaching it to a chart, or running the EA, please go through each of the items on the Experts troubleshooting page of the Wiki.

Error Messages

After you have successfully installed the EA there are many checks made on the Input Parameters and your Account Settings to ensure that there are no problems. If there are problems which are serious enough to stop the EA from trading then you will see an Error Message on the Overlay, and you can get more details of the error and possible solutions on the Error Messages page of the Wiki.

Entry Methods

Allow Trades

Cable Gridder will only be allowed to open orders if AllowTrades is set to true. If AllowTrades is set to false then no trades will be placed, but you will be able to view the details on the chart overlay - see Restricting Trading for details.

Star full 256.png
It is recommended that you leave AllowTrades at false when you load Cable Gridder on to a chart, then when the overlay has settled down after a few ticks, and the 'Waiting for next tick ...' message has been cleared, you should click the 'Allow Trades is set to false' button on the chart overlay, which will then allow trading without having to change the EA's Input Parameters again.

Trade Long and/or Short

Under normal circumstances Cable Gridder will open Long (Buy) trades and/or Short (Sell) trades. However you can restrict trading to one direction only by setting either TradeLong or TradeShort to false.

ARSI Indicator

If UseARSI is set to true the main entry method is the Adaptive RSI indicator (ARSI), which is hard coded into the EA. The time frame for the ARSI indicator is set with ARSITF and the number of bars is set with ARSIPeriod. The direction of the first trade is determined by whether the ARSI is rising or falling, and the minimum value of the rise or fall can be set using ARSITrigger (in pips). If the value of ARSITrigger is set to 0 then the trigger will be based on the ATR of the last 13 periods of the M1 chart. If the rise or fall is less than the ARSITrigger then the market is ranging, and no trades will be placed.

MARSI Indicator

If UseMARSI is set to true then the MA of RSI will also be used as an entry indicator. The timeframe for the MARSI indicator can be set with MARSITF, and the period of the RSI is set using MARSIPeriod, with the MA period set with MARSIMAPeriod. The direction of the trade is determined by whether the RSI is higher or lower than the MA of the RSI.

If both entry methods are in use then they must both show the same entry direction before a trade can be placed. The direction of the first trade will be placed in the same direction as the trend, unless ReverseDirection is set to true. If it is set to true then the display overlay will show (R) after the Entry conditions header. All trades will be placed using market orders.

Trend Protect

The entry can also be filtered if TrendProtect is set to true. The time frame for TrendProtect can be set using RSITF and the filter uses the RSI of the last 14 bars of the chart to determine whether the price is in an overbought or oversold zone, and will only place a trade between these two extremes. This zone is set using the RSIWindow variable, where a value of 40 (default) will only allow trades when the RSI is between 30 and 70.

If AllowHedgeTrades is set to true then it is possible that Cable Gridder will place an initial trade for baskets in both directions if the trend changes. Setting it to false will only allow trades in the direction of the first trade.

Back to Overview

Money Management

Lot Size Calculation

If UseMM is set to false, then the lot size for the first trade in each direction will be based on the value set in StartLot. Each subsequent trade will increase by the value set in StartLot. Note that the Buy and Sell baskets each have their own lot size progression.

If UseMM is set to true then the starting lot size is based on the portion balance (set with PortionPC), multiplied by the value of MaximumRisk. A MaximumRisk of 1 will produce a starting lot size of 0.01 for approximately each $10,000 USD of Portion Balance - this may vary depending on your account leverage. Each subsequent trade in each of the baskets will increase by the value of the starting lot size.

Currency Conversion

If you are using Money Management and your live/demo account is not held in USD, then it is important that the formula used in calculating the starting lot size is consistent with our back tests, so our proprietary Currency Convertor will automatically convert your Portion Balance into USD before performing the MM calculation.

In order for Currency Conversion to work the Currency Symbol for your account currency/USD must be visible in the Market Watch window - you will see an error message if the EA can not find it. If the Currency Symbol has a Prefix or a Suffix then these should be entered in the appropriate parameter on the input screen (F7).

Warning.png The Currency Convertor can not work when back testing because MT4 is not capable of using currencies other than the one under test. When back testing you should always use a demo account in USD.

The overlay display will show you the Portion Balance currency conversion, and also the approximate ratio for the portion balance for every 0.01 lot.

Back to Overview

Grid Entries

Once the first trade has been placed then the same entry conditions will be used for opening further trades. If the trend changes after the first trade then it is possible that a trade will open in the opposite direction to form a second basket, if AllowHedgeTrades is set to true.

Auto Spacing

If AutoSpacing is set to false then subsequent trades for each long or short basket will be placed if the price moves against the basket, based on a grid which is set by the distance entered in Spacing. If AutoSpacing is set to true then the grid size will be calculated using the Standard Deviation indicator, with a minimum distance of the value of Spacing. The parameters for the Standard Deviation indicator can be changed using StDevTF to set the time frame, StDevPeriod to set the period, and StDevMode to set the MA method.

Trend Spacing

It is also possible to place new trades if the price goes with the basket. The distance of the next trade is set with TrendSpacing, and again the trade will only be placed if the entry conditions are met. If AutoSpacing is set to true and TrendSpacing is not turned off (a setting of 0) then the value of TrendSpacing will also be calculated using the Standard Deviation.

Entry Delay

Any subsequent trade will only open after the number of seconds set in EntryDelay, including the first trade of a basket opened in the opposite direction.

Back to Overview

Manual Trading

Adding Trades Manually

It is possible to place a manual trade to either add to an existing basket, or to create a new one. In order to use the BUY and SELL buttons on the display you must have dButtons set to true. It is also possible to place trades using the Knight-Fire tool provided by ianj, but you must ensure that the correct magic number and lot size are entered.

If there is not a basket of trades open in the direction that you are placing the trade then the lot size of the new trade will be set to the normal Starting Lot size.

If there is already a basket open then the lot size used will follow the normal lot size calculation.

If ConfirmButtons is set to true then you will be asked to confirm the trade placement.

Warning.png The Buy and Sell buttons used for manual trading are not limited by any of the rules which limit the EA from trading. They will ignore any EntryDelay, MaxSpread, AllowTrades etc. settings.

Warning.png If you use ConfirmButtons then the time taken to place the trade will take longer, and it is possible for the price to have changed so much that the trade is rejected by the broker. Please check the Terminal/Experts log for any error messages and be prepared to place the trade again if required.

Closing Trades Manually

Warning.png It is not recommended that you close individual trades in a basket, other than the latest level opened in each basket. Doing so can have unexpected results, and can affect the lot size of subsequent trades making it harder to close the basket.

If you need to close trades manually then we recommend that you close all the trades of a basket, which can be achieved quickly by using the Emergency Close All function.

Back to Overview

Profit Taking

Profit Target

The target profit is set using ProfitTarget, which is a value in US dollars. The ProfitTarget is automatically converted into your Account Currency by our proprietary Currency Converter. The display overlay will show the target profit in your local currency, with the value in USD in brackets. If money mangement is off the ProfitTarget is a fixed amount for each basket, but if money mangement is on the ProfitTarget will increase every time the starting lot size increases.

Star full 256.png

If you have UseMM set to false and you set a value greater than 0.01 as the StartLot then you should increase ProfitTarget by the same proportion.

Profit Mode

There are three profit modes, set with ProfitMode: Mixed (1), Global (2) and Split (3).
Split mode treats the Long and Short baskets completely separately, and will close each basket when it hits the required ProfitTarget.
Global mode treats all long and short trades as a single basket which will close when the required ProfitTarget is reached.
Mixed mode is a combination of the previous two modes, and will close trades when any of the three basket types (Long, Short, Global) reaches the required ProfitTarget.

Profit Trailing

In order to maximize profits from any basket you can set ProfitTrailing to true. This will allow the profits to grow, and will only close the basket when the profit drops by the percentage set in MaxRetrace, as long as the remaining profit is still greater than or equal to the ProfitTarget.

Note that if you have both UseFIFO and AllowHedgeTrades set to true then the ProfitMode will automatically be set to Global (2) to ensure that all trades can be closed in chronological order.

Back to Overview

Equity Protection

Equity Stop Loss Protection

Equity Protection was developed to prevent a total blowout of your account. No matter what entry methods are used, or how you determine the trend, there is no way to 100% guarantee that the first trade of the basket will open in the right direction. We must therefore accept that Cable Gridder will sometimes get it wrong, and will need to open a basket of trades in order to trade out of the situation.

However opening extra levels in a basket at increasing lot sizes will increase the drawdown on the account, and could result in losing the whole of the balance.

Cable Gridder will protect you from losing all the account balance by using Portion Control to allocate only a fraction of the total account to this chart, and by using MaximumDDpc to limit the amount that can be lost. If the drawdown of the trades opened by this chart reaches MaximumDDpc then all open trades will be closed. Or to put it another way, the trades will close if the chart EQUITY drops by the MaximumDDpc of the chart BALANCE.

Account Protection

If you were unfortunate enough to have an EP hit, then Cable Gridder would just carry on trading without some means of stopping the chart from trading. This is provided by the Protected Balance feature of Cable Gridder . This is designed to stop Cable Gridder trading on this chart if the portion balance drops lower than the amount set in ProtectedBalance. Note that the charty EQUITY may drop below the ProtectedBalance without closing trades or stopping the chart from trading. It will only stop trading when the chart BALANCE drops below the set amount.

The portion balance can reduce after having an EP hit, or from withdrawing funds from your account. The value of ProtectedBalance is not dynamic, so if you want to increase it as the account balance increases then you must do so manually.

If you want to restart trading after it has been stopped, you will need to 'reset' Cable Gridder . This can be done by going into the EA Inputs (F7) and clicking OK, or removing Cable Gridder from the chart and reloading it. Both of these methods will force Cable Gridder to restart.

Note that the ProtectedBalance is based on the portion BALANCE allocated to this chart, and MaximumDDpc is based on the portion EQUITY.

Power Out Stop Loss (POSL)

Cable Gridder does not send Take Profits or Stop Losses to your broker. In the unfortunate event of you losing your internet connection, Cable Gridder will not be able to monitor trades, so will not be able to close them at a profit, but worse, your open trades will not have any of the above methods of Equity Protection.

In order to maintain Equity Protection you can set UsePowerOutSL to true. This will allow Cable Gridder to send a stop loss to your broker, based on the value of POSLPips (default 999) from the break even point of the basket.

When the basket opens the first few levels, the lot sizes are small so a movement of 999 pips will result in a small loss, and will be nowhere near the 50% set in MaxDDPercent. However, as lot sizes increase at higher levels, a movement of 999 pips will cause a much higher loss, so the value of POSL is reduced to limit the maximum loss to MaxDDPercent + 1%. The additional 1% is included so that POSL can not interfere with the normal logic of Cable Gridder.

Once POSL has been set by Cable Gridder, it can not be removed manually because Cable Gridder will automatically reinstate it. In order to remove it, you must leave UsePowerOutSL at true, but change POSLPips to 0. After the next tick, all stop losses should have been removed from the basket trades, and you can change UsePowerOutSL to false.

As long as UsePowerOutSL is set to false, you can also set a manual stop loss on any trade, and they will not be overwritten by Cable Gridder . Assuming that the trade has not been closed normally by Cable Gridder, your broker will close the trade at the SL you have set.

Emergency Close All (ECA)

This is a way of simply getting out of all trades on this chart. A user may have several EAs on their account, or several charts running Cable Gridder, and it might be difficult to find every trade relating to this chart and close them out.

The quickest way of initiating ECA is to click the ECA button on the chart, if you have dButtons set to true. If you have ConfirmButtons set to true you will be asked to confirm your action. If ConfirmButtons is set to false then all trades will be close immediately. Once the trades have closed the button will revert to its normal colours, and internally the value of EmergencyCloseAll will be set to false so that further trades will not close automatically.

You can also use the ECA button against the chart summary on the JTA Dashboard if it is active, which acts exactly the same as the button on the chart as described above.

You can also initiate ECA by using the EA's Input Parameters (F7), and setting EmergencyCloseAll to true. Once you click OK, Cable Gridder will close ALL open trades on this chart, and the display overlay will warn you that EmergencyCloseAll is set to true. This is as a reminder to change the setting back to false, because if Cable Gridder opens more trades and you decide to change the parameters for another reason but do not change EmergencyCloseAll back to false, Cable Gridder will once again close all trades.

Cable Gridder will close all trades immediately but will continue trading. Depending on what entry method you are using, you may get an immediate placing of a new trade if entry conditions allow. If you also want Cable Gridder to stop trading after ECA, you should set Shutdown to true at the same time as setting EmergencyCloseAll to true.

Back to Overview

Restricting Trading

Setting the AllowTrades parameter to false will not allow the EA to open or close any trades on this chart, even though the overlay display will still be updated. You can use this setting to ensure that you have entered other parameters correctly, and the chart portion and starting lot size are to your expectations. Once you are satisfied you can set AllowTrades to true.

Star full 256.png
It is recommended that you leave AllowTrades at false when you load Cable Gridder on to a chart, then when the overlay has settled down after a few ticks, and the 'Waiting for next tick ...' message has been cleared, you should click the 'Allow Trades is set to false' button on the chart, which will then allow trading without having to change the EA's Input Parameters again.

However, even with AllowTrades set to false you will still be able to use the buttons on the chart to open a new BUY or SELL trade, or close all trades with the ECA button.

Warning.png AllowTrades is set to false by default - you must change it to true to allow the EA to trade.

Once the EA has started running there are several other settings which can be used to restrict trading:

Time Filter

You can specify at what times Cable Gridder should trade by using the time filter. The time settings are based on the start and stop times during each day of the week, with an additional setting for Non-Farm Payroll Fridays.

The default settings allow Cable Gridder to trade between 9pm and 6am GMT every day. This is to allow the EA to run during the 'Asian' session, and avoid any volatile price movements during the London and New York sessions.

The start and stop times are based on the 24 hour clock, and can be entered as whole hours (8-15), or hours and minutes using a colon (8:30-16:45), or a combination of the two (9-16:48).

You can set as many trading times during each day as you like by separating each start and stop time with a comma (0-5:30,11-16:45,20:30-24). It is important that each stop time is greater than the previous start time, and each start time is greater then the previous stop time (if any). Each different Start-Stop period during a day is called a session.

To start trading at midnight, set the start hour as 0 (0-?), and to stop at midnight set the stop hour as 24 (?-24). If one day's stop hour is 24, and the next day's start hour is 0, then trading will continue over midnight, and the two periods will be treated as one session.

If you don't want to trade at all during a day, then leave that day's trade times blank.

The start and stop times are based on either your local time, the broker's time, or GMT. All our backtests are based on GMT times, but you have the choice of using local or broker time if you wish. Here is how the settings should be entered:

GMT Time Settings
Enter the start and stop times for each of the sessions that you want to trade each day based on GMT.
The EA needs to know what the time difference is between GMT and your broker, which you can set with BrokerTimeOffset. (Your brokers' web site should have details of what their GMT offset is - if not drop them a line). This time difference can also be calculated automatically if AutoGMTOffset is set to true.
Local Time Settings
Enter the start and stop times for each of the sessions that you want to trade each day based on your local time.
The EA needs to know what the time difference is between your local time and your broker, which you can set with BrokerTimeOffset (Take the Broker Time from the Overlay and deduct your local time. Enter this time difference in BrokerTimeOffset - if the difference is negative make sure you enter a negative value). If you are using local time settings then you must ensure that AutoGMTOffset is set to false.
Broker Time Settings
Enter the start and stop times for each of the sessions that you want to trade each day based on your broker's time. Remember that you may need to change the trading times if your broker is subject to Daylight Saving changes.
The EA does not need to make any adjustments for the GMT offset, so make sure that BrokerTimeOffset is set to 0 and AutoGMTOffset is set to false.

You can choose how the trading times are displayed on the overlay by the use of the DisplayBrokerTimes setting. If set to true then all trading start and stop times will be displayed at the broker's time zone. If left at the default of false the times will be displayed as the user's input times, as they were in previous versions.

The display overlay will inform you of the stop time of the current trading session or the start time of the next trading session in Green. If there is a basket of trades open and the session has ended, the display will show the start time of the next session in Yellow. The broker time offset will be shown in brackets after the broker time, and will be displayed in blue if set manually, or green if calculated using AutoGMTOffset, and the Local Time:GMT difference will also be shown in green if positive and red if negative.

Shut Down

ShutDown is a way of telling Cable Gridder that we don’t want to continue trading after the current basket is closed. Once the basket closes, Cable Gridder simply will not place any more trades until ShutDown is reset to false. ShutDown can be turned on or off at any time and the display overlay will inform you when it is turned on.

ShutDown can be set to true in the parameter settings of the EA, or simply by clicking the SD button on the chart if dButtons is set to true. You can also use the SD button on the JTA Dashboard. If using the Buttons, you will be asked to confirm your action if ConfirmButtons is set to true.

The colour of the button will be reversed when ShutDown is true, and the chart display overlay will also inform you when it is turned on. You can turn ShutDown on and off as often as you like by clicking the SD button.

Once the basket closes the overlay will display that trading has stopped, and that you will have to set ShutDown to false in order to continue trading. Again, this can be done simply by clicking the SD button.

Holiday Shut Down

Setting UseHolidayShutdown to true will stop Cable Gridder from trading during the dates specified in HolidayDates.

The HolidayDates are entered in the format [day]/[month]-[day]/[month], and if there is more than one holiday period they must be separated by a comma. All dates are inclusive, so Cable Gridder will restart trading the day after the final holiday date. The next holiday period will be displayed on the display overlay if it is enabled, giving confirmation that the dates have been entered correctly.

You can also automatically set Cable Gridder to shut down over the Easter period. This is also controlled through the HolidayDates parameter, but the information is entered in the format 'E-2+3', where the E tells the EA that it is an Easter break, the -2 will shut down for the 2 days before the Easter weekend, and +3 will stop trading for 3 days after the Easter weekend. The date of the Easter weekend is automatically calculated, and both the - and + portions must be present. If you do not want to restrict trading during one of the periods then enter -0 or +0, but note that the EA will not trade on either Good Friday or Easter Monday.

If a basket is open when the holiday shutdown starts, Cable Gridder will continue to monitor the trades, and will still open new levels if entry conditions allow, unless HolidayAllowTrades is set to false, when the current trades will still be monitored, but no more trades will open until the holiday period is over.

Limiting Open Charts

Cable Gridder will allow you to restrict the number of charts with open trades. This means that you could set up 10 charts all running Cable Gridder, but only allow 3 of them to have open trades at once. The other 7 will wait patiently until one of the three closes their basket, and will then open a new basket if entry conditions allow. You can also restrict a chart from opening a new basket if the Drawdown on another chart is over a set limit. Both of these restrictions can be applied to only Cable Gridder charts, or to charts from any of JTA's EAs.

Because the control of the number of open charts and drawdown needs to be controlled from a central location, this function is run from the JTA Dashboard, which is where you will find all the relevant parameters.

Back to Overview

Trade Tracking

Cable Gridder keeps track of all open trades by using a unique magic number.

I say unique because it uses an algorithm based on:

  • The EA name,
  • The EANumber,
  • The chart on which Cable Gridder is running, and
  • The time frame of the chart.

This algorithm produces a number between 1 and 2,147,483,647, and while it is extremely unlikely that different instances of any of our EAs would result in the same magic number, it is possible. It is therefore recommended that once Cable Gridder has been added to a chart that you check other instances of all EAs to ensure that the magic number is indeed unique. (Use the [[JTA_Dashboard|JTA Dashboard for a quick check).

In order to run Cable Gridder on 2 or more charts with the same pair and timeframe, then all you need to do is to alter the EANumber, so the first chart has an EANumber of 1 (default), the second an EANumber of 2, etc. This will generate a different magic number for each chart.

There is no need to use a different EANumber to differentiate between a Cable Gridder chart and TF when used with other EAs like Evolution and Blessing because they have a different EA name, so will have different magic numbers.

You can bypass the automatic magic number generation by setting a magic number of your own. This is achieved by setting the EANumber to any unique number greater than 99. This EANumber will then become the magic number.

Bear in mind that if you change the Time Frame of a chart on which Cable Gridder is trading, then a different magic number will be generated. This means that any open trades on that chart will no longer be monitored. If the TF was changed accidentally, changing it back will allow Cable Gridder to carry on trading as normal. However if you want to change the chart TF permanently, you can still monitor any open trades by changing the EANumber to the magic number (displayed at the top right of the chart) BEFORE the TF is changed.

You can keep track of which instance of Cable Gridder opened / closed which trades by using the TradeComment parameter. By default this is set to the EA name and version, and can be changed to anything of your choice. You can view the Trade Comment in the 'Trade' and 'Account History' tab of the 'Terminal' window of the MT4 application. If the 'Comment' column is not visible, right click anywhere in the Terminal window, then left click 'Comments'.

It is recommended that you change TradeComment from the default EA name and version, so as not to inform your broker which EA is in use.

Warning.png MT4 build 600+ puts a limit on the number of characters which can be used in the trade comment to 31. Please ensure that your TradeComment is 31 characters or less to enable it to display in the Comment column.

If you are not using the default settings then you can also use the UserComment on the display to identify which settings are in use on this chart. The default setting will show the EA name and build number, but it can be changed to anything you like.

Back to Overview

Feedback Information

Display Overlay

The Overlay will show you a wealth of information, most of which is fairly self explanatory. However there are times when a label will display a different message, or will change colour, so here are some of the subtle changes that you may not notice at first:

Trading Times - this label will normally display in the default display colour if you are displaying the trading times as at the broker's time zone (DisplayBrokerTimes is set to true) or in green if DisplayBrokerTimes is set to false, and will give details of when the current session will end or when the next session is due to start. If there are open trades in the basket when a session comes to an end, the next start time will be displayed in yellow.

This label will also show, in red, some of the reasons why trading has been prevented, for example:

The EA is still processing the first tick after being loaded,
AllowTrades has been set to false.
The spread is greater than MaxSpread
The basket EntryDelay has not passed.
Trading has been stopped because of an error in the settings - check the Terminal Experts tab for the reason why.

If Currency Conversion is in use because your account is not held in USD, then the conversion label will display in red if there is an error in the conversion.

The number of open BUY and SELL trades is normally displayed in CornflowerBlue. They will be shown in Red when the MaximumBuyOrders or MaximumSellOrders has been reached.

The Drawdown percentage normally displays in DeepSkyBlue, but it will change to Green at 10%, Yellow at 20%, Orange at 30%, and Red at 40%.


Cable Gridder is a very complex EA, and in order to ensure that each function is working correctly it is sometimes necessary to enable a Debug print.

Under normal circumstances there is no need to set Debug to true. However there are some occasions when you might find the additional information useful.

With the complex changes to our dll file there are many additional errors which you may encounter. In order to obtain details from the dll another parameter is provided, DebugDLL, which will output messages to a log file.

Warning.png It is highly recommended that you do not set DebugDLL to true unless requested to do so by a member of the JTA team. It will generate a very large log file which will eventually fill your hard disk.

Display Lines

If dLines is set to true then the following horizontal lines will be displayed on the chart at various times:

Green Dash-Dot line - MT4 line to show the open price of a Buy or Sell trade.
Green Solid line - line to show the Break Even point of any open Buy trades.
Red Solid line - line to show the Break Even point of any open Sell trades.
DodgerBlue Solid line - line to show the Break Even point of all open trades (Buy and Sell).
Gold Solid line - line to show the Take Profit point of the open trades.

The colours of the MT4 open trades arrows will be shown in DodgerBlue for Buy trades and FireBrick for sell trades.

The colours of the MT4 close trades arrows will display in Gold if the basket closed at a profit, and Red if closed at a loss.

Display Buttons

The display overlay also has the option to display several buttons on the chart. Set the parameter dButtons to true to display them, and to false to remove them.

As soon as a button is pressed, its colours will reverse so that you can see that the function has been triggered, and they will revert back to normal once it has finished. The only exceptions to this is the ShutDown (SD) button, which will remain in the reverse colours all the time that ShutDown remains true, and the F, M and P buttons which will be disabled for 5 minutes in order to prevent overloading your computer with multiple clicks.

There are 5 buttons which affect the overlay display, which are the B, O, T, E, and D buttons. These buttons act as follows:

  • D - will turn the Debug information on/off. Note that this will also change the setting of the Debug parameter, with the associated printing of the Debug information in the Experts or Journal tab.
  • E - will turn the Entry condition information on/off.
  • T - will turn the open Trades information on/off.
  • O - will turn all the remaining Overlay information on/off.
  • B - will remove all Buttons, other than the B button, from the screen.

There are 3 buttons which provide links to pages on our web site, which are:

  • F - will open your web browser and take you to the Blessing Pro! Forum.
  • M - will open your web browser and take you to the Blessing Pro! Manual on the Wiki.
  • P - will open your web browser and take you to the Blessing Pro! Parameter page on the Wiki.

The following buttons affect how the EA trades, and you can choose whether these buttons will execute as soon as you press them, or whether they display a messagebox with details of the action to be taken which you have to confirm, by setting the parameter ConfirmButtons. These buttons are:

ECA - see Emergency Close All for operation details.
BUY - see Adding Manual Trades for operation details.
SELL - See Adding Manual Trades for operation details.
SD - See ShutDown for operation details.
Reset - This button will allow you to reset the Maximum Drawdown percent as shown on the display overlay. It will also reset the Maximum Drawdown value and date/time which is displayed if you have Debug set to true. Note that if you have a basket of trades open when the Reset button is pressed, the Maximum Drawdown percent and value will be set to the Drawdown and Minimum Profit figure on the overlay, and the date/time of that drawdown will be set to the date/time at which the button was pressed.

These buttons will only appear under certain circumstances:

  • If you are using the JTA Dashboard then a DB button will also be visible on the chart, which will bring the DashBoard chart to the top when clicked.
  • When AutoUpdate has downloaded a new version you will see a 'New Version Available' button next to the EA name and build number on the chart overlay.
  • If your CID has changed you will see a 'Open CID Swapper' button, which will allow you to change your own CID.

All the buttons will act as they should while back testing in visual mode. The only difference while backtesting is that the Strategy Tester is unable to display a message box, so whether ConfirmButtons is set to true or false the buttons will always act as though it was set to false.

You can change the font size of the button text with the dButtonFontSize variable.


When back testing on a chart, the Strategy Tester report will supply you with summary details of the account balance and relative drawdown. You can also see a graph of how the balance increased, together with the equity at that point. The problem with this graph is that each point is displayed only when a trade closes. It does not show the balance and equity over time, which is what the Statistics settings will allow you to do.

In order to produce a statistics report, you must set SaveStats to true. If you want to save the statistics for a forward test, you should leave the StatsInitialise parameter at its default setting of false so that new data will be added to the existing file. When you are backtesting it will automatically be set to true so that a new statistics file is created for each backtest. So you only need to change StatsInitialise to true when you would like to close an existing stats file and start a new one. You also need to decide how often to store the statistics information, and setting StatsPeriod to 3600 will save the statistics data once every hour, which provides a reasonable number of data points for a 2 or 3 year back test.

For a detailed explanation of what to do with this data read the Creating an Equity Chart page on the Wiki.

Thanks to ianj for providing the idea and original code.

Back to Overview

JTA Dashboard

If you have installed the JTA Dashboard on another chart, then all the important information from the overlay will also be displayed on the Dashboard.

The chart overlay will also have another button showing DB, which will automatically bring the Dashboard chart window to the top.

Please read the JTA Dashboard Manual for further details.

Back to Overview

See Also

Cable Gridder Parameters
Cable Gridder Manual v1.0
Cable Gridder Manual v1.1

Disclaimer Copyright © 1995-2016 J Talon LLC, All rights reserved