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

PURGE
Usage Notes
Responses
Reader
RDR
Printer
PRT
PUnch
PCH
UR
indicates which spool file queue contains the files that you want to purge. UR
indicates that all reader, printer, and punch files are to be purged.
ALL
specifies that all files on the queue of the device type specified (READER,
PRINTER, PUNCH, UR) are to be purged.
CLass c
designates a spool file class where c is a 1-character alphanumeric field from A
to Z or 0 to 9. All the files of the specified class or classes for the specified
device type or types are purged.
DEST dest
purges all of the files with the specified destination value. The operand dest is
specified as one to eight characters long.
FORM form
purges all files with the specified form names or form numbers. The operand
form is specified as one to eight characters long. For the class G user, the form
is the user form name. For the class D user, the form is the user form name
when you specify * or default to your userid. Otherwise, the form is the operator
form number.
spoolid
purges the files of the specified spoolid, for the specified device type.
1. SET IMSG OFF suppresses informational messages for this command.
2. The class D user can use the PURGE command to purge any file in the system
by specifying the SYSTEM or userid option. For example, if you enter purge
system printer class c, you purge all class C printer files in the system,
regardless of who owns them or who originated them.
The class D user can use the userid option to purge any file or files that are
owned by a particular user. For example, if you enter purge genuser reader
all, you purge all reader files owned by the user ID GENUSER.
3. You can purge files using a combination of CLASS, FORM, DEST, and spoolid
on the same command line. For example, purge printer class a 1932 form
document class d 619 dest bldg1 specifies that CP should purge all the
command user’s class A and class D printer files, all the command user’s files
with form DOCUMENT, all the command user’s printer files with the destination
BLDG1, and the command user’s printer files having spoolids 1932 and 619.
4. If a command syntax error occurs when purging closed spool files from the
system, only the files encountered prior to the error are processed.
Response 1:
{nnnnnnn} FILE(S) PURGED
{ NO}
656 z/VM: CP Commands and Utilities Reference