Information Center

Variables

Lists the variables created in this macro. Variables are global to all screens in this macro and in any chained macros.

You can assign an arithmetic expression to a variable as the initial value, for example, 2 + 3 + 'a' = '5a' or (5 + 3) * 8 = 64. Arithmetic operations can be performed on numbers, integer variables, double variables, field variables, and string variables. When your operands are non-numeric, for example, strings and booleans, you can only use the plus sign (for string concatenation). Host On-Demand macros support the following operations:

Symbol Operation
+ Add
- Subtract
* Multiply
/ Divide
% Mod

For more information about arithmetic expressions and macros in general see the Macro Programming Guide.

Variables
Lists the variables created in the macro. To create a new variable click <new variable>.
Remove
Click Remove to remove the selected variable from the list.
Name
The variable name. A variable name should have the following format: $var_name$, where var_name can be alphanumerics, the dash symbol, and the underscore symbol. Variable names must be enclosed in dollar signs. Variable names are case sensitive.
Type
Select the variable type. The type may be standard or imported.
Import
Click Import to pop up the Import dialog. The fields on the Import dialog are described below:
For more information on imported types see the Macro Programming Guide.
Imported Types
Lists the imported types created in the macro. To create a new imported type click <new imported type>.
An imported variable type is based on an underlying Java class implemented in an external JAR or CAB file.
Remove
Click Remove to remove the imported type from the list.
Class
The fully qualified class name of the class on which the imported type is based, including the package name if any. Class names can contain only the following characters: alphanumerics, underscore (_), hyphen (-), and period (.). Case is significant. Host On-Demand does not check to see whether the class exists until the macro is run. At that time the class must be found somewhere in the classpath.
Short Name
An optional short name that you can use anywhere in the macro to refer to the imported type. If you do not specify a short name here then you must use the fully qualified class name each time you refer to the imported type in the macro.
Initial Value
Specify the initial value for this variable. The initial value must match the type.
Variables are created in the macro in the order in which they are listed. If the initial value you specify for the current variable is an expression containing other variables, those other variables must appear in the list before the current variable.

Related topics

  • Overview of the Macro Editor
  • Editing the XML script
  • Importing a macro
  • Exporting a macro
  • Variables
  • Macro Programming Guide