22 - file release (no purge).

Usage:

mme    gefsye
zero   CC,ARGLIST
zero   22,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 deletes an existing file, but does not purge it. The argument list indicated by ARGLIST has the form

zero    RETURN_WORD,USERID
zero    FILE_NAME,0

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 released. 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 release is busy, the deletion is deferred until the file stops being busy.

See Also:

expl mme gefsye 9

Copyright © 2000, Thinkage Ltd.