|
|
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
- Manuals
Process Management Programmer's Guide
|