Open System Services System Calls Reference Manual (G06.28+)

System Functions (s and S) SPT_SETMODE(2)
Waited SPT_SETMODE() use
The SPT_SETMODE() function is used on a file as a waited
operation even if filenum has been opened for nowait. Use the
Guardian SETMODENOWAIT procedure for nowait operations.
Use for Telserv processes
No SPT_SETMODE() calls on Telserv are allowed before
doing an SPT_CONTROL( ) function 11.
Ownership and security of a disk 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 functions
Use of function code numbers 100 to 109 avoids any potential
conflict with SPT_SETMODE() function codes defined by HP.
Incorrect use of last_params
Guardian file-system error 2 is returned when the last_params
parameter has been supplied but the target process does not
correctly return values for this parameter.
Process message
Issuing an SPT_SETMODE() call 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 SPT_SETMODE()
can be obtained in a subsequent call to the Guardian
FILE_GETRECEIVEINFO_ (or LASTRECEIVE or
RECEIVEINFO) procedure. (See the Guardian Procedure
Errors and Messages Manual for a list of all system messages
sent to processes.)
RETURN VALUES
The SPT_SETMODE() function returns 0 (zero) upon successful completion. Otherwise, this
function returns a nonzero Guardian file-system error number that indicates the outcome of the
operation.
For information about Guardian file-system error numbers, see the Guardian Procedure Errors
and Messages Manual.
ERRORS
None. This function does not set the errno variable.
RELATED INFORMATION
Functions: SPT_CANCEL(2), SPT_CONTROL(2), SPT_FILE_CLOSE_(2),
SPT_FILE_OPEN_(2), SPT_LOCKFILE(2), SPT_LOCKREC(2), SPT_READLOCKX(2),
SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2),
SPT_UNLOCKFILE(2), SPT_UNLOCKREC(2), SPT_WRITEREADX(2),
527186-005 Hewlett-Packard Company 7−305