MACLIB MACLIB Use the MACLIB command to create and modify CMS macro libraries. The
format of the MACLIB command is:
r--- --_.--, I MAClib I ADD
{
GEN}
libname fn1[fn2 ••• ] I I I I , I I , , I I I I I L- REP
DEL libname membername1(membername2 ••• ] COMP libname MAP libname ( (options ••• [) ]] r , ITFRM , , IPRINTI L .I ______ -.:.1 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
DEL COMP replaces existing members in a macro library.
deletes members from a macro library. If more than one member
exists with the same name, only the first entry is deleted.
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. Ii bname is the filename of a macro library. If the file
exists, it must have a filetype of MACLIB; if it
created, it is given a filetype of MACLIB.
already
is being
fn 1 [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, SO-character
records.
me mbername 1 [ membername2 ••• ]
are the names of the macros that exist in a macro library. QpiiQn§: 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.
TERM displays the MAP output at the terminal. 130 IBM VM/370 CMS Command and Macro Reference

PRINT writes the MAP output on a
identifier of "libname MAP Al". already exists, the old file is
specified, DISK is the default. MACLIB CMS disk with the file
If a file with that name
erased. If no option is
writes the file "libname MAP Al" to your A-disk and
spools a copy to the virtual printer.
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, ea=h macro must be preceded by a control statement of the following
forma t: *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 1* 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, OSMACRO, OSMACR01, TSOMAC, and DOSMACRO. 5. The TERM or PRINT options will erase the old MAP file, if one
exists. 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 Section 2. CMS Commands 131