VMFMAC VMFMAC Use the VMFMAC EXEC procedure to update macro libraries. It invokes the CMS UPDATE command to update specified copy or macro files, according to
entries in a control file, and then builds a new macro library from the
resulting new versions of those files.
The format of the VMFMAC command is:
r ,VMFMAC ,libname ctlfile
L
libname
ctlfile
is the filename of the macro library to be updated, and of the EXEC file that contains the names of the library members. The
entries in libname EXEC must be in the following format:
&1 &2 fn1
&1 &2 fn2
where fnl, fn2, and so on, are filenames of macro or copy
files to be updated and included in the macro librarYr which
must have a filetype of MACLIB. is the filename of a control file to be used to apply the
updates. The filetype must be CNTRL. The filenames used by VM/370 are DMKRnO, DMSRnO, DMSMnO, DMTRnO, and DMMRnO. The steps taken by VMFMAC are summarized below. 1. VMFMAC locates libname EXEC and the control file. It also erases
any _existing files named NEWMAC MACLIB and NEWMAC COPY. Then VMFMAC begins reading the macro or copy filenames from the EXEC, beginning at the bottom.
2. For each entry in the libname EXEC, VMFMAC: Invokes the UPDATE command with the CTL option to apply the
updates specified in the control file.
Adds the updated macro or copy file ($filename MACRO or
$filename COPY) to the macro library NEWMAC MACLIB. !dds the UPDATES file created by the UPDATE command to the file NEWMAC COPY. Erases $filename MACRO or $filename COPY, and filename UPDATES. 3. If there are no update files for a macro or copy file specified in
libname EXEC, the macro or copy file is added to NEWMAC ftACLIB in
its current form. NEWMAC COPY, containing a history of updates
applied by VMFMAC, is added to NEWMAC MACLIB. Part 5. Updating VM/370 391

4. If no errors occur during the procedure, then when all the macros
have been added to NEWMAC MACLIB, NEW MAC MACLIB is renamed libname MACLIB. libname MACLIB, if it exists, is erased.
If errors occur during the VMFMAC EXEC procedure (for example, if a MACRO or a COpy file is not found) libname MACLIB is not erased,
and the updated macro library retains the name NEWMAC MACLIB. libname EXEC ct1fi1e CNTRL
contains a list of macro a copy file to be updated
and/or included in libname MACLIB. is the control file used by the UPDATE command. MACRO and
library,
files. COpy files to be updated and/or included in the macro
plus miscellaneous auxiliary control files and update
libname MACLIB 1ibname COpy is the updated macro library.
contains the UPDATES files produced by UPDATE command processing.
The printer is spooled with the CONT option, so that when VMFMAC completes, the printer file contains: • A copy of the control files • For each updated macro or copy file, the update log file
produced by the UPDATE command. • A copy of each macro or copy file is the macro library • The libname COpy file, which contains the accumulated UPDATES files created by the UPDATE command.
1. When files with MACRO fi1etypes are added to a MACLIB, the
membername is taken from macro prototype statement. When files
with COpy fi1etypes are added to a MACLIB, the membername is taken
from the filename of the COpy file, (which will be $fi1ename if
updates were found, otherwise filename) unless you include a *COPY statement as the first record in the file, in the format: *COPY membername
Then, the MACLIB directory uses membername to name the copy file.
2. If errors occur during VMFMAC processing, consult the 1ibname COpy file printed by VMFMAC. If you can correct the errors involving
one or two macro or copy files, you can add these members to NEWMAC MACLIB using the MACLIB command, then rename NEWMAC MACLIB to
1ibname MACLIB after erasing the current libname MACLIB. 392 IBM VM/370 Planning and System Generation Guide