PURGE

Deletes one or more spool files from the system.

Syntax

   > P[URGE] {spoolfileid [,spoolfileid [,...] ]

              *

              {username[.acctname]

              seleq }  [ ;{ASK

                           YES} ] }

Parameters

spoolfileid

An existing spoolid to which the user has access. This parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn, where the n's represent digits. If the # is used, the O must also be used. If the O is used without the #, the parameter is interpreted as a user name and will probably cause an error.

*

The current spool file—one that has been explicitly TEXTed in, or that is current because it is the last spool file processed by the COPY, APPEND, or BROWSE command. If this form is used without a current spool file, an error message is displayed.

username

The name of a user on the system. Full MPE wildcarding is supported. This parameter, when used with the optional acctname, specifies the set of spool files to be purged. The SPIFF user must have access to files generated by username. Refer to “Security ”.

acctname

The name of an account on the system. Full MPE wildcarding is supported. Default: the logon account is assumed. This parameter, when used with the username, specifies the set of spool files to be purged. The SPIFF user must have access to files generated by users in acctname. Refer to “Security ”.




	NOTE: Because files in the CREATE state cannot be deleted, `SPIFF` inserts a `STATE <> CREATE` in its internal selection equation when processing a `username`[.`acctname`] specification.

seleq

A native mode spooler selection equation specifying the set of spool files to delete. The selection equation must be enclosed in brackets as in the following example that purges all spool files created by the user MANAGER.SYS with priority less than 3:

   PURGE [OWNER=MANAGER.SYS AND PRI<3]

If you choose this (seleq) form of file set selection, SPIFF inserts an OWNER=!HPUSER.!HPACCOUNT in its internal selection equation, unless you explicitly include your own OWNER definition. This prevents users with SM, OP, or AM capabilities from accidentally accessing files that they did not create.

Because files in the CREATE state cannot be deleted, SPIFF inserts a STATE <> CREATE in its internal selection equation even if you explicitly include your own STATE definition.

Consult one of the following documents for more information about selection equation syntax and semantics:

MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115)
MPE/iX online help facility

ASK/YES

Once purged, spool files cannot be recovered unless an archive copy has been made. These optional keywords provide an interactive precaution against unintended deletion of spool files. If either keyword is specified with the spoolfileid or with *, a warning is displayed and the keyword is ignored.

This parameter is in effect whenever SPIFF is run interactively.

Omitted

The user is presented with one list of all of the spool files selected for purging and is asked to approve the operation. This is an "all or nothing" choice. It is intended for users who are reasonably sure of the set of spool files to be deleted.

Responding Y[ES] purges all of the selected spool files.

Responding with N[O], E[ND], or CtrlY exits the command without deleting the spool files.

ASK

The user is presented with each spool file as it is encountered and is asked to approve the deletion.

Responding Y[ES] purges the spool file. Responding N[O] leaves the spool file unchanged.

Responding with E[ND], or CtrlY exits the command without deleting the spool file.

YES

SPIFF purges all of the selected spool files without confirmation from the user.

When SPIFF is run non-interactively, it is impossible to conduct a confirmation dialog. Examples of non-interactive operation include running SPIFF in a job or with redirected $STDIN or $STDLIST. In such cases, SPIFF operates as though YES had been specified.

Operation Notes

The PURGE command (abbreviated P) marks one or more spool files for deletion from the system, displaying identifying information (in LISTSPF format) for each marked spool file. The user may specify that SPIFF pause to confirm the deletion(s).

Note that spool files in the CREATE state (OPEN as displayed by SHOWOUT) cannot be purged.

If the spool file is your current text file, it will be closed. If you are the last (or only) accessor, the file is also purged at this time. If the spool file is currently opened by another process, it will not be purged until its last accessor closes it. The resulting display shows the spool file(s) in the DELPND state.

If the PURGE command has paused for a user response to any purge confirmation, entering CtrlY terminates the command without purging any more files.

Examples

Assume that spoolid's #O7788 and #O7789 exist, and that the user has access to them:

PURGE #O7788



SPOOLID    JOBNUM   FILEDES  PRI COPIES DEV      STATE  RSPFN OWNER



#O7788     S64      MYFILE     2      1 PP       DELPND       MYUSER.MYACCT



TEXT 7789

PURGE *



SPOOLID    JOBNUM   FILEDES  PRI COPIES DEV      STATE  RSPFN OWNER



#O7789     S64      MYFILE     2      1 PP       DELPND       MYUSER.MYACCT



PURGE *



You have no current TEXT file. (SPERR 81)

The following examples assume that you are MGR.ACCT (the manage of an account), and that you have AM capability.

> PURGE USER1.ACCT

  The following spoolfiles have been selected for purging:



SPOOLID       JOBNUM    FILEDES   PRI  COPIES DEV     STATE  RSPFN OWNER



#O452         J265      $STDLIST    2       1  PP     READY        USER1.ACCT

#O781         J518      $STDLIST    2       1  PP     READY        USER1.ACCT

#O779         J514      $STDLIST    2       1  PP     READY        USER1.ACCT

#O782         J520      $STDLIST    2       1  PP     READY        USER1.ACCT

#O784         J524      $STDLIST    2       1  PP     READY        USER1.ACCT



  Purge all spoolfiles shown (Y/[N]) Y



SPOOLID       JOBNUM    FILEDES   PRI  COPIES DEV     STATE  RSPFN OWNER



#O452         J265      $STDLIST    2       1  PP     DELPND        USER1.ACCT

#O781         J518      $STDLIST    2       1  PP     DELPND        USER1.ACCT

#O779         J514      $STDLIST    2       1  PP     DELPND        USER1.ACCT

#O782         J520      $STDLIST    2       1  PP     DELPND        USER1.ACCT

#O784         J524      $STDLIST    2       1  PP     DELPND        USER1.ACCT



> PURGE [(OWNER=USER2.ACCT) AND (PRI <=2)];ASK



SPOOLID       JOBNUM    FILEDES   PRI  COPIES DEV     STATE  RSPFN OWNER



#O557         J354      $STDLIST    2       1  LP     READY        USER2.ACCT

   Purge this spoolfile (Y/[N])? Y



#O569         J365      $STDLIST    2       1  LP     READY        USER2.ACCT

   Purge this spoolfile (Y/[N])? N

   Spoolfile not deleted  (SPWARN 228)



#O612         J394      $STDLIST    2       1  LP     READY        USER2.ACCT

   Purge this spoolfile (Y/[N])? Y



#O613         J394      $STDLIST    2       1  LP     READY        USER2.ACCT

   Purge this spoolfile (Y/[N])? E



>

PURGE

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Parameters

Operation Notes

Examples