jpqagtadd
- Organization of this page
Format
jpqagtadd [-mh manager-host-name] -ah agent-host-name [-cp time-time=concurrently-executable-job-limit...]
Description
The jpqagtadd command adds an agent host to a manager host, and creates the default queue to which the agent host will connect.
Execution privileges
You must have the following JP1 privilege:
-
JP1_JPQ_Admin privilege
Arguments
-mh manager-host-name
Specify the name of the manager host to which you want to add an agent host.
You can specify a character string of 1 to 255 bytes.
By default, the system assumes the local host name.
-ah agent-host-name
Specify the name of the agent host you want to add.
You can specify a character string of 1 to 255 bytes.
-cp time-time=concurrently-executable-job-limit...
Specify the period for concurrently-executable job limits, as well as the concurrently-executable job limit for the period.
Specifying the concurrently-executable job limit allows you to limit the number of jobs that can be concurrently executed by this agent host. The command applies to queue jobs and submit jobs only.
Once the specified concurrently-executable job limit is reached, any extra ones will be queued (for waiting for execution) until the job is completed.
Specify the period by time and time hyphened. Specify the time in units of 30 minutes in the hh:mm format.
hh: You can specify 0, or 00 to 23 hours.
mm: You can specify 0, 00 or 30 minutes.
For the concurrently-executable job limit, you can specify 0 to 4,294,967,295.
By default, the system assumes the value of 00:00-00:00=0 (the 24-hour format with a limit value of 0).
If the maximum number of concurrently executable jobs is 0, you cannot execute the job. To execute the job, you must specify a value of 1 or larger or change the maximum number of concurrently executable jobs.
For an example of how to specify the maximum number of concurrently executable jobs, see also the Additional information for the jpqagtalt command.
You can specify multiple periods and numbers of concurrently-executable job limit. If you specify multiple periods, however, the values set later are reflected. (For example, if you set -cp 1:00-2:30=5 2:00-4:00=10, the number of concurrently-executable job limit for an overlapping period, 2:00 to 2:30 is 10.)
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.
-
If you omit the number of concurrently-executable jobs for a period, the default is 0. For example, the -cp 10:00-22:00=10 expression alone means that the limit value is 0 for the 00:00 to 10:00 period, 10 for the 10:00 to 22:00 period, and 0 for the 22:00 to 00:00 period.
-
Executing more than one jpqagtadd command in parallel requires a considerably long time for processing. If you want to add multiple agent hosts, add them one after another.
Return values
0 |
Normal end |
1 |
Invalid parameter value |
2 |
An attempt to add an agent host failed due to an internal cause of the host on which the jpqagtadd command was executed. |
5 |
Initialization has failed.
|
6 |
Memory became insufficient on the host on which the jpqagtadd command was executed. |
7 |
A logical error occurred on the host on which the jpqagtadd command was executed. |
100 |
The host on which the jpqagtadd 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 jpqagtadd command was executed. |
200 |
The manager host does not accept addition of an agent host.
|
202 |
The manager host has returned no response. |
203 |
Addition of an agent host failed due to an internal cause of the manager host. |
206 |
Permission to add an agent host is not granted. |
219 |
The manager host is busy. |
220 |
The manager host memory is insufficient. |
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 |
An agent host with the same name as the agent host you attempted to add already exists. |
235 |
The maximum number of agent host definitions has been exceeded. |
240 |
The event/action control manager is changing the agent host configuration definition. |
Additional informations
-
The following table shows the attributes of the default queue created when an agent host is added, the initial values of these attributes, and the commands that can be used to change the attribute values.
Items set for default queues
Attribute
Command used to change attribute
Concurrently-executable job limit
Value specified by the -cp option
Jpqagtalt
Maximum number of jobs
4,294,967,295
Jpqquealt
Warning number of jobs
4,294,967,295
Jpqquealt
State of job reception port
close
Jpqqueopen
State of job takeout port
open
Jpqqueclose
Agent hosts to be connected
Agent host name specified by the -ah option
jpqagtunlink, jpqagtlink
jpqagtlink
Priority of agent hosts
16
Jpqagtlink
-
Immediately after you use the jpqagtadd command to register agent hosts, you will not be able to register jobs because the queue entrance is closed. Use the jpqqueopen command to open the default queue entrance. You should also make sure that any registered agent host name can be resolved to the IP address. If you want to register an agent host whose settings are the same as the default values of the agent host that was registered by using the jpqimport command, use the following procedure:
-
Add an agent host to the manager host, and set the maximum number of concurrently executable jobs (indicated as concurrently-executable-job-limit below).
The default value of jpqsetup.conf is 24 hours, with 5 as the concurrently-executable-job-limit.
jpqagtadd -ah agent-host-name -cp concurrently-executable-job-limit
-
Open the default queue entrance.
jpqqueopen -ah agent-host-name -en
-
Change the maximum-number-of-jobs and the warning-value-for-job-count in a default queue.
By default, jpqsetup.conf provides a maximum value of 100 for the number of jobs and a warning value of 80 for the number of jobs.
jpqquealt -ah agent-host-name -mj maximum-number-of-jobs -wj warning-value-for-job-count
-
Change the priority of agent hosts to be connected.
By default, jpqsetup.conf provides a value of 1 for priority.
jpqagtlink -ah agent-host-name -lh agent-host-name -clp connection-destination-agent-host-priority
Note that agent IDs are automatically assigned when you use the jpqagtadd command to register agent hosts. If you want to explicitly specify agent IDs, use the jpqimport command to register agent hosts.
-