HP 3000 Manuals HP 3000 Manuals
ACTIVATE
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)