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

UPDATE When the STK option is specified, UPDATE stacks the following data
lines in the console stack: first line: * update level identifier
second line: * library list from record The update level identifier is the identifier of the most recent update
file that was found and applied. For example, if a control file
contains TEtT MACS CMSLIB OSMACRO OFA UPDTOFA PFA UPDTOFA and the UPDATE command appears in an EXEC as follows: UPDATE SAMPLE (CTL STK &READ VARS &STAR &TEXT &READ VARS &STAR &LIB1 &LIB2 &LIB3 &LIB4
then the variable symbols set by the &READ VARS statements have the
following values if the file SAMPLE UPDTOFA is found and applied to the
file ASSEMBLE: &STAR &TEXT &LIB1
&LIB2
&LIB3 &LIB[J * OFA CMSLIB OSMACRO TESTMAC null
The library list may be useful to establish macro libraries in a
subsequent GLOBAL command within the EXEC procedure. If no update files
are found, UPDATE stacks the update level identifier on the MA:S record.
FILE 'fn ft fm,' REC #n = update control statement
This message is displayed when the TERM option is specified and an
error is detected in an update file. It identifies the file and
record number where the error is found. DMSUPD177I WARNING IGNORED. ] MESSAGES ISSUED (SEVERITY=nn). [. REP' OPTION Warning messages were issued during the updating process. The
severity shown in the error message in the "nn" field is the
highest of the return codes associated with the warning messages
that were generated during the updating process.
The warning return codes have the following meanings:
RC = 4; Sequence errors were detected in the original source file
being updated.
RC = 8; Sequence errors, which did not previously exist source file being updated, were introduced in the output
during the updating process.
in the
file Section 2. CMS :ommands 211