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

ACTIVATE

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes

Condition Codes

Related Information