jpqqueadd
- Organization of this page
Format
jpqqueadd [-mh manager-host-name] -q queue-name [-mj maximum-number-of-jobs-in-queues] [-wj warning-value-for-jobs-count-in-queues] [-en {open|close}] [-ex {open|close}]
Description
Adds a queue.
Execution privileges
You must have the following JP1 privilege:
-
JP1_JPQ_Admin privilege
Arguments
-mh manager-host-name
Specify a manager host name to which a queue is to be added.
You can specify a character string of 1 to 255 bytes.
By default, the system assumes the local host name.
-q queue-name
Specify a queue name you want to add.
You can specify a character string of 1 to 63 bytes.
Note that agent names are not case sensitive, but that queue names are.
-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.
If you omit this option, the system assumes 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.
In spite of this setting, however, the submit process will fail if the queue still contains as many jobs as the system's maximum number of jobs.
-wj warning-value-for-jobs-count-in-queues
Specify a warning value to inform you that the number of jobs in a particular 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 assumes the value specified in the -mj option. Without the -mj option specified, the system assumes the value of 4,294,967,295.
-en {open|close}
Specify the status of the job entrance in the queue.
-
open
Opens the reception port.
-
close
Closes the reception port.
By default, the system assumes open.
-ex {open|close}
Specify the status of the job exit in the queue.
-
open
Opens the takeout port.
-
close
Closes the takeout port.
By default, the system assumes open.
Note
This command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.
Return values
0 |
Normal end |
1 |
Invalid parameter value |
2 |
The queue could not be added successfully owing to an internal cause of the adding requester. |
5 |
Initialization has failed.
|
6 |
Queue adding requester's insufficient memory |
7 |
The queue adding 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 queue adding request.
|
202 |
No response from the manager host |
203 |
The queue could not be added successfully owing to an internal cause of the manager host. |
206 |
You do not have the privilege required to add 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 additional queue has the same name as an existing queue. |
235 |
The maximum number of queue definitions has been exceeded. |