 |
» |
|
|
|
NM and CM callable. Activates a newly created process, or a process suspended with
the SUSPEND intrinsic. Requires process handling (PH) capability. Syntax | |
I16V U16V
ACTIVATE(pin,allow);
|
Parameters | |
- pin
16-bit signed integer by value (required) Indicates the parent or child process to be activated. To indicate
a parent process, set pin to zero. To indicate a
child process, set pin to the process identification
number (PIN) of the process. The called process must always
be expecting an activation from the caller (refer to the SUSPEND
and CREATE intrinsics).
- allow
16-bit unsigned integer by value (optional) Passes suspend or execute information to the process being
activated:
When allow is not specified or is zero, the called process is
activated by the operating system but does not commence
execution immediately. Instead, control returns to the calling
process, which continues execution. This is the default.
When allow is specified and is not zero, the calling process
is suspended while the called process is activated and
commences execution. Bits (14:2) specify the anticipated source of the
call that reactivates the calling process:
| Bits | Value/Meaning |
|---|
| 15:1 | Parent activation bit: | | | 0 Does not expect activation by a parent | | | 1 Expects activation by a parent | | 14:1 | Child activation bit: | | | 0 Does not expect activation by a child | | | 1 Expects activation by one child | | 0:14 | Reserved for the operating system |
Operation Notes | |
A newly created process can only be activated by its parent.
A suspended process can be reactivated by its parent, or any of
its children, as specified in the allow parameter of the
ACTIVATE and SUSPEND intrinsics. When a process is
activated, it runs until it is either suspended or deleted. The ACTIVATE intrinsic aborts the calling process (and
possibly the entire job/session) if a request to activate
the parent results in the activation of the root CI or a
system process. The abort error messages associated with
these situations are:
ACTIVATION OF SYSTEM PROCESS NOT ALLOWED
(ACTIVATE ERROR 20)
ACTIVATION OF MAIN PROCESS NOT ALLOWED
(ACTIVATE ERROR 21)
|
Condition Codes | |
- CCE (2)
Request granted. The called process is activated.
The calling process is suspended if you specified allow.
- CCG (0)
Request granted. The called process is already active. The
calling
process is suspended if you specified allow.
- CCL (1)
Request denied. The called process was not expecting
activation by this calling process, an illegal pin parameter
was specified, or the allow parameter was specified improperly.
Related Information | |
- Intrinsics
CREATE, SUSPEND - Commands
None - Manuals
Process Management Programmer's Guide (32650-90023)
|
