Runtime parameter specification

The statements in a macro usually have parameters that need to be assigned values. Wintrack gives each macro 16 parameter registers which can be assigned parameter values when the macro is run. In your macro statements, you can replace explicit parameter values by place holders that refer to parameter registers and thereby defer the specification of values to the moment when you actually run the macro. This feature allows you to reuse a macro in different contexts without having to modify the macro code itself. This is how it works:

Command
   Param_1={1}
   Param_2=value
   Param_3={2}
   Param_4={1}

Command
   Param_1={1}{2}

When you create the macro, for some or all parameter assignments instead of typing values, type place holders, that is, numbers framed by brackets. Make sure not to use numbers greater than 16. You can use the same place holder for two or more parameters within the same or in different commands if you want them all to be always assigned the same value as the macro is executed. You can also combine place holders to make up for one parameter value.

 Macro AA BBBB

this command line translates the above macro into:

Command
   Param_1=AA
   Param_2=value
   Param_3=BBBB
   Param_4=AA

Command
   Param_1=AABBBB

Whenever you run the macro, you will have to specify run time parameters which are stored in the macro's parameter registers in the same order as they appear in the call. Before executing a statement, Wintrack will replace the place holders with the value stored in the respective parameter register:

• it will replace all occurrences of the place holder {1} by the text of the first parameter you specified for the macro call,
• it will replace all occurrences of the place holder {2} by the text of the second parameter you specified for the macro call,
• and so on until there are no place holders left.

  When nesting macros, you place run time parameter values behind the macro name in the macro call statement, separated by white spaces. When running a macro with the Run Macro command, you enter the run time parameter values into the parameters field of its dialog. In both situations, parameter values are only identified by the typing order and no use is made of parameter names.

Additional information...

• To obtain help on the syntax and parameter defaults of specific macro statements use the list presented in Macro statements.
• Creating and using macros gives an overview on Wintrack macros.