Guardian Procedure Calls Reference Manual

Considerations
• Default SETMODE settings
The SETMODE settings designated as "default" are the values that apply when a file is opened
(not if a particular function is omitted when SETMODE is called).
• Waited SETMODE
The SETMODE procedure is used on a file as a waited operation even if filenum has been
opened for nowait. Use the SETMODENOWAIT procedure for nowait operations.
• No SETMODE calls on Telserv are allowed before doing a CONTROL operation 11.
Disk File Considerations
• Ownership and security of file
"Set disk file security" and "set disk file owner" are rejected unless the requester is the owner
of the file or the super ID.
Interprocess Communication Considerations
• Nonstandard parameter values
Any value can be specified for the function, param1, and param2 parameters. An
application-defined protocol should be established for interpreting nonstandard parameter
values.
• User-defined SETMODEs
Use of function code numbers 100 to 109 avoids any potential conflict with SETMODE codes
defined by HP.
• Incorrect use of last-params
Error 2 is returned when the last-params parameter has been supplied but the target
process does not correctly return values for this parameter.
Messages
• Process SETMODE message
Issuing a SETMODE to a file representing another process causes a system message -33
(process SETMODE) to be sent to that process.
The identification of the process that called SETMODE can be obtained in a subsequent call
to FILE_GETRECEIVEINFO_ (or LASTRECEIVE or RECEIVEINFO). (For a list of all system
messages sent to processes, see the Guardian Procedure Errors and Messages Manual.)
Examples
1. This LITERAL sets the file's security to:
= any local userread
= owner onlywrite
= owner onlyexecute
= owner onlypurge
LITERAL SECURITY = %0222;
.
.
SETMODE Procedure 1343