VMSERV 1. PROGID is a positional parameter which is valid only if you specify RESTART or BUILD. 2. The parameters that are separated vertically are mutually
exclusive. They cannot be specified at the same time. For
example, specifying BUILD and NOIPL is not allowed.
3. If you are using SIPO (System Installation Productivity Option), refer to the VM System IPO Extended Planning Guide, Order No.
GC20-1874. HOW VMSERV WORKS The PUT is composed of two or more virtual tapes stacked sequentially.
Each virtual tape contains the service for product. The first
virtual tape on the PUT contains the service for the VM/370 System Control Program (SCP). The VMSERV EXEC is included in file one along
with the SCP service installation EXEC (5749010) and the program level
file. Assuming you need a new map of the PUT, certain housekeeping
functions are performed. VMSERV erases work EXECS PTFLVL and PTFMEMO, and issues a CP REWIND and VMFPLC2 FSF in an attempt to insure this is
the correct tape. VMSERV then initializes the EXECs necessary to print
the Memo-to-Users and user memos. The tape is rewound and VMFPLC2 looks
for space on an A-disk on which a TAPE MAP can be written. A TAPE MAP is created for files one and two. Any selective-load EXECs that may
have remained from the last PUT are erased and the new service EXECs are
created. A line of data is printed to the console to indicate where you
are in the procedure and the remaining virtual tapes are skipped. VMSERV offers to print the PUT DOCUMENT and the Memo-to-Users, reminding
you to review the memos prior to installing service. You are also
reminded of the NOIPL option of VMSERV, and since you probably have not
reviewed the memos at this point, VKSERV exits. Specify RESTART to
apply service to this product. VMSERV invokes the service (progid) EXEC with the applicable parameters that you entered when you invoked VMSERV. After the service for all the desired products is installed, VKSERV types the SERVICE DISKMAP to the console to show the service status of
all the products on the tape. I INITIALIZATION MESSAGES Several messages may be issued to you during the application of service.
The messages both normal and error that VMSERV issues are documented
here. VKSERV MUST BE RUNNING FROM YOUR 'C' DISK. PLEASE REVIEW THE INSTALLATION INSTRUCTIONS CONTAINED IN THE PLC'S COVER LETTER.
Return code: 4
Issued if the VKSERV EXEC is not running from the 'C' disk. Part 5. Updating VM/370 395

VMSERV OPTION CONFLICT EXISTS. PLEASE RE-ENTER
Return code: 4 Issued for conflicting parameters issued on the command line: Such
as 'BUILD' and 'NOIPL'. You should review the PUT DOCUMENT and
re-enter the command properly. UNKNOWN OR INCOMPLETE OPTION SPECIFIED. PLEASE RE-ENTER
Return code: 4 You have invoked VMSERV with misspelled or incorrect parameters. You must re-enter the command correctly.
THE SECOND PARAMETER ENTERED MUST BE THE PROGRAM NUMBER AT WHICH YOU WISH SERVICE INSTALLATION TO 'RESTART'. ENTER: VMSERV RESTART
prog
Return code: 4 You have requested a 'RESTART' but have not indicated which service EXEC you wish to restart.
ENTER THE PROGRAM NUMBER YOU WISH TO BUILD OR 'EXIT'. Return code: none -no exit You have requested 'BUILD' but specified no progid to invoke. You should respond with the program number you wish to 'BUILD', or you
may enter 'EXIT' to terminate VMSERV. progid EXEC NOT FOUND. RE-ENTER IF TYPING ERROR. OR ENTER 'EXIT' IF YOU NEED TO RE-START.
Return code: none -no exit You have incorrectly specified the progid to 'BUILD'. You may
re-enter the progid or enter 'EXIT' to terminate VMSERV. VMSERV WILL NOW MAP THE PUT. PROCESS WILL TAKE A FEW MINUTES Return code: none -informational
Followed by the typing of the first line of the 'program level'
files as they are read from the PUT. This file contains the
official name of that particular (program) product. YOU SHOULD REVIEW THE KEMOS-TO-USERS PRIOR TO INSTALLING SERVICE WOULD YOU LIKE THE 'MEMO (S)-TO-USERS' PRINTED? ( -YES- , NO )
Return code: none -procedural question 396 IBM VM/370 Planning and System Generation Guide