Job Management Partner 1/Automatic Job Management System 3 Command Reference 2

jpqjobmove

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

When the database is in a compatible ISAM configuration:

PC jobs (other than queueless jobs), UNIX jobs (other than queueless jobs), action jobs, custom jobs, submit jobs, and queue jobs

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

During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this command for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.

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. The definition of the logical host name or the environment setting contains an error.
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. Because TCP/IP is not validly set, the manager host cannot be connected. The manager host name is invalid, or the manager host process stopped.
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. The manager host is now being started, now being stopped, has stopped, or is running in the reduced-operation mode.
201	You cannot use a specified queue. The specified queue is not found.
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. The specified job is not in the database. The specified job has ended.
208	The specified job is running.
209	The queue set as the destination is not found.
210	Because the number of submitted 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. A system call 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

[Contents][Back][Next]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.