jpqjobalt
- Organization of this page
Format
jpqjobalt [-mh manager-host-name] {-q queue-name|-ah agent-host-name} {-h|-hr} -j job-number
Description
Holds a job or releases a held job.
You can also apply this command to the JP1/NQSEXEC host job. In that case, however, the user can operate only the jobs he or she owns.
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 manipulate only the jobs you own)
Arguments
-mh manager-host-name
Specify the host name of the manager to which you have submitted a job to be held or released.
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 held or released.
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 held or released.
You can specify a character string of 1 to 255 bytes.
This option cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC3.
-h
Holds a job.
-hr
Releases a held job.
-j job-number
Specify the job number of a job to be held or released.
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 held or released successfully owing to an internal cause of the hold or release requester. |
5 |
Initialization has failed.
|
6 |
Hold or release requester's insufficient memory |
7 |
The hold or release 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 hold or release request.
|
201 |
You cannot use a specified queue.
|
202 |
No response from the manager host |
203 |
The job could not be held or released successfully owing to an internal cause of the manager host. |
206 |
You do not have the privilege required to hold or release the job. |
207 |
The job to be held or released does not exist.
|
208 |
The specified job is running. |
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 job hold or hold release request to an unsupported host. |
226 |
Invalid execution environment |
Additional information
Even if you set the -h option for a held job or the -hr option for a job waiting for execution or time, the command ends normally. The job status is not, however, changed.