Job Management Partner 1/Automatic Job Management System 3 Command Reference 2

jpqagtadd

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 concurrently executable number of jobs is limited with the following types of jobs: standard jobs (UNIX, PC, and QUEUE jobs), action jobs, and custom jobs. 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

1. 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.
2. 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.
3. 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. 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.

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 are 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. When creating an agent host whose setting is the same as the default value of the agent host defined in the configuration definition file for the submit job execution environment (jpqsetup.conf) to be used by the jpqimport command, you should follow the procedure below:
  
  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 you cannot specify agent IDs when you use the jpqagtadd command to register agent hosts. Agent IDs are automatically assigned in ascending order. If you want to specify agent IDs explicitly, you need to create a configuration definition file for the submit job execution environment and use the jpqimport command.
  

[Contents][Back][Next]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.