Guardian Procedure Calls Reference Manual

Functions
Table 44 lists the SETMODE functions that can be used with the I/O devices discussed in this
manual for NonStop servers.
Table 44 SETMODE Functions
Parameters and EffectFunction
Disk: Set file security1
param1
for program files only, sets accessor's ID to program file's ID when
program file is run (PROGID option).
= 1<0>
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.
= 1<1>
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.
= ID allowed for reading<4:6>
= ID allowed for writing<7:9>
= ID allowed for execution<10:12>
= ID allowed for purging<13:15>
For each of the fields from <4:6> through <13:15>, the value can be any one of these:
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
For an explanation of local and remote users, communities, and so forth, see the Guardian Programmer's
Guide or the File Utility Program (FUP) Reference Manual.
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.
This function operates only on Guardian objects. If an OSS file is specified, file-system error 2 occurs.
Disk: Set file owner2
param1
= group ID<0:7>
= member ID<8:15>
param2 is not used with function 2.
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.
This function operates only on Guardian objects. If an OSS file is specified, file-system error 2 occurs.
SETMODE Procedure 1319