Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-68
SETMODE Procedure
= (CCE) indicates that the SETMODE is successful.
> (CCG) indicates that the SETMODE function is not allowed for this device type.
SETMODE Functions
Table 14-4 on page 14-68 lists the SETMODE functions that can be used with the I/O
devices discussed in this manual for NonStop servers.
Table 14-4. SETMODE Functions (page 1 of 34)
function Parameters and Effect
1
Disk: Set file security
param1
<0> = 1 for program files only, sets accessor's ID to program file's ID
when program file is run (PROGID option).
<1> = 1 sets CLEARONPURGE option on. This means all data in the
file is physically erased from the disk (set to zeros) when the
file is purged. If this option is not on, the disk space is only
logically deallocated on a purge; the data is not destroyed, and
another user might be able to examine the "purged" data when
the space is reallocated to another file.
<4:6> = ID allowed for reading
<7:9> = ID allowed for writing
<10:12> = ID allowed for execution
<13:15> = ID allowed for purging
For each of the fields from <4:6> through <13:15>, the value can be any one
of the following:
0 = member local ID
1 = member of owner's group (local)
2 = owner (local)
4 = any network user (local or remote)
5 = member of owner's community
6 = local or remote user having same user ID as owner
7 = local super ID only
See the
Guardian Programmer’s Guide or the File Utility Program (FUP)
Reference Manual for an explanation of local and remote users,
communities, and so forth.
param2 is not used with function 1.
If this SETMODE function is used on a file that is protected by a Safeguard
disk-file authorization record, and if the user is not logged on with the super
ID on the system where the file is located, error 199 is returned.