Synopsis
qhold [-sys subsystem-number](*1) [-u user-name] job ...
[-sys subsystem-number] is an option of Systemwalker Operation Manager EE.
Description
The qhold command holds the specified job.
The following users can hold jobs:
The user who submitted the job
System administrator
To release the job in a holding state, use the qrls command.
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.
-u user-name
When the system administrator holds other user's job, the user name of the job owner must be specified in this option. If the job owner holds his/her own job, this option can be omitted.
The user of Operation Manager cannot be specified. [UNIX]
The job in a holding state made by the system administrator cannot be released even by the owner of this job.
If blanks are contained in the user name, enclose the entire user name in double quotation marks. [Windows]
Operand
job
Specifies the job to be held.
To specify the job, use the following format:
For more details on each attribute, see "7.6 qjalter Job Attribute Alter Command".
job-name(jobno.hostname)
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
The job name "job-name (jobno.hostname)" cannot be omitted.
Only jobs in a "que" state can be held. Then, the job enters a "hld" state.
Jobs in any other state than the "que" cannot be held.
