r---------,
fn ASSEMBLE fn CNTRL fn UPDTABC fn UPDTIYZ fn AUXLIST L---------J fn FIIOl fn FIX02 update fn (ctl
r----------, I I , I I I I I L----------J
$fn ASSEMBLE fn UPDLOG fn UPDATES UPDATE fn fn CNTB1, fn fn tfn fn and in are used as described above, for "Multilevel Update," except that the CNTRL file contains: MACS CMSLIB TWO UPDTABC ONE UPDTXYZ TEXT AITXLIST !Q! in the filetype AUXLIST indicates that this is the filetype of an auxiliary control file that contains an additional list of updates. The
first three characters of the filetype of an auxiliary control file must
be the remaining character(s) (to a maximum of 5) may be anything. The filename must be the same as the source input file.
An auxiliary file may also be specified as:
xxxxx AUX in the control file. For example, the record: FIX TEST AUX identifies the auxiliary file fn AUITEST. Note that if you give an auxiliary control file the filetype AUXPTF, the UPDATE command assumes that it is a simple update file and does not
treat it as an auxiliary file. Also, if the update level identifier is PTF, the UPDATE command assumes a simple update file.
PREFERRED AUX FILE: A preferred AUI file may be specified. A preferred Aui-file-contains-the version of an update that applies to your version
of the source file. (There may be more than one version of the same
update if there is more than one version of the source file. For
example, you need one version for the source file that has a system
extension program product installed, and you need another version for
the source file that does not have a program product installed.) When you specify an auxiliary control file, you can specify more than
one filetype. The first filetype indicates a file that UPDATE uses only
on one condition: the files that the second and subsequent filetypes
indicate do not exist. If they do exist, this AUX file entry is ignored
and no updating is done. The files that the second and subsequent
filetypes indicate are preferred because, if they exist, UPDATE does not
use the file that the first filetype indicates. For example, assume
that the file 'fn ASSEMBLE' does exist. The control file MYKODS CNTRL: Section 2. CMS Commands 209

TEXT MACS MYMACS CMSLIB OSMACRO MY2 AUXTEST MYl AUXMINE AUXTEST and the command: UPDATE fn ASSEMBLE * MYMODS CNTRL (CTL
would result in UPDATE finding the preferred auxiliary control file 'fn AUXTEST', and therefore not using 'fn AUXMINE' to update 'fn ASSEMBLE'. UPDATE would then proceed to the MY2 AUXTEST entry and update 'fn ASSEMBLE' with the updates listed in 'fn AUXTEST.' It is assumed that AUXTEST and AUXMINE list similar but mutually exclusive updates. !he for a "preferred" auxfile will continue until one is found or
until the token is an invalid filetype; that is, less than four or more
than eight characters. This token and the remainder of the line are
considered a comment. EIXQl and EIXQ£ are update files containing UPDATE control
statements and new source records to be incorporated into the input
file. When update files are listed in an auxiliary control file, they
can have any filetype you choose but the filename must be the same as
the input file. The update files, as well as the AUI file, may be on any accessed disk. These are indicated in fn AUXLIST as follows: FIX02 FIXOl The updates are applied from the bottom of the auxiliary file. Thus, fn FIXOl is applied to the source file before fn FIX02. Since the auxiliary file is listed at the bottom of the control file, these
updates are applied before UPDTXYZ and UPDTABC. In addition to the MACS record, the
filetypes of update (UPDTl files, and the filetypes of auxiliary control files, a control file may also contain: • comments. These records begin with an asterisk (*) in column 1.
comments are also valid in AUX files. • PTF records. If the characters PTF appear in the update level
identifier field, the UPDATE command expects the second field to
contain the filetype of an update file. The filetype may be
anything; the filename must be the same as the source input file. • Update level identifiers not associated with update files. following example of a control file shows all the valid types of
records:
* Example of a control file ABC MACS MYLIB TEXT 004 003 002 001 PTF UPDTABC XYZ AUXLISTl LIST2 AUX TESTFIX QR1!QN: The STK (stack) option is valid only with the CTL option
and is meaningful only when the UPDATE command is invoked within an EXEC procedure. 210 IBM VM/370 CMS Command and Macro Reference