jpqagtadd

Organization of this page

Format
Description
Execution privileges
Arguments
Notes
Return values
Additional information

Format

jpqagtadd
     [-mh manager-host-name]
     -ah agent-host-name
     [-cp time-time=concurrently-executable-job-limit...]

To Page Top

Description

The jpqagtadd command adds an agent host to a manager host, and creates the default queue to which the agent host will connect.

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 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.)

To Page Top

Notes

This command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.
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.

To Page Top

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. The definition of the logical host name or the environment setting contains an error.
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. The host on which the `jpqagtadd` command was executed cannot connect to the manager host because TCP/IP is not set up correctly. The manager host name is invalid, or the manager host process stopped.
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. The manager host is now being started, now being stopped, has stopped, or is running in the reduced-operation mode.
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. 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	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.

To Page Top

Additional information

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:
1. 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
2. Open the default queue entrance.
  
  jpqqueopen -ah agent-host-name -en
3. 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
4. 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.

To Page Top