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

PURGE IMG
PURGE IMG
►►
PURge
Authorization
Purpose
IMG
Operands
Usage Notes
Responses
ALL
▼
spoolid
NAME fn
Privilege Class: A, B, C, D, E
Use PURGE IMG to remove system data files containing image libraries.
ALL
lets you purge all image library files.
spoolid
identifies the number used to identify the file or files to be purged.
NAME fn
identifies the file name of the file or files to be purged.
1. SET IMSG OFF suppresses informational messages for this command.
2. Any combination of spoolid and NAME may be specified on the PURGE IMG
command line. For example, purge img 1234 name imag3800 3421 purges IMG
files 1234 and 3421, and any IMG files with the file name IMAG3800.
3. 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.
4. To determine if a file is in a pending purge state, enter the QUERY IMG
command. If the file is in a pending purge state, CP’s response shows that the
file is 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
658 z/VM: CP Commands and Utilities Reference
►◄