CHANGE TASK

Change priority of a task.

CHANGE TASK

Condition: INVREQ

This command is threadsafe.

Description

CHANGE TASK changes the priority of the issuing task. It has immediate effect (unlike SET TASK), because control is relinquished during execution of the command so that the current task has to be redispatched. The redispatch does not happen until tasks that are of higher or equal priority, and that are also ready to run, are dispatched.

If you omit the PRIORITY option, the task does not lose control and the priority remains the same. This is effectively a no-op.

Options

PRIORITY(data-value): specifies a fullword binary value in the range 0–255, defining the priority of the task. You can also have a value of -1 but this does not change the priority or cause a redispatch.

Conditions

16 INVREQ

RESP2 values:

1: Your PRIORITY value is outside the range -1–255.