HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

SUSPEND

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

NM and CM callable.

Suspends a process. Process handling (PH) capability is required.

Syntax

            U16V I16V

   SUSPEND(allow,rin);

Parameters

allow

16-bit unsigned integer by value (required)

Passes the anticipated source of the call and, later, reactivates the process, as indicated by bits (14:1) and (15:1):

BitsValue/Meaning
15:1

Parent activation bit:

0

Process does not expect to be activated by its parent

1

Process expects to be activated by its parent

14:1

Child activation bit:

0

Process does not expect to be activated by one of its children

1

Process expects to be activated by one of its children

NOTE: If the process is running with only process handling (PH) capability, at least one of these bits must = 1.

If (14:1)=1 and (15:1)=1, either the parent or a child can activate the suspended process.

Bits (0:14) are reserved for the operating system.

rin

16-bit signed integer by value (optional)

Passes the resource identification number (RIN). If rin is specified, it represents a local RIN that is locked by the process but is released when this process is suspended. This facility can be used to synchronize processes within the same job.

Operation Notes

When SUSPEND is executed, the calling process relinquishes its access to the CPU until reactivated by an ACTIVATE intrinsic call. The calling process must specify the anticipated source of the ACTIVATE call (its parent or a child process). When the process is reactivated, it begins execution with the instruction immediately following the SUSPEND call.

Condition Codes

CCE (2)

Request granted.

CCG (0)

Not returned.

CCL (1)

Request denied. The allow parameter is not valid, the specified RIN is not owned by this process, or the specified RIN was not locked.

Related Information

Intrinsics

None

Commands

None

Manuals

Process Management Programmer's Guide (32650-90023)

Feedback to webmaster