Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

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 operations. Use the Guardian SETMO-
DENOWAIT 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
You can specify any value for the function, param1, and param2 parameters.
Establish an application-defined protocol 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 is sup-
plied 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.
You can identify the process that called SPT_SETMODE() in a subsequent call
to the Guardian FILE_GETRECEIVEINFO_ (or LASTRECEIVE or
RECEIVEINFO) procedure. For a list of all system messages sent to processes,
see the Guardian Procedure Errors and Messages Manual.
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),
SPT_WRITEUPDATEUNLOCKX(2), SPT_WRITEUPDATEX(2), SPT_WRITEX(2).
527186-023 Hewlett-Packard Company 7−411