Compiler Directives

Navigation:  ScriptLine Properties > Macros Options > Initial Conditions >

Compiler Directives

Previous pageReturn to chapter overviewNext page

Run-Time Parameters are used to augment or override the pre-compiler directives of the selected Macros. For a general definition of these parameters and how they are used within a Macro, see the topic Compiler Directives.


Why would one want to override these parameters in a Script rather than setting the parameter in the Macro, once and for all ? There are 3 general reasons :


Macros are shared among all users. Modifying a run-time parameter in one of your Scripts ensures that you do not break any assumption made be the person who originally wrote the Macro, and other users who have gotten used to using that Macro. The changes you make are limited to you (actually they are limited to a given DiaryGridLine within a given Script). This is particularly the case for the parameter INCLUDE_HOLIDAYS_LIST, INCLUDE_SAINTS_SET, INCLUDE_NAMEDAYS_SET.


Values used in a given Script as Input Values may require adjustment to parameters such as MAX_NUM_ITERATIONS and MAX_STRING_LENGTH, which could not be predicted when writing the Macro (and may not be useful for other users of the Macro either).


Finally, tokens within the GridTemplate associated with the current DiaryGridLine may require run-time parameter settings which could not be predicted, and which may vary from one GridTemplate to the other.


Note that you should not override the value of RUNTIME_ERROR_HANDLING, unless you feel fully confident of what you are doing.

Topic 135800 updated on 09-May-2013.
Topic URL: