SUSPEND [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
SUSPEND
NM and CM callable.
Suspends a process. Process handling (PH) capability is required.
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 parent
14: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 None
Commands None
Manuals Process Management Programmer's Guide (32650-90023)
MPE/iX 5.0 Documentation