8. INSTALLATION AND MAINTENANCE › 8.3 Maintenance › 8.3.1 Overview, Maintenance Installation Procedure

8.3.1 Overview, Maintenance Installation Procedure

VM Data Transfer Program modules reside and operate in both
MVS and VM.  When changes are made to any part of the program
at the central location, these changes may require concurrent
changes at the VM site(s), and vice versa.  Therefore, it is
important that maintenance to the VM Data Transfer Program be
carefully coordinated.

Maintenance is delivered to the MVS central site through the
CA MICS Product Support Program (PSP), which loads the code
changes to the PSP libraries.  These changes are then applied
to the CA MICS complex libraries. Once this is done, the
change source modules are sent to the VM sites on tape or via
NJE from the MVS central site.

At the VM system, source code replacements are loaded on
the installation minidisk.  Then, a code regeneration
activates the changes.


DELIVERED FILES

All executable files and parameter lists are delivered as
card image files (80-column, fixed length records).  Each CMS
file that contains executable code or provides parameters has
an entry in a command generation list which provides the
command sequence necessary to make the command functional.
All static code is generated at installation time by VMTGEN
EXEC from commands provided by the command generation list.
The lists provided with the VM Data Transfer Program are:

    VMTGENS GENLIST - containing system code generation
                      instructions

    VMTGENU GENLIST - containing tailorable code  generation
                      instructions

The file types of the executable files delivered are:

    $EXEC    - converted to EXEC by EXECUPDT

    $XEDIT   - converted to XEDIT by EXECUPDT

    ASSEMBLE - converted to TEXT by the assembler, and MODULE
               by GENMOD

    $MAIHLP  - converted to CMS HELP files by HELPCONV

    $SCREEN  - converted to SCREEN files by VMTUPD

Some utilities in the tool kit which are used by VMTGEN to
assemble programs, create macro libraries, edit the delivered
files, and create updates.  These utilities are:

    VMTXED   - to edit a file

    VMTASM   - to assemble a program

    VMTMAC   - to generate a macro library

    VMTHLP   - to generate a HELP file

    VMTUPD   - to apply updates to a file

These functions are detailed separately in Section 10.4.


CONTROL FILES

All tool kit utilities permit specification of a control
file.  The default is VMTCTL CNTRL.  The control file
identifies the change set structure and the macro library
concatenation sequence used when assembling programs.  (Refer
to the CMS UPDATE command in the IBM CMS Command and Macro
Reference for further information.) You may use another
control file, modeled after the one provided, to implement
changes using your installation's naming standards.