124 IBM VMj370 Service Routines program Logic

Chapter 7. Procedures for Generating and
Updating VM/370
Introduction
The V!/370 update facility provides for the
updating of files with several levels of
updates and any number of program temporary
fixes (PTFs). For Assembler language source
statement files, procedures are supplied for assembling the updated source code to produce a uniquely defined text deck. The
deck has a unique name and some control
cards to identify the origin of the
updates, macro libraries, and source
statements. For macro library files, a
copy file is to identify the
origin of the input and any updates
applied.
Procedures are provided for generating
load files from various object modules, and
for generating MICLIB files from various COpy and 8ACRO files.
The procedure for updating V8/370 has a
file naming convention for update and text
files, a set of programs to support the
processing, and a set of EXEC procedures
and modules to process the files. • The VMFASM procedure incorporates PTFs or updates. • The GENERATE procedure generates a new
standalone card deck on disk. • The VMFLOAD module generates a new CP, CMS, or RSCS nucleus. • The VMFMAC procedure generates a new
macro library. UPDATE FILES Files used to update another file are a filetype of UPDTxxxx, where XXXX 1S a
unique for programmer and system use. The filename of the update
file must be the salle name as the file to
te updated. For instance, the file PROGRAM ASSEMBLE could be updated by the file PROGRAM UPDTGN30 or the file PROGRA! UPDTGC61. The creation and use of update files are
described in the UPDATE command discussion
in the V!!Ll1Q: £ommand TXT FILES Text files are produced by the assembler as
a part of the V!FASe procedure. The
filename of the text file is the same as
the filename of the ISSE!ELE file. The
filetype of the completed text deck is TXTnamex, where 'namex' represents a unique YEgate level identifer. The value of
'namex' is taken from a control file, and
corresponds to the highest level of update
applied. In addition, the text deck is
produced from a combination of the
assembler text deck and an auxiliary
control file containing data describing the
origin of the files used. The auxiliary
file is called 'filename UPDATES' and is
produced ty a program called VMFDATE. The
filename is the same as the filename of the UPITxxxx file. CONTROL FILES Each user may have several control files to
specify various combinations of updates and
macro libraries to be used. A control file
must have a filetype of CNTRL. These
control files contain records in the
following format: namOO !!ACS maclib1 aaclib2 ••• iiall01 UPDTup1 na.02 UPDTup2 iiai03 UPDTup3 na.04 lUXxxxxx The suffixes up1, up2, up3, and xxxxx
are identifier fields, and the
fields namOO, nam01, nam02, na1l03, and nam04 are update level The first record is the !AeS record that
defines the macro libraries (maclib1
maclib2 ••• ) to te used in the assembly in
the order of search required. up tc five
libraries may be specified.
Records 2, 3, and 4 are update
identification records. They define the UPITxxxx files that were created (via
update control cards and source statements)
to update some particular file. Record 2
defines a UPDTup1 file, and records 3 and 4
define UPDTup2 and UPDTup3 updates,
Chapter 7. Procedures for Generating and Updating 125