jpqqueadd

Organization of this page

Format
Description
Execution privileges
Arguments
Note
Return values

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}]

To Page Top

Description

Adds a queue.

To Page Top

Execution privileges

You must have the following JP1 privilege:

JP1_JPQ_Admin privilege

To Page Top

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.

To Page Top

Note

This command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.

To Page Top

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. The definition of the logical host name or the environment setting contains an error.
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. As TCP/IP is not validly set, the manager host cannot be connected. The manager host name is invalid, or the manager host process stopped.
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. The manager host is now being started, now being stopped, has stopped, or is running in the reduced-operation mode.
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. A system call 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.

To Page Top