jpqjobmove
- Organization of this page
Format
jpqjobmove [-mh manager-host-name] {-q queue-name|-ah agent-host-name} {-dq destination-queue-name|{-p+|-p-} execution-order} -j job-number
Description
Moves a job in a queue.
The movement encounters the restrictions below.
-
You can move only the jobs other than those running or ended.
-
You can specify as the job destination only the queue in the same manager host as the movement sources.
-
For jobs in the default queue.
-
You cannot move jobs between queues.
-
You can specify an arbitrary job execution order within the default queue.
-
-
For jobs in queues other than the default queue:
-
You cannot specify the default queue as the movement destination.
-
If you specify the name of the movement destination queue which is the same as the movement source queue, the job is executed last.
-
If you specify the name of the movement destination queue which is the same as the movement source queue, you can specify an arbitrary job execution order.
-
If the movement source queue is different from the destination queue, the job is executed last.
-
-
For QUEUE jobs registered from a jobnet
-
You cannot move jobs between queues.
-
This command is applicable for the following jobs:
- When the database is in a standard configuration:
-
Submit jobs and queue jobs
- When the database is in a standard configuration without ISAM:
-
None
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_JPQ_Admin privilege
-
JP1_JPQ_Operator privilege
-
JP1_JPQ_User privilege (allows you to move jobs between queues only)
Arguments
-mh manager-host-name
Specify the name of the manager host to which you have submitted a job to be moved.
You can specify a character string of 1 to 255 bytes.
By default, the system assumes the local host name.
-q queue-name
Specify the name of the queue to which you have submitted a job to be moved. To change the job execution order in a queue other than the default queue, or to move a job between queues, specify this option.
You can specify a character string of 1 to 63 bytes.
-ah agent-host-name
Specify the name of the agent host to which you have submitted a job to be moved. To change the order in which jobs in the default queue are executed, specify this option.
You can specify a character string of 1 to 255 bytes.
You cannot specify this option with the -dq option.
-dq destination-queue-name
Specify the name of the queue where you want to move a job.
You can specify a character string of 1 to 63 bytes.
You cannot specify this option with the -ah option.
You cannot specify this option with the -p+ or -p- option.
{-p+|-p-} execution-order
Specify the order in which the jobs in the queue are executed.
-
-p+
Moves the job so that it will be executed earlier.
-
-p-
Moves the job so that it will be executed later.
-
execution-order
Specify the order in which jobs are executed in relative order from the current order. (For example, to change current execution order 5 to 3, set -p+ 2.)
If the number of jobs in the queue is less than the specified execution order, it is moved to the top of the queue when you set -p+, and to the end when you set -p-. (For example, if the queue contained fewer than five jobs although you set -p+ 5, the system performs processing as if you set execution order 1.)
You cannot specify this option with the -dq option.
-j job-number
Specify the job number of a job to be moved.
You can use the jpqjobshow command to check the job number.
Make sure that you specify a job number in the range from 1 to 999999.
Note
This command cannot be used for a request from JP1/AJS3 to JP1/OJE for VOS3.
Return values
0 |
Normal end |
1 |
Invalid parameter value |
2 |
The job could not be moved successfully owing to an internal cause of the job movement requester. |
5 |
Initialization has failed.
|
6 |
Job movement requester's insufficient memory |
7 |
The job movement requester encountered a logic error. |
100 |
The manager host cannot be connected for TCP/IP communication.
|
102 |
The IP address could not be solved successfully by the manager host name. |
200 |
The manager host does not accept a job movement request.
|
201 |
You cannot use a specified queue.
|
202 |
No response from the manager host |
203 |
The job could not be moved successfully owing to an internal cause of the manager host. |
206 |
You do not have the privilege required to move the job. |
207 |
The job to be moved does not exist.
|
208 |
The specified job is running. |
209 |
The queue set as the destination is not found. |
210 |
Because the number of submit jobs has reached the limit value in the queue set as the destination, you cannot move the job. |
219 |
The manager host is busy. |
220 |
Insufficient manager host memory |
222 |
A fatal error has occurred.
|
223 |
The manager host encountered a logic error. |
224 |
You have issued a request to a host other than JP1/AJS3. |
226 |
Invalid execution environment |