Supported Macros

Macros can be used in the change control files. Macros can also be used in the master control file. When a supported macro is used, drives and paths do not have to be identified until the time of installation. At installation, macros can perform the following:

• Replace the full destination path of the file
  
• Replace the installation target drive letter
  
• Replace the default destination drive and path as defined in CONTROL.SCR
  
• Replace the startup (boot) drive letter of the operating system
  
• Delete specified files

The following table describes the supported macros. Refer to the TLKSTRN.SCR file in the \TOOLKIT\SAMPLES\MM\SHORTCF subdirectory for an example.

Macro

Description

The $(DELETE) macro can only be used with the DESTINDIR keyword in the master control file. The relative number is listed in the file list control file. Every file that has this number will be deleted from the user's machine.

$(DEST) is replaced with the full destination path of the file. For example:

$(DEST)CLOCK.EXE

becomes

D:\MMOS2\MMTOOLKT\SAMPLES\CLOCK\CLOCK.EXE

$(DRIVE) is replaced by the installation target drive letter. (Do not append a colon.) For example:

$(DRIVE)\MMOS2\TEST1.EXE

becomes

D:\MMOS2\TEST1.EXE

# is the number of the destination directory as stated in the file CONTROL.SCR. The macro is replaced by the default drive and path defined in the CONTROL.SCR file for the specified DESTINDIR definition. For example:

$(DIR)4\MINSTALL.LOG

becomes

D:\MMOS2\INSTALL\MINSTALL.LOG

Replaces the startup (boot) drive letter of the operating system. (Do not append a colon.) For example:

$(BOOT)\OS2\NEW.SYS

becomes

C:\OS2\NEW.SYS

where C: is the drive on which OS/2 is installed.

Note: Using multiple macros is supported.