File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-149
PURGE Guidelines
[NO] LISTALL
specifies whether to list the names of all files as they are purged. The listing is:
$volume.subvolume.file-id PURGED.
LISTALL is the default in interactive mode. The default for noninteractive mode is
NO LISTALL.
If you include this option, you must enclose fileset-list in parentheses even if
the list contains only one file. If you omit the parentheses, FUP treats LISTALL or
NO LISTALL as file names.
If you omit the parentheses and specify NO LISTALL, FUP returns a required
delimiter is missing error message. If you omit the parentheses and specify
LISTALL, FUP searches for a LISTALL file in the current default subvolume. If no
file with that name exists, it returns file-system error 11 (file not in directory).
PARTONLY
purges only the specified partition for a partitioned file.
If you include this option, you must enclose fileset-list in parentheses even if
the list contains only one file. If you omit the parentheses, FUP treats PARTONLY
as a file name.
This option is not valid for any Enscribe object. If you use PARTONLY for Enscribe
objects, PURGE terminates abnormally (ABENDs) with an error.
PURGE Guidelines

If you try to purge a file that has transaction-mode record or file locks pending and
it is audited by TMF, the purge request fails with file-system error 12 (file in use).
Even if the processes that opened the file no longer exists, the file-system error still
occurs.

PURGE cannot dispose of SQL files that are not SQL object files. Instead, you
must use SQLCI PURGE.

For objects compiled by SQL, PURGE displays error 197 (an SQL error has
occurred).

You can purge a file only if it is not in use (that is, it cannot be open, running, or
undergoing a backup process). You also must have purge access or be logged on
as the super ID (255,255).

If you try to purge a file before its expiration date (NOPURGEUNTIL attribute), an
error occurs. To alter the expiration date, use the ALTER command.

If you purge a file that has the CLEARONPURGE option set (for more information,
see SECURE on page 2-172), the disk process physically deletes the file data from
the disk (overwrites it with blank data) and then deletes the file name from the
directory.