Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)

Guardian Procedure Calls Reference Manual—522629-013

12-204

PROCESS_SUSPEND_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Safeguard Considerations

OSS Considerations

Example

Related Programming Manual

Summary

The PROCESS_SUSPEND_ procedure places a process or process pair into the

suspended state, preventing that process from being active (that is, from executing

instructions). A process can also be suspended by a call to the SUSPENDPROCESS

procedure, or by a TACL SUSPEND command. The process or process pair can be

reactivated by a subsequent call to PROCESS_ACTIVATE_ or ACTIVATEPROCESS

or by a TACL ACTIVATE command.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

error returned value

INT

indicates the outcome of the operation. It returns one of the following file-system

errors:

0 Process successfully suspended.

2 Process is already in the suspended state.

11 Process does not exist.

48 Security violation.

201 Unable to communicate with processor where the process is running.

#include <cextdecs(PROCESS_SUSPEND_)>

short PROCESS_SUSPEND_ ( short *processhandle

,[ short specifier ] );

error := PROCESS_SUSPEND_ ( processhandle ! i

,[ specifier ] ); ! i