9 - purge file.
Usage:
mme gefsye
zero CC,ARGLIST
zero 9,BUFFER
Where:
- CC
- is either zero or a courtesy call address.
- ARGLIST
- points to a list of arguments for this call.
The format of this list is described below.
- BUFFER
- points to a buffer that can be used in this operation.
This buffer should be 355 words long.
Description:
This version of MME GEFSYE purges an existing file.
In a purge, the contents of the file are overwritten with zeroes, and then the
file is released.
The argument list indicated by ARGLIST has the form
zero RETURN_WORD,USERID
zero FILE_NAME,0
where
- RETURN_WORD
- points to two words where MME GEFSYE can return a status.
MME GEFSYE will initialize these words to zeroes.
When MME GEFSYE returns, the first word will contain
Bit 0 -- 1 to indicate completion
1-11 -- error code, or 0 for success
18-35 -- pointer to additional error info
(if any)
See "expl mme gefsye" for a list of common error codes.
- USERID
- points to two words containing the userid under which the program is operating
(in BCD characters).
- FILE_NAME
- points to an area of memory containing the name of the file to be purged.
This consists of four word chunks: the first two words of each chunk gives a
component of a pathname (first chunk the userid, next chunk the name of the
first catalog, and so on); the last two words of each chunk gives a password.
Each component name and password is given as 1-12 BCD characters,
left-justified and padded on the right with blanks.
If a component has no password, the password part of the chunk is all blanks.
After the last pathname chunk comes a word containing the value -1.
Notes:
If the file you want to purge is busy, the operation is deferred until the
file stops being busy.
See Also:
expl mme gefsye 22
Copyright © 2000, Thinkage Ltd.