jpqquealt
- Organization of this page
Format
jpqquealt [-mh manager-host-name] {-q queue-name|-ah agent-host-name} {[-mj maximum-number-of-jobs-in-queues]| [-wj warning-value-for-jobs-count-in-queues]| [-nq post-change-queue-name]} [-em]
Description
Changes queue definitions.
Execution privileges
You must have the following JP1 privilege:
-
JP1_JPQ_Admin privilege
However, specifying the -em option requires the following privileges (but does not require JP1_JPQ_Admin privileges).
-
Windows: Administrators privileges
-
UNIX: Superuser privileges
Arguments
-mh manager-host-name
Specify the name of a manager host that contains the queue whose definition is to be changed.
You can specify a character string of 1 to 255 bytes.
By default, the system assumes the local host name.
When you specify this option together with the -em option, you can specify only two types of host names: the local host name and the logical host name on the local host. Specifying any other value results in an error (error code: 25). Also note that you cannot specify an alias host name in the -mh option.
-q queue-name
Specify the queue name you want to change.
You can specify a character string of 1 to 63 bytes.
-ah agent-host-name
When you want to change the definition of a default queue, specify the corresponding agent host name that has been registered on the manager host. When an agent host is registered, the default queue is created with the same name as the agent host.
You can specify a character string of 1 to 255 bytes.
You cannot specify this option (you cannot change the name of the default queue) if you specify the -nq option.
-mj maximum-number-of-jobs-in-queues
Specify the maximum number of jobs which can be accumulated in the queue.
You can specify a value between 1 and 4,294,967,295.
This setting also includes the number of jobs that are actually being executed.
The number of jobs is the sum of the values of QUEUING and EXECUTING displayed by the jpqqueshow command with the -q option specified.
By default, the system does not change the maximum value of jobs.
-wj warning-value-for-jobs-count-in-queues
Specify a warning value to inform you that the number of jobs in a queue is nearing the maximum number of jobs that can be stored in the queue.
You can specify a value of 1 to 4,294,967,295; however, the value must be equal to, or smaller than, the value specified by the -mj option.
This setting also includes the number of jobs that are actually being executed.
The number of jobs is the sum of the values of QUEUING and EXECUTING displayed by the jpqqueshow command with the -q option specified.
By default, the system does not change the warning value.
-nq post-change-queue-name
When renaming a queue, specify its new name.
You can specify a character string of 1 to 63 bytes.
By default, the system does not change the queue name.
This option can be specified only when the -q option is specified. You cannot specify it together with the -ah option (you cannot rename the default queue).
-em
Specify this option for emergency execution.
Specifying this option enables emergency execution upon failure because a request is sent to a different communication path that is not used under normal conditions.
When you specify this option, note that you cannot assign an IP address to the manager host name.
Notes
-
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.
-
Be sure to specify at least one of the -mj, -wj, and -nq options.
-
The maximum value for the number of jobs specified in the -mj option is equal to, or larger than, the warning value for the number of jobs specified in the -wj option.
If you change the maximum or warning value regarding the number of jobs, the system compares it with the current setting. Therefore, if you want to change only the maximum value with the -mj option, make sure that you choose a value equal to, or greater than, the current warning value regarding the number of jobs. If you want to change only the warning value with the -wj option, make sure that you choose a value equal to, or smaller than, the current maximum value regarding the number of jobs.
-
Even if the maximum value for the number of jobs is changed to a value smaller than the current number of jobs being queued, the system executes those jobs being queued. Note, however, that the system will not accept new jobs until the number of jobs being queued falls below the maximum value for the number of jobs after the change.
For example, suppose that there are 12 jobs being queued. If you change the maximum number of jobs to 10, the system executes up to 12 jobs, but will not accept new jobs until the number of jobs being queued goes down to 9 or fewer.
-
An error occurs if you change the name of a queue while the queue still contains jobs.
-
You cannot rename the default queue.
-
You should use the -em option for the sole purpose of recovering from an agent host failure. You should avoid specifying the -em option under any normal condition, because you may fail to take corrective action when a failure actually occurs.
Return values
0 |
Normal end |
1 |
Invalid parameter value |
2 |
An attempt to change the queue definition failed due to an internal cause of the host on which the jpqquealt command was executed. |
5 |
Initialization has failed.
|
6 |
Memory became insufficient on the host on which the jpqquealt command was executed. |
7 |
A logical error occurred on the host on which the jpqquealt command was executed. |
25 |
The specified manager host name is neither the local host name nor the logical host name. |
100 |
The host on which the jpqquealt command was executed cannot connect to the manager host via TCP/IP communication.
|
102 |
The IP address could not be resolved from the name of the manager host on which the jpqquealt command was executed. |
200 |
The manager host does not accept a queue changing request.
|
201 |
You cannot use a specified queue.
|
202 |
No response from the manager host |
203 |
The queue could not be changed successfully owing to an internal cause of the manager host. |
206 |
You do not have the privilege required to change the queue. |
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 request to a host other than JP1/AJS3. |
226 |
Invalid execution environment |
232 |
The post-change queue has the same name as an existing queue. |
233 |
The queue contains jobs at the time of a queue name change. |
237 |
The warning value for the number of jobs is greater than its maximum value. |
238 |
The maximum value for the number of jobs is greater than its warning value. |