PURGE

CMS Commands

purge.helpcmd.txt
PURGE                                                    CP Privilege Class:  G

Use the PURGE command to remove your own closed spool files from the system
before they are printed or punched by the spooling devices, or before they are
read by a user.  The format of the PURGE command is:
+----------+------------------------------------------------------------------+
| PURge    | Reader|Printer|PUnch|ALL [ALL|CLass c...|spoolid...]             |
+----------+------------------------------------------------------------------+
where:

Reader | RDR
         purges reader files.

Printer | PRT
         purges printer spool files.

PUnch | PCH
         purges punch spool files.

ALL      purges all reader, printer, and punch spool files.  When ALL is
         specified instead of a device type, all other operands are ignored.

CLass c...
         are the class(es) of files to be purged.  CLASS is a required reserved
         word and c... are one-character alphameric fields (with values from A
         to Z and 0 to 9) that represent spooling classes.

spoolid...
         are the spoolids of one or more specific files to be purged.

ALL      purges all files of the specified type (reader, printer, or punch).

Note:  A combination of CLASS and spoolid specifications may be entered.


Usage notes:

1.  You can purge any closed spool file you own, regardless of its status, as
    long as CP has not selected it for processing.

2.  You can purge files using a combination of CLASS and spoolid
    specifications.  For example:
       purge printer class A 1951 class D 619
    specifies that CP should purge all class A and class D printer files and
    printer files with spoolids of 1951 and 619.

3.  You cannot purge any file you spool to the reader of another user unless
    you first reclaim it using the TRANSFER command.

Response:

nnnn ¦ NO FILES PURGED
   indicates the number of files purged.  This response is not displayed if you
   issued the CP SET IMSG OFF command.