qmove

Move PBS batch jobs

Synopsis

qmove destination jobId [jobId ...]

Description

To move a job is to remove the job from the queue in which it resides and instantiate the job in another queue. The qmove command issues a Move Job batch request to the batch server that currently owns each job specified by jobId.

A job in the Running, Transiting, or Exiting state cannot be moved.

Operands

The first operand, the new destination, is one of the following:

queue
@server
queue@server

If the destination operand describes only a queue, then qmove will move jobs into the queue of the specified name at the job's current server. If the destination operand describes only a batch server, then qmove will move jobs into the default queue at that batch server. If the destination operand describes both a queue and a batch server, then qmove will move the jobs into the specified queue at the specified server.

All following operands are jobIds which specify the jobs to be moved to the new destination. The qmove command accepts one or more jobId operands of the form: sequenceNumber[.serverName][@server]

Standard Error

The qmove command will write a diagnostic message to standard error for each error occurrence.

Exit Status

Upon successful processing of all the operands presented to the qmove command, the exit status will be a value of zero.

If the qmove command fails to process any operand, the command exits with a value greater than zero.

See Also

qsub(1B), pbs_movejob(3B)