z/VM: CP Commands and Utilities Reference - z/VM - IBM

SAVESYS
►►
SAVESYS
Authorization
Purpose
Operands
name
Usage Notes
Privilege Class: E
SAVESYS
Use SAVESYS to save a named saved system (NSS) into a previously defined
system data file (SDF).
name
is the name of the NSS to be saved. This is the file name of a class S
(skeleton) system data file previously defined with the DEFSYS command.
1. CP can process only one DEFSYS or SAVESYS command for a particular
name at any given time. If CP is already processing a DEFSYS or SAVESYS
command, a subsequent DEFSYS or SAVESYS request for the same name is
delayed.
2. You can interrupt and end a SAVESYS operation before it completes by using
the PURGE NSS command. This will not leave a partially-saved system data
file on the system. The skeleton system data file will be purged and must be
redefined before the named saved system can be resaved.
3. After the execution of this command, the system data file is designated class A
or class R. Class A indicates that it is in the unrestricted available state, and
may be accessed by any user. Class R indicates that the NSS is restricted and
the users must have a NAMESAVE statement for the NSS in their directory
entries in order to load it.
4. Only one available NSS (Class A or R) with a particular name may exist at a
given time. If any Class A or R NSS already exists with the same name as the
one being saved, and there are no virtual machine users associated with the
NSS, then the old copy of the NSS is purged and the new one is made
available.
If there are users associated with the old copy and neither the old copy nor the
new copy of the NSS is a CP system service NSS (that is, no page ranges
were defined with the SC page descriptor code), the old copy is marked as
pending purge, and the new copy is saved. Any users associated with the old
copy continue to reference the old (now pending purge) NSS. Subsequent
users are associated with the new copy.
If there are users associated with the old copy and either the old copy or the
new copy of the NSS is a CP system service NSS (that is, one or more page
ranges were defined with the SC page descriptor code), the SAVESYS
command is not accepted.
5. If there is a CP NSS with the specified name that is class P pending purge
(the PURGE NSS command was used to purge it while there were users
associated with it), the same rules apply as described in 4:
►◄
Chapter 2. CP Commands 1181