The Priority command changes the priority level for a Data Vault Agent process.

The <host-name> parameter specifies the machine where the process is running. The <agent-ID> parameter refers to the Agent process ID, which can be viewed by executing the Current command; the Agent ID is indicated by the AID field in the Agents list. The <priority-level> parameter is the new priority level for the Agent process.

You can set the priority level to a number between zero and and two million. A higher number indicates a higher priority. If you set the agent priority level to 0 or 1, the Data Vault Service assigns a specific status to the agent.

Priority levels 0 and 1 indicate the following statuses:

Priority level 0. Indicates that the agent is not available to process any task. The Data Vault Service does not assign a task to an agent with a priority level of 0. To make the agent available to process tasks, change the priority level to a value higher than 0.
Priority level 1. Indicates that the agent primarily processes high-priority tasks such as registering data files or other administration tasks. The Data Vault Service can assign query tasks to an agent with priority level 1 if the agent is not busy and the Data Vault Service receives a high volume of queries.

If the agent is performing a task when you change the priority level from 0 or 1 to a higher priority, the agent does not change status until it completes the task.