Synopsis
qmove [-sys subsystem-number](*1) [-d] [-u user-name] [-z] job [queue]...
[-sys subsystem-number] is an option of Systemwalker Operation Manager EE.
Description
The qmove command moves the specified job on the local server from the current queue to the specified queue. (The job is deleted from its current queue and placed in the queue specified with the queue operand). Only when the job is in a "que" state, it can be moved.
The following users can move a job:
The user who submitted the job
System administrator
The following cannot be performed using this command:
Moving the jobs submitted in the distributed execution queue
Moving jobs into the distributed execution queue.
Options
-sys subsystem-number
In the system with multiple subsystems, this option is used to specify the subsystem that you want to operate. Specify the target subsystem number using a range of 0 to 9. If omitted, the default is subsystem 0.
-d
Displays the result every time you attempt to move a job to the queue specified with the queue operand.
-u user-name
When the system administrator moves other user's job, the user name of the job owner must be specified in this option.
If blanks are contained in the user name, enclose the entire user name in double quotation marks. [Windows]
The user of Operation Manager cannot be specified. [UNIX]
-z
If you specify this option, no message to report that the specified job has been successfully moved is displayed.
If this option is omitted, the job name and destination queue name are displayed when the job has been moved successfully. If the -u option is specified with this operand, the name of the job owner is also displayed.
If the move failed, or an error occurs during the move, an error message will be generated regardless of this option.
Operands
job
Specifies the job to be moved.
Use the following format to specify this operand:
For more details on each attribute, see "7.6 qjalter Job Attribute Alter Command".
job-name(jobno.hostname)
queue
Specify the destination queue in "queue"
Wildcards cannot be used in queue names.
If this operand is omitted, the move will be attempted to the default queue specified in "Specify the default queue to submit jobs to" (the dfltqueue operand in the system parameter) in the [Define Operating Information] window.
You can specify more than one queue name. The Job Execution Control function attempts to move a job to the queues in the specified order, and moves the job to the first available queue it finds. Even if there are specified queues left behind after moving the job, it cannot be moved to those queues.
If none of the specified queues is found or if the queue currently containing the job is specified as the destination, the Job Execution Control performs no action.
Return Values
Return Value | Meaning |
|---|---|
0 | The command processing has terminated normally. |
Other than 0 | The command processing has failed. An error message is output. |
Command Location
Windows | <Systemwalker Operation Manager installation directory>\MpWalker.JM\bin |
Solaris | /opt/FJSVMJS/usr/bin |
HP-UX | /opt/FHPMJS/usr/bin |
AIX | /opt/FAIXMJS/usr/bin |
Cautions
Job name "job-name (jobno.hostname)" cannot be omitted.
Example
For example, the following command shows how the system administrator moves the job (job number 1) of "user1" into "queue3" (due to some reason, if moving to "queue3" failed, the job 1 will be moved into "queue4").
qmove -d -u user1 1 queue3 queue4
