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

VMFASM $fn LISTING Assembler listing (if PRINT option is in effect)
This file also contains data from the update log file (fn UPDLOG), describing the updates applied to the source file.
Note: If the object modules created have a filetype of "TXTxxxx" and are
to be used with one of the GEN EXECs (CMSGEND, DOSGEN, VSAMGEN, etc.), they must be renamed with a filetype of "TEXT". The UPDATE command issues the message DMSUPD178I to indicate each of the
update files being applied. ASMBLING fn
indicates that the assembly is going to begin.
any assembler option on the VMFASM command line,
are also displayed.
fn {TEXT } TXTxxxxx CREATED
If you specified
the options used
indicates the filename and filetype of the text deck.
*** fn ASSEMBLE NOT FOUND ***
The source file could not be located.
*** ctlfile CNTRL NOT FOUND ***
The control file could not be located.
*** ERROR UPDATING fn ***
An error occurred during UPDATE command processing.
*** ERROR ASMBLING fn ***
An assembler error occurred.
*** NO TEXT FOR'fn ***
No TEXT file was produced, because of assembler errors.
386 IBM VM/370 Planning and System Generation Guide