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

Responses
Messages
3. The PURGE NSS command interrupts an in-process SAVESEG or SAVESYS
operation to purge the saved segment or named saved system before the save
completes. 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
saved segment or named saved system can be resaved.
4. In response to the PURGE command, CP purges the designated files unless
the files are currently in use. If a file is currently in use, CP places it in a
pending purge state (class P), and purges it as soon as it is no longer being
used or the system is shut down or re-IPLed. If the file being purged is a
member of a segment space, the system places it in pending purge status if any
user is accessing any member of the segment space. The system purges the
member when the segment space is no longer in use.
5. If you do not specify ASSOCIATES and the target of the PURGE command is a
member saved segment, CP purges only that member. It does not purge any
other file, and it does not update any segment space descriptions. If the target
of the PURGE command is a saved segment, CP purges only the saved
segment. If the target of the PURGE command is a segment space, CP purges
only that segment space. It does not purge any other file, and it does not
update members of that segment space.
6. To determine if a file is in a pending purge state, enter the QUERY NSS
command. If the file is in a pending purge state, the CP response shows that
the file as class P.
Response 1:
{nnnn} FILE(S) PURGED
{ NO}
displays the count of files purged.
nnnn
indicates the number of files purged.
Response 2:
{nnnn} FILE(S) PENDING PURGE
displays the count of files waiting to be purged.
nnnn
indicates the number of files to be purged when they are no longer in use.
For example, when five NSS or saved segment files exist and two are in use, and
you enter purge nss all, the responses are:
0003 FILES PURGED
0002 FILES PENDING PURGE
HCP003E Invalid option - {option|command
contains extra option(s) starting with
option}
HCP008E Invalid spoolid - spoolid
HCP026E Operand missing or invalid
PURGE NSS
HCP042E User userid spoolid nnnn does not exist
HCP423E The function requested is incompatible
with a previously specified operand.
HCP1001E An operand is missing for option.
Chapter 2. CP Commands 663