HP 3000 Manuals

HP 3000 Series 9X8LX Computer Systems Commands Reference

PURGE 

This command deletes one or more files from the system. 

Syntax 

PURGE filereference[;TEMP]

Parameters 

filereference         The actual file designator of the file to be
                      deleted, interpreted according to MPE-escaped
                      semantics filereference, can be either an MPE file
                      (i.e., one that uses MPE syntax) or it can be a
                      POSIX file name beginning with a dot or a slash.
                      For example, you can use the escaped pathname
                      /SYS/PUB/FILE since it is equivalent to the MPE
                      name FILE.PUB.SYS.

TEMP                  Specifies that the file is a temporary file in the
                      job/session temporary file domain.  You can specify
                      a filename in MPE or HFS syntax and may name a
                      symbolic link that resolves to a filename.  You
                      must enter this parameter to delete a temporary
                      file.  The default is that a permanent file is
                      assumed.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break does not affect this command.

       You must have write access to a file to delete it.

   *   Purging unrecognized files 

       If the file does not exist in the specified domain, the following
       message appears:

            FILE filename NOT FOUND, NO PURGE DONE. (CIWARN 383)

   *   Purging non-private spool files 

       You can purge a non-private spool file by entering PURGE filename.
       You must specify the fully qualified file name (including
       .OUT.HPSPOOL). The PURGE command deletes the specified spool file
       and all links to the spool file directory.  The spool file does
       not print after you purge it.

   *   Purging files with wildcards 

       You can use wildcards to remove multiple files at once.  You can
       also use the options provides to prevent accidental deletion of
       one or more files.  Examples of the wildcard feature are listed in
       the Examples section below:

Examples 

   *   To delete a permanent file named PFILE, enter:

            :PURGE PFILE 

   *   To purge multiple files using wildcards

            :PURGE /users/jeff/bin/FILES/file@ 
            3 FILES matched
            Continue PURGE? (YES/NO) yes
            3 selected.  3 succeeded.  0 failed.

   *   To purge multiple files interactively using wildcards

       To purge a number of files, one at a time, in an interactive mode
       so that you can skip a file or stop your purge, you can use the
       CONFIRMALL option.

            :PURGE /users/jeff/bin/FILES/file@; CONFIRMALL 
            3 FILES matched
            /users/jeff/bin/FILES/file1 ? (NO/YES/QUIT) yes 
            /users/jeff/bin/FILES/file2 ? (NO/YES/QUIT) no 
            /users/jeff/bin/FILES/file3 ? (NO/YES/QUIT) yes 
            2 selected.  2 succeeded.  0 failed.

       Type "q","quit", or press the BREAK key if you decide to stop the
       PURGE command completely.

   *   To purge log files using wildcards

       The following example shows you how to purge all log files within
       your current working directory that start with log, followed by
       any number from 0 - 9 (#), followed by any number of alphanumeric
       characters (@).

            :PURGE log#@ 
            10 FILES matched
            Continue PURGE?  (YES/NO) yes 
            10 selected.  9 succeeded.  1 failed.

       Since the PURGE command does not remove the currently opened log
       file, the command always returns "1 failed".

Related Commands 

     ALTSEC
     BUILD
     LISTFILE
     LISTSPF

MPE/iX 5.0 Documentation