Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-102
SETMODE Procedure
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 SETMODEs on Telserv are allowed before doing a CONTROL 11.
Disk File Consideration
•
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). (See the
Guardian Procedure Errors and Messages Manual for a
list of all system messages sent to processes.)