Pathmaker Reference Manual

MACRO Statement
Pathmaker Application Definition Language (PMADL)
2–14 067869 Tandem Computers Incorporated
MACRO Statement The MACRO statement registers a Pathmaker macro language macro in the current
Pathmaker catalog. If the macro does not currently exist, this statement creates it. If
the macro does exist, this statement replaces the macro in the project catalog.
The macro is defined by its source code, which is contained in a section of a macro
copy library file.
MACRO name ( { SOURCE filename }
[ , DESC[RIPTION] text [ , text ] ... ]
) ;
name
Specifies the name of the macro to be registered within the current Pathmaker
catalog. The macro name also identifies the macro source code's section in the
copy library file.
SOURCE filename
Specifies the name of the copy library file that contains the macro's source code.
The file name is a disk file name. The file name is created if it does not exist when
the macro is registered.
DESC[RIPTION] text
Specifies the internal documentation text to be associated with the macro
registration. Each string of text can be up to 79 characters long.
If you do not provide a description, the macro registration will not have any
internal documentation associated with it.
Usage Considerations Registering a macro allows you to write service code that invokes a macro using the
macro’s logical name. The logical name is mapped to a physical disk file byt the
Pathmaker product when a server containing the service is generated.
By registering a macro, you enable the Pathmaker product to track the macro source
file and move it when you use the PMPROJECT EXPORT and IMPORT commands.
Example The following statement registers a macro named ERROR-HANDLE, which resides on
$VOL.SUBVOL. ERRH. The statement includes a text description of the macro’s
function.
> MACRO error-handle ( SOURCE $vol.subvol.errh
, DESC “Use this macro for all server”
error handling.”
) ;