SUSPEND
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
Syntax
U16V I16V
SUSPEND (allow, rin);
Parameters
- allow
16-bit unsigned integer by value (required)
Passes the anticipated source of the call and, later, reactivates the process, as indicated by bits (14:1) and (15:1):
Bits Value/Meaning> 15:1 Parent activation bit:
0 - Process does not expect to be activated by its parent
1 - Process expects to be activated by its parent14:1 Child activation bit:
0 - Process does not expect to be activated by one of its children
1 - Process expects to be activated by one of its children
NOTE: If the process is running with only process handling (PH) capability, at least one of these bits must = 1.If (14:1)=1 and (15:1)=1, either the parent or a child can activate the suspended process.
Bits (0:14) are reserved for the operating system.
- rin
16-bit signed integer by value (optional)
Passes the resource identification number (RIN). If rin is specified, it represents a local RIN that is locked by the process but is released when this process is suspended. This facility can be used to synchronize processes within the same job.
Operation Notes
When SUSPEND is executed, the calling process relinquishes its access to the CPU until reactivated by an ACTIVATE intrinsic call. The calling process must specify the anticipated source of the ACTIVATE call (its parent or a child process). When the process is reactivated, it begins execution with the instruction immediately following the SUSPEND call.
Condition Codes
| CCE (2) | Request granted. |
| CCG (0) | Not returned. |
| CCL (1) | Request denied. The allow parameter is not valid, the specified RIN is not owned by this process, or the specified RIN was not locked. |
Related Information
| Intrinsics | ACTIVATE, CREATE, CREATEPROCESS, GETORIGIN, GETPROCID, KILL |
| Manuals | Process Management Programmer's Guide |
|
STARTSESS |
SWITCHDB |