HP 3000 Manuals HP 3000 Manuals
PURGE
Purges files that are owned by the current workspace.
Syntax
{filename1[version range] [,filename2[version range]]... }
PU[RGE] {@ }
{WORKSPACE[workspacename] }
Parameters
Filename Name of the file you want to purge. If there
is more than one file, they should be separated
by commas.
Version Range Takes the form: #n[/#n] or #@ where n is an
integer, L[ATEST], or R[EFERENCE]. @ = all
versions.
@ Purges all owned source files in the current
workspace.
WORKSPACE Indicates that an entire workspace is to be
purged. All versions of owned source files,
all listing files, the object file, program
file, the KSAM listing directory, and workspace
directory of the current or specified workspace
are purged. You will be prompted to confirm
the purge if this parameter is used.
Workspacename Allows you to specify the particular workspace
you want to purge. If you do not specify a
workspacename, the current workspace will be
purged. Do not give this parameter if the
workspace you are purging is your current
workspace.
Description
If any active and open workspace is accessing the file you want to purge,
you must wait until it closes the file. When a version is purged, that
version is, of course, unavailable for future referencing. If you
reference a purged version of a file, you will receive an error message.
Later versions of a file are unaffected by the purging of earlier
versions. If the latest version is purged, the records added in it are
deleted.
The number of active (non purged) versions of a file may be different
from the highest version number because some of the earlier versions may
have been purged. For example, if there were originally 10 versions of a
file, and version 2, 4, and 5 have been purged, there are 7 active
versions, though the latest version is #10.
Example
(1) >>PURGE MYFILE#3
Purges version 3 of MYFILE.
(2) >>PURGE MYFILE#@
Purges all versions of MYFILE and deletes it from the workspace
directory. It is the same as not specifying any versions.
(3) >>PURGE @
-->Purge all owned files? YES
Purges all owned files in the current workspace except the object file
and the program file. You will be prompted to verify the purge before
the files are actually deleted.
(4) >>PURGE WORKSPACE WW
-->Purge workspace WW?
All owned files, the object and program file for Workspace WW are purged.
File equations and directory listings are also deleted.