Guardian Procedure Calls Reference Manual

PURGE Procedure (Superseded by FILE_PURGE_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Considerations
Safeguard Considerations
OSS Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The PURGE procedure is used to delete a disk file that is not open. When PURGE is executed, the
disk file name is deleted from the volume's directory, and any disk space previously allocated to
that file is made available to other files.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL PURGE ( file-name ); ! i
Parameter
file-name
input
INT:ref:12
is an array containing the internal-format file name of the disk file to be purged. To purge either
a permanent or temporary disk file, file-name must be of the form:
Permanent Disk File:
$volname (blank-fill)[0:3]
or
\sysnum volname (blank-fill)
subvol-name (blank-fill)[4:7]
file-id (blank-fill)[8:11]
Temporary Disk File:
$volname (blank-fill)[0:3]
or
\sysnum volname (blank-fill)
#temporary-file-id[4:11]
1186 Guardian Procedure Calls (P)