Vl'IFASl'I VMFASM Use the Vl'IFASM EXEC procedure to
according to entries in a control
source file. VMFASM invokes the Cl'IS command is:
update a specified source file
file, and to assemble the updated UPDATE command. The format of the r I VMFASl'I I I , I I I I I L
fn
ctlfile
fn ct lfile ( (options ••• ( ) ]] Q£iion.§: r , r , r , ,DISK I ITERM I I I REI!! I IBQTERl'I1 INOLISTI L J L J L J r , r , ,DECK I I RENT , (EXP] (XREF] • .:..:..;:...:::...::..;..:..; l • 1 L J L J is the filename of the source file to be upda ted. It must
have a filetype of ASSEMBLE. is the filename of the control file. The control file must
have a filetype of eNTRL. Vl'IFASM only accepts the nondefaulted options. All other
assembler options entered are ignored and the defaults are used. DISK TERM NOIERM NOLIST DECK !Q:QECK RENT
places the listing file on a virtual disk.
writes the listing file to the printer.
writes the diagnostic information on the SYSTERM data set. The
diagnostic information consists of the diagnosed statement
followed by the error message issued.
suppresses the TERM option.
produces an assembler listing.
does not produce an assembler listing.
writes an object module on the device specified on the FILEDEF
statement for PUNCH. suppresses the DECK option.
checks the program for a possible violation of program
reenterability. Code that makes the program nonreenterable is
identified by an error message.
suppresses the RENT option. EXP expands printing of certain macros which check for the SUP parameter issued via the SYSPARM option of the ASSEl'IBLE command. The default is SUP. 384 IBM Vl'I/370 Planning and System Generation Guide

XREF Page of GC20-1801-10 As Updated April 1, 1981 by TNL GN25-0837 VMFASM causes the XREF(FULL) option to be invoked when VMFASM invokes
the assembler. The default for VMFASM is XREF(SHORT) • The steps taken by the VMFASM EXEC are summarized below.
1. The VMFASM EXEC calls the UPDATE command with the CTL, STK, and
PRINT options. UPDATE uses the control
assembler language source ASSEMBLE. file (ctlfile CNTRL) to
file. The ne w file is
update
named
the
$fn UPDATE stacks information from the
stack, and prints the update log file.
file in the console
2. Using the library list from the MACS record in the control file, VMFASM issues a GLOBAL MACLIB command.
3. The" updated source file, $fn ASSEMBLE, is assembled using the
options indicated on the VMFASM command line.
4. The output text deck from the assembly, $fn TEXT, is concatenated
with the UPDATES file so that the text deck contains a history of
update activity.
5. Using the update level identifier from the control file (the
identifier of the most recent update that was found and applied is
stacked by the UPDATE command), VMFASM determines how to rename $fn TEXT. If the update level identifier is TEXT, the text deck is renamed fn TEXT. If the update level identifier is anything other than TEXT, the
text deck is renamed fn TXTxxxxx, where xxxxx is the one-to
five-character update level identifier and fn TEXT is erased from
the A-disk.
6. Temporary files ($fn ASSEMBLE, fn UPDATES, and fn ctlfile) are
erased.
The input and output files used by VMFASM are summarized below.
fn ASSEMBLE ctlfile CNTRL Assembler Language source
control file MACLIBS, auxiliary control files (AUXxxxxx), and miscellaneous
update files.
DI SK OUTPU1 FILE.a.l fn {TEXT } TXTxxxxx object deck, named according to
the update level identifier in the
control file
This file also contains data from the UPDATES file, together with
date and time information. Part 5. Updating VM/370 385