HP 3000 Manuals

VIRTUOSO CODE GENERATOR Reference Manual

Source Macro Files 

Macros are stored in ASCII text files known as Source Macro Files.  A
Source Macro File can contain one macro or many related macros.  The file
may begin with #comment lines which document the type of macros contained
in the file.  The #comment construct can also be used between #endmacro
and #macro (the end of one macro and the beginning of the next macro).
This helps to separate and document the macros in the file.  Blank lines
are also allowed between macros.  The following are the only Virtuoso
constructs which can be used between macros in a Source Macro File:

 *  #comment

 *  #include

 *  #option

Here is a schematic illustration of a Source Macro File:

     #comment
     #comment
     #macro
       .
       .
     #endmacro
     #
     #comment
     #comment
     #macro
       .
       .
     #endmacro
     #
     #comment
     #comment
       .
       .
       .

Sometimes it can be useful to incorporate a group of Source Macro Files
in a larger Source Macro File through the use of #include constructs.
Here is an example:

     #comment
     #include file="MAC01M00.VIRTUOSO.SYS"
     #include file="MAC02M00.VIRTUOSO.SYS"
     #include file="MAC04M00.VIRTUOSO.SYS"
     #include file="MAC05M00.VIRTUOSO.SYS"
     #include file="MAC06M00.VIRTUOSO.SYS"
     #include file="MAC03M00.ORDMGT.VIRTUOSO"
     #include file="SPX9903.ORDMGT.VIRTUOSO"

Each of the #include files above is itself a Source Macro File.  There
are several advantages to breaking a large Source Macro File into smaller
files.  Smaller files are easier to maintain and process.  Also, they
provide greater flexibility.  One file can be substituted for another.
In the example above, the file MAC03M00.ORDMGT.VIRTUOSO is a substitute
for MAC03M00.VIRTUOSO.SYS. The file MAC03M00.ORDMGT.VIRTUOSO contains a
customized version of the macros.

You will need to determine the way in which your organization will handle
macro files.  If you customize the macros, it is recommended that you
document the additions and changes to aid in maintenance and usability.

MPE/iX 5.0 Documentation