Introduction
Introduction VM/370 provides you with several procedures and techniques for updating
your VM/370 system. Using a virtual machine, you can perform updating
and maintenance tasks concurrently with other production work. The
framework provided by VM/370 gives you a maximum amount of flexibility
in maintaining your system. This framework includes: • A recommendation for a system support plan, with a userid KAINT provided with access to minidisks containing files necessary for
system updating and maintenance. • A monthly system Program Update Tape (PUT) is automatically
distributed to VK/370 users. This tape contains updated TEXT and MODULE files, as well as PTFs (Program Temporary Fixes) that may be
applied to your VM/370 system. • The UPDATE command and two EXEC procedures, VKFASM and VMFMAC, which
allow multilevel updating capabilities with concomitant multilevel
backup. • Naming conventions for update files and control files. • Several EXEC procedures and programs that simplify updating VM/370. These programs are listed in Figure 33.
All of these techniques require the use of CKS; you should have a
thorough understanding of the CMS file system and disk search order, the CMS EXEC processor, and the UPDATE command before you attempt to use any
of the procedures described here.
The provides complete tutorial information on CMS; for reference material on CMS commands and EXEC control statements,
see VML170 £Q!!.!!ang ang Reference.
Decidin-g Which Procedure To Use When you have a maintenance task, you want to accomplish
as possible without excessive delay or unnecessary steps.
types of maintenance, and each has one basic procedure.
it as quickly
There are two
Text level maintenance is available with the system PUT distributed
by IBM. When you use this type of maintenance, you do not have to worry
about which procedures to use. The user memo always tells you what to
do. Existing TEXT and TXTAP files for your VM/370 system are replaced,
on a one-for-one basis, by new files contained on the system PUT. The second type of maintenance involves more work on your part. If
you have updates that you want to apply to IBM modules (for example, if
you have written an accounting routine you want to include in the DMKACO module), use the following procedures:
1. If an update is being made to a macro library, use the VMFKAC EXEC to update the library.
Part 5. Updating VK/370 319

Introduction
r I I , , L
Program VMSERV VMFASM VMFMAC VMFLOAD GENERATE
comments Updates CP, CMS, RSCS, and IPCS from the system Program Update Tape (PUT). Text decks supplied with the service
tape replace existing text decks. Updates a source file using IBM updates and PTFs and user
updates, then assembles the updated source file. Updates macro libraries using IBM and user updates.
creates a new CP, CMS, or RSCS nucleus based on a control
file and a load list EXEC file. Performs a variety of maintenance functions, including
directory and service program updates. May also be
used to invoke the VMFLOAD program to punch a new CP, CMS, or RSCS nucleus. CMSGEND Creates a new CMS command module from updated TEXT files. ASMGEND Updates the VM/370 system assembler. VSAMGEN Updates and rebuilds the CMSVSAM and CMSAMS discontiguous
saved segments based on PTFs to VSAM code. UPDATE Applies single or multilevel updates to source programs.
Figure 33. Programs for Updating VM/370 2. Use the VMFASM EXEC procedure to reassemble the source module using
update files. These may be IBM PTFs or updates or your own. If
you are reassembling a module because of a MACLIB change, no update
files are necessary.
3.
4. Use the VMFLOAD program to punch a
incorporating existing TEXT files VMFASM EXEC. new CP, CMS, or RSCS nucleus,
and new ones created by the
Depending on whether you are creating a new CP, nucleus, you may next have to perform additional
writing the new nucleus onto disk, and so on. CMS, or
steps, RSCS like
The various procedures and steps to take are summarized in Figure 34.
These procedures are described in detail in the remainder of Part 5.
Before you use any of the procedures, you should have established a
virtual machine userid for your maintenance tasks. You must also be
acquainted with the CMS files that are used for updating and the naming
conventions used by IBM. These topics are discussed next. 320 IBM VM/370 Planning and System Generation Guide