MPE/iX Intrinsics Reference Manual (32650-90905)

46 Chapter4

Command Deﬁnitions (ABORTSESS - FCLOSE)

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(

allow

);

Parameters

16-bit signed integer by value (required)

Indicates the parent or child process to be activated. To indicate a parent

process, set

to zero. To indicate a child process, set

to the process

identiﬁcation 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 speciﬁed 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 speciﬁed 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