This property page displays the macros that have been defined for use with the Application object. These macros, referred to as Application object macros, are simply variable names that are associated with values, typically string values. For example, when you create an Application object using an .AOT or .AXT file, a SOURCE_PATH macro is automatically added to the list. This macro defines the location of the source files from which the application will be installed. Many times, you need to enter the source path when defining other properties for the Application object. By creating a SOURCE_PATH macro, you only need to enter %SOURCE_PATH% rather than the actual source path.
You can use Application object macros when defining the following Application object properties:
IMPORTANT: When using a macro for any of these properties, you must enclose the macro name in % characters (for example, %SOURCE_PATH%).
Macros
The Macros list displays all macros that have been
defined for use with the Application object.
File
This option lets you search for specific macro information and import macros
from other Application objects..
Add
Use the Add button define an Application object macro and add it to the Macros
list. You can add either a String Value macro or a Prompted macro.
String Value
A String Value macro is used to create a variable that has a string value associated with it. This lets you use the variable in multiple locations while defining the value in one location.To create a String Value macro, click Add > String Value to display the Edit String Value dialog box. In the Value Name box, type a name for the variable > type the value for the variable in the Value Data box. Click OK to add the macro to the Macros list.
You can place macros within macros. In the following example, a special Windows* macro, *WINDISK, is used when defining the TARGET_PATH macro:
Value Name: TARGET_PATH
Value Data: %*WINDISK%\Program FilesWhen embedding another macro in the string, you must enclose the macro in % characters, as shown in the above example. You can embed special Windows macros, NDS attribute macros, environment variables, login script variables, and other Application object macros.
Prompted
A Prompted macro is used to create a macro that prompts the user to accept the default value (either a drive or string) or enter a new value.To create a Prompted Drive macro, click Add > Prompted > Drive to display the Prompted Drive Macros dialog box. Fill in the fields as described below:
- Macro Name: Give the macro any name you want.
- Prompt Text: Enter the text you want presented to users. For example, "This application will be installed to your C: drive. Enter a different drive letter if desired:".
- Default Value: Select the drive that will be used if the user does not enter another drive letter.
- Minimum Disk Space in MB: Enter the minimum amount of free disk space required to install the application.
To create a Prompted String macro, click Add > Prompted > String to display the Prompted String Macros dialog box. Fill in the fields as described below:
- Macro Name: Give the macro any name you want.
- Prompt Text: Enter the text you want presented to users.
- Default Value: Select the value that will be used if the user does not enter another value in response to the prompt text.
- Minimum Disk Space in MB: Enter the minimum amount of free disk space required to install the application.
- Maximum String Length in Chars: Enter the maximum number of characters the user can enter as a response to the prompt.
Modify
Select the macro whose information you want to
modify > click Modify.
Delete
Select the macro you want to delete > click
Delete.
A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk denotes a third-party trademark. For information on trademarks, see Legal Notices.