GEFSYE - file system call.

Usage:

mme    gefsye
zero   CC,ARGLIST
zero   CODE,BUFFER

Where:

CC

is either zero or a courtesy call address. If a non-privileged program specifies a courtesy call address, it is ignored.

ARGLIST

points to a list of arguments for this call.

CODE

indicates what file system service is desired. The following decimal codes are supported.

 2  -- catalog creation
 3  -- file creation
 9  -- file purge and release
10  -- catalog modification
11  -- file modification
22  -- file release (no purge)
23  -- file query
28  -- security lock
29  -- abort lock
30  -- miscellaneous TP operations
34  -- identify defective space
35  -- replace/mark defective space
38  -- TDS lock
39  -- file shrink
40  -- cancel changes
41  -- regard changes as complete
43  -- provide allocated file information
46  -- file query for allocated file

BUFFER

points to a buffer that can be used in this operation.

Description:

MME GEFSYE calls on the File Management Supervisor to perform a service. The CODE value indicates what service is desired; the nature of other argument values is affected by the nature of the service.'

Normally, MME GEFSYE automatically issues a MME GEROAD which suspends the calling program until the file system operation is complete. However, if a privileged program requests a courtesy call, the MME GEROAD is not issued. In this case, the program must either roadblock itself or be able to determine when the operation is complete.

General Permissions

A number of MME GEFSYE operations make use of codes signifying general file permissions. Below we list the recognized codes (in octal).

APPEND    1000
CREATE    0010
EXECUTE   0400
LOCK      0040
MODIFY    7754
PURGE     7604
READ      4400
RECOVERY  7404
WRITE     7400

Device Classes

A number of MME GEFSYE operations make use of codes signifying device classes. Below we list the recognized codes (in octal).

MS0400   64
MS0450   65
MS0500   66
MS0501   67
MSU3380:
  MSC1A  73
  MSC1B  53

Volume Types

A number of MME GEFSYE operations make use of codes signifying volume types. Below we list the recognized codes (in octal).

400PK   64
450PK   65
500PK   66
501PK   67
C1APK   73 (MSU3380)
C1BPK   53 (MSU3380)
TAPE    10
TAPE7   11
TAPE9   12
TAPE7   15
TAPE29  16

Density Codes

A number of MME GEFSYE operations make use of codes signifying densities. Below we list the recognized codes (in octal).

DEN0    00
DEN2    04
DEN6    10
DEN8    20
DEN16   44
DENSTD  74
DEN62   60

Error Codes

A number of MME GEFSYE operations return codes to indicate various errors. Below we list the recognized codes (in octal).

01   -- requesting user is not in SMC
03   -- requesting user does not have appropriate
        permissions
05   -- non-existent file or catalog (address of
        name is in upper half of 1st return word)
06   -- cannot get memory space for catalog or
        file description
11   -- name specified for creation (or new name
        in name modification) is already in use
14   -- incorrect password (address of name of
        file or catalog is in upper half of 1st
        return word)
17   -- seek error on device
22   -- checksum error in space availability table
        on device
24   -- checksum error in space availability table
        in memory
25   -- removable structured disk pack is not
        mounted (2nd return word gives device type
        and pack number)
42   -- invalid file code or PAT pointer
43   -- invalid catalog block address
52   -- required fixed device is not available, or
        device name not recognized
62   -- illegal subfunction code
63   -- file not being monitored
64   -- deadlock on page request
65   -- page currently busy
66   -- file not duplicated
67   -- TDS MON ALLOC error