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

GETPRIORITY

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

NM and CM callable.

Changes the priority of a process. Process handling (PH) capability is required.

Syntax

               I16V   U16V      I16V

   GETPRIORITY(pin,priorityclass,rank);

Parameters

pin

16-bit signed integer by value (required)

Passes the process whose priority is to be changed. To specify the calling process, set pin to zero. To specify a child process, set pin to the process identification number (PIN) of a child process.

priorityclass

16-bit unsigned integer by value (required)

Contains the priority class in which the new process is scheduled (AS, BS, CS, DS, ES), computed in the following manner:

   (ASCII of first character * 256) +

   (ASCII of second character)

The integer equivalents are:

   AS = 16,723

   BS = 16,979

   CS = 17,235

   DS = 17,491

   ES = 17,747

Aborts the calling process if priorityclass exceeds the maximum allowable priority class of the rescheduled process or specifies an invalid priority class.

Specify any priority class except AS, if in user mode; this function is limited by the maximum priority assigned to the account by the system manager. If in privileged mode, processes can be scheduled into all subqueues including AS. Processes in the linear queues, AS or BS, do not give up the CPU voluntarily; it could loop indefinitely and prevent other processes from accessing the CPU.

If in privileged mode, specify the priorityclass parameter as an absolute priority by xA, where x is an 8-bit priority number and A is the ASCII character A. For example, to request a priority class of 31 in the master queue, set priorityclass to %017501. An absolute priority must be specified in order to overcome the MAXPRI setting of an account.

Default: The priority class of the calling process

NOTE: Scheduling a process into the AS or BS priority class can result in the rescheduled process deadlocking the system or locking out system and user processes from execution.
rank

16-bit signed integer by value (optional)

Used for backward-compatibility with pre-MPE IV operating systems only.

Operation Notes

A process must be running in privileged mode to specify absolute priority.

A process can change its own priority or that of its child, but it cannot reschedule its parent.

Condition Codes

CCE (2)

Request granted.

CCG (0)

Request denied. The process specified is not currently accessible (for example, unborn or dying).

CCL (1)

Request denied. An illegal or invalid PIN was specified.

Related Information

Intrinsics

None

Commands

None

Manuals

Process Management Programmer's Guide (32650-90023)

Feedback to webmaster