Data Manipulation Language Statements › CHANGE PRIORITY (DC/UCF)

CHANGE PRIORITY (DC/UCF)

The CHANGE PRIORITY statement changes the dispatching priority of the issuing task. The new dispatching priority applies only to the current execution of the task. CHANGE PRIORITY does not relinquish control to another task and cannot be used to alter the priority of other tasks.

Syntax

►►─── CHANGE PRIORITY TO (priority); ─────────────────────────────────────────►◄

Parameter

priority

Specifies a new dispatching priority for the issuing task. Priority is either the symbolic name of a user-defined field that contains the priority value, or the value itself expressed as a numeric constant in the range 0 through 240.

Example

The following Example changes the dispatching priority of the issuing task to the value contained in the PRIORITY_210 field:

CHANGE PRIORITY TO (PRIORITY_210);

Status Codes

Upon completion of the CHANGE PRIORITY function, the ERROR_STATUS field in the IDMS DC communications block indicates the outcome of the operation:

0000

The request has been serviced successfully.