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

SPT_SETMODE(2) OSS System Calls Reference Manual
Considerations
Default settings
The SPT_SETMODE() settings designated as default in the
Guardian Procedure Calls Reference Manual are the values that
apply when a file is opened (not if a particular function value is
omitted when SPT_SETMODE() is called).
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 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
You can specify any value for the function, param1, and param2
parameters. Establish an application-defined protocol for inter-
preting 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 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.
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.
7−310 Hewlett-Packard Company 527186-007