Retro1.org codex

MACLIB                                                    CMS User Area command

Use the MACLIB command to create and modify CMS macro libraries.  The format of
the MACLIB command is:
+----------+------------------------------------------------------------------+
| MAClib   | GEN  libname fn1 [fn2...]                                        |
|          | ADD  libname fn1 [fn2...]                                        |
|          | REP  libname fn1 [fn2...]                                        |
|          | DEL  libname membername1 [membername2...]                        |
|          | COMP libname                                                     |
|          | MAP  libname [(DISK|TERM|PRINT[)]]                               |
+----------+------------------------------------------------------------------+
where:

GEN      generates a CMS macro library.

ADD      adds members to an existing macro library.  No checking is done for
         duplicate names, entry points, or CSECTS.

REP      replaces existing members in a macro library.

DEL      deletes members from a macro library.  If more than one member exists
         with the same name, only the first entry is deleted.

COMP     compacts a macro library.

MAP      lists certain information about the members in a macro library.
         Available information includes member name, size, and location
         relative to the beginning of the library.

libname  is the filename of a macro library.  If the file already exists, it
         must have a filetype of MACLIB; if it is being created, it is given a
         filetype of MACLIB.

fn1 [fn2...]
         are the names of the macro definition files to be used.  A macro
         definition file must reside on a CMS disk and its filetype must be
         either MACRO or COPY.  Each file may contain one or more macros and
         must contain fixed-length, 80-character records.

membername1 [membername2...]
         are the names of the macros that exist in a macro library.

Map options:

The following options specify where the output of the MAP function is sent.
Only one option may be specified.  If more than one option is specified, only
the first one given is used.

DISK     writes the MAP output on a CMS disk with the file identifier of
         "libname MAP A1."  If a file with that name already exists, the old
         file is erased.  If no option is specified, DISK is the default.

PRINT    writes the file "libname MAP A1" to your A-disk and spools a copy to
         the virtual printer.

TERM     displays the MAP output at the terminal.


Usage notes:

1.  When a MACRO file is added to a MACLIB, the membername is taken from the
    macro prototype statement.  If there is more than one macro definition in
    the file, each macro is written into a separate MACLIB member.  If the
    filetype is COPY and the file contains more than one macro, each macro must
    be preceded by a control statement of the following format:
       *COPY membername
    The name on the control statement is the name of the macro when it is
    placed in the macro library.  If there is only one macro in the COPY file
    and it is not preceded by a COPY control statement, its name (in the macro
    library) is the same as the filename of the COPY file.  If there are
    several macro definitions in a COPY file and the first one is not preceded
    by a COPY control statement, the entire file is treated as one macro.

2.  If any MACRO file contains invalid records between members, the MACLIB
    command displays an error message and terminates.  Any members read before
    the invalid card is encountered are already in the MACLIB.  The MACLIB
    command ignores CATAL.S, END, and /* records when it reads MACRO files
    created by the ESERV program.

3.  If you want a macro library searched during an assembly or compilation, you
    must identify it using the GLOBAL command before you begin compiling.

4.  The MACLIBs distributed with the CMS system are:  CMSLIB, DOSMACRO,
    OSMACRO, OSMACRO1, and TSOMAC.

Responses:

When you enter the MACLIB MAP command with the TERM option, the names of the
library members, their sizes, and their locations in the library are displayed.
   MACRO INDEX SIZE
   name   loc  size
     .     .    .
     .     .    .
     .     .    .