Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-269
PURGE Procedure (Superseded by FILE_PURGE_
Procedure )
PURGE Procedure
(Superseded by FILE_PURGE_ Procedure
)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Safeguard Considerations
OSS Considerations
Example
Summary
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
Parameters
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
[0:3] $
volname (blank-fill)
or
\
sysnum volname (blank-fill)
[4:7]
subvol-name (blank-fill)
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.
CALL PURGE ( file-name ); ! i