124 IBM VMj370 Service Routines program Logic
Chapter 7. Procedures for Generating and
Updating VM/370
Introduction
TheV!/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 suppliedfor assembling the updated source code to produce a uniquely defined text deck. The
deck has a unique name andsome 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 andany updates
applied.
Procedures are provided for generating
load filesfrom various object modules, and
for generatingMICLIB files from various COpy and 8ACRO files.
The procedure for updatingV8/370 has a
file naming convention for update and text
files, a set ofprograms to support the
processing, and a set ofEXEC procedures
and modulesto 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
filemust be the salle name as the file to
te updated. For instance, the filePROGRAM ASSEMBLE could be updated by the file PROGRAM UPDTGN30 or the file PROGRA! UPDTGC61. The creation and use of update files are
described in theUPDATE command discussion
in theV!!Ll1Q: £ommand TXT FILES Text files are produced by the assembler as
a part of theV!FASe procedure. The
filenameof the text file is the same as
the filename of theISSE!ELE file. The
filetype of thecompleted 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 ofthe files used. The auxiliary
file is called 'filenameUPDATES' and is
producedty a program called VMFDATE. The
filename is thesame 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 tobe 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
fieldsnamOO, nam01, nam02, na1l03, and nam04 are update level The first record is the !AeS record that
defines themacro libraries (maclib1
maclib2••• ) to te used in the assembly in
the order of search required. up tc five
librariesmay be specified.
Records 2, 3, and 4 are update
identification records. They define theUPITxxxx files that were created (via
update control cards and source statements)
to updatesome particular file. Record 2
defines aUPDTup1 file, and records 3 and 4
defineUPDTup2 and UPDTup3 updates,
Chapter 7. Procedures for Generating andUpdating 125
Updating VM/370
Introduction
The
updating of files with several levels of
updates and any number of program temporary
fixes
statement files, procedures are supplied
deck has a unique name and
cards to identify the origin of the
updates, macro libraries, and source
statements. For macro library files, a
copy file is
origin of the input and
applied.
Procedures are provided for generating
load files
for generating
The procedure for updating
file naming convention for update and text
files, a set of
processing, and a set of
and modules
standalone card deck on disk.
macro library.
unique
file
te updated. For instance, the file
described in the
in the
a part of the
filename
the filename of the
filetype of the
'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
file is called 'filename
produced
filename is the
specify various combinations of updates and
macro libraries to
must have a filetype of CNTRL. These
control files contain records in the
following format:
are
fields
defines the
maclib2
the order of search required. up tc five
libraries
Records 2, 3, and 4 are update
identification records. They define the
update control cards and source statements)
to update
defines a
define
Chapter 7. Procedures for Generating and