|
|
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
|