Guardian Procedure Calls Reference Manual

Returned Value
INT
Either the preceding value of stop-mode or -1 if an invalid mode was specified.
Considerations
• The default stop mode is 1 when a process is created.
• If a process' stop mode is 1 when a PROCESS_STOP_ or STOP procedure call is issued against
it by a process without the authority to stop it, the process does not stop; the process is deleted,
however, if and when the stop mode is changed to 0.
• If a process' stop mode is 2 when a PROCESS_STOP_ or STOP procedure call is issued against
it by another process, the stop is queued until the process is in a stoppable mode.
• If a process' stop mode is 2 when an unhandled trap or signal occurs, it causes a processor
halt. Such a halt occurs, for example, if an unmirrored disk volume that the process is using
as a swap volume goes down.
OSS Considerations
An OSS process can be stopped only according to the rules specified for the OSS kill() function.
Stop mode 0 is therefore not allowed for OSS processes. For details, see the kill(2) function
reference page either online or in the Open System Services System Calls Reference Manual.
Example
LAST^MODE := SETSTOP ( NEW^MODE );
Related Programming Manual
For programming information about the SETSTOP procedure, see the Guardian Programmer's
Guide.
1354 Guardian Procedure Calls (S)