ajsagtalt
- Organization of this page
Format
ajsagtalt [-h logical-host-name] {-a execution-agent-name [-s execution-host-name] [-c time-time=maximum-number-of-concurrently-executable-jobs,...] [-d description] | -a execution-agent-name -t {e|i|h|b} | -g execution-agent-group-name -d comment | -g execution-agent-group-name -l execution-agent-name[:priority] | -g execution-agent-group-name -m execution-agent-name[:priority] | -g execution-agent-group-name -u execution-agent-name | -g execution-agent-group-name -t {e|i|h|b}}
Format1 (for changing the execution agent settings)
ajsagtalt [-h logical-host-name] -a execution-agent-name [-s exec-host-nam] [-c time-time=maximum-number-of-concurrently-executable-jobs,...] [-d description]
Format2 (for changing the execution agent group settings)
ajsagtalt [-h logical-host-name] -g execution-agent-group-name -d description
Format3 (for adding an execution agent to an execution agent group)
ajsagtalt [-h logical-host-name] -g execution-agent-group-name -l execution-agent-name[:priority]
Format4 (for changing the priority of an execution agent in an execution agent group)
ajsagtalt [-h logical-host-name] -g execution-agent-group-name -m execution-agent-name[:priority]
Format5 (for removing an execution agent from an execution agent group)
ajsagtalt [-h logical-host-name] -g execution-agent-group-name -u execution-agent-name
Format6 (for changing the job transfer restriction status of an execution agent)
ajsagtalt [-h logical-host-name] -a execution-agent-name -t {e|i|h|b}
Format7 (for changing the job transfer restriction status of an execution agent group)
ajsagtalt [-h logical-host-name] -g execution-agent-group-name -t {e|i|h|b}
Description
The ajsagtalt command changes the settings of an execution agent or execution agent group, or changes the job transfer restriction status of an execution agent or execution agent group.
Execution privileges
This command can be executed by a user at either of the following JP1 permission levels:
-
JP1_JPQ_Admin privilege
-
JP1_JPQ_Operator privilege(Users at this permission level can change only the job transfer restriction status of an execution agent or execution agent group.)
Arguments
-h logical-host-name
Specify the logical host name of the local host on which the execution agent or execution agent group whose settings you want to change is registered.
You can specify a character string of 1 to 255 bytes.
If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed.
For a physical host, make sure that you specify neither this option nor the JP1_HOSTNAME environment variable.
-a execution-agent-name
Specify the name of the execution agent whose settings you want to change.
You can specify a character string of 1 to 255 bytes.
-g execution-agent-group-name
Specify the name of the execution agent group whose settings you want to change.
You can specify a character string of 1 to 255 bytes.
-s exec-host-nam
Specify the execution host name (agent host name).
You can specify a character string of 1 to 255 bytes.
You can specify this option only if the -a option is specified.
The name of the execution host to be specified must be resolved correctly. Before executing the command, set the name of the execution host to be specified in the hosts file or on a DNS server. If an execution host name that a manager host cannot resolve is specified, command execution might take a long time.
For details about name resolution, see 2.2.2(5) Notes on manager/agent system configurations in the Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide.
-c time-time=maximum-number-of-concurrently-executable-jobs,...
Specify the time periods for which you want to change the maximum number of concurrently executable jobs, together with the new values for the maximum number of concurrently executable jobs.
By specifying the maximum number of concurrently executable jobs, you can limit the number of jobs that can concurrently be executed on this execution agent. The specified limit is applied to UNIX, PC, action, custom, and passing information setting jobs. If an attempt is made to execute a job when the number of concurrently executing jobs has already reached the maximum, the job is queued to wait until the number of concurrently executing jobs becomes smaller than the maximum.
The time period is specified by using the start and end times separated by a hyphen (-). Both times are specified in hh:mm format where mm is specified in units of 30 minutes.
For hh, you can specify 0 or a value in the range from 00 to 23 (hours).
For mm, you can specify 0, 00, or 30 (minutes).
For maximum-number-of-concurrently-executable-jobs, you can specify a value from 0 to 4,294,967,295.
You can specify multiple combinations of time period and maximum number of concurrently executable jobs. To do this, use a comma (,) to separate each occurrence of time-time=maximum-number-of-concurrently-executable-jobs without inserting a space. You can specify a maximum of 48 time periods. If you specify overlapping time periods, the last specified value takes effect for the maximum number of concurrently executable jobs. For example, if you specify -c 1:00-2:30=5,2:00-4:00=10, the time period from 2:00 to 2:30 overlaps. For this time period, 10 is applied as the maximum number of concurrently executable jobs.
For time periods that are not specified, the maximum number of concurrently executable jobs is not changed.
If the command is executed during a specified time period, the maximum number of concurrently executable jobs for the time period is immediately changed.
You can specify this option only if the -a option is specified.
-d description
Specify a comment on the execution agent or execution agent group.
You can specify a character string of 1 to 80 bytes.
You can specify this option only if the -a or -g option is specified.
-l execution-agent-name[:priority]
Specify the name of an execution agent to be associated with the execution agent group. Following the execution agent name, you can also specify the priority of the execution agent in the execution agent group. If you specify the priority, place a colon (:) as a separator between the execution agent name and the priority.
Make sure that you specify an execution agent name that has already been registered.
You can use 1 to 255 bytes to specify an execution agent name.
As the priority value, you can specify 1 to 16 where 1 is lowest and 16 is highest. A job with a higher priority value is executed earlier. If the priority is omitted, 16 is assumed.
You can specify this option only if the -g option is specified.
-m execution-agent-name[:priority]
Specify this option if you want to change the priority of an execution agent in the execution agent group. Specify the execution agent name and the new priority with an intervening colon (:).
You can use 1 to 255 bytes to specify the execution agent name.
As the priority value, you can specify 1 to 16 where 1 is lowest and 16 is highest. A job with a higher priority value is executed earlier. If the priority is omitted, 16 is assumed.
You can specify this option only if the -g option is specified.
-u execution-agent-name
Specify the name of an execution agent you want to remove from the execution agent group.
You can specify a character string of 1 to 255 bytes.
You can specify this option only if the -g option is specified.
-t {e|i|h|b}
Specify this option if you want to change the job transfer restriction status of an execution agent or execution agent group to be added.
Value |
Status |
Description |
---|---|---|
e |
Effective |
Jobs are accepted and then delivered to the target host. |
i |
Ineffective |
New jobs are not accepted but the jobs that have already been accepted are delivered to the target host. |
h |
Hold |
Jobs are accepted but are not delivered to the target host. |
b |
Blockade |
Jobs are neither accepted nor delivered to the target host. |
You can specify this option only if the -a or -g option is specified.
Notes
-
The maximum number of concurrently executable jobs, the job transfer restriction status, and the execution agent priority specified by this command are not applied to event jobs.
-
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.
-
This command cannot be executed for JP1/AJS3 - Manager installed on another host.
-
If any jobs (PC jobs, UNIX jobs, custom jobs, or action jobs) are running, you must include an execution agent in an execution agent group.
-
If any jobs (PC jobs, UNIX jobs, custom jobs, action jobs, or even jobs) are running, you cannot change the execution host.
-
You cannot change the execution host used as the default execution agent (named @SYSTEM). For details about the default execution agent, see 5.1.4 Default execution agent in the manual Job Management Partner 1/Automatic Job Management System 3 Overview.
-
Consecutive single-byte space characters at the end of explanatory text might become invalid. Do not end explanatory text with single-byte space characters.
Return values
0 |
Normal end. |
4 |
|
8 |
An argument specified in the command is incorrect. |
12 |
Memory became insufficient during command processing. |
20 |
An attempt to access shared memory failed because the access target was locked. |
24 |
Permission to execute the command is not granted. |
40 |
A system limit was exceeded during allocation of shared memory, file descriptors, or resources for exclusive use. |
120 |
|
124 |
An unexpected error was detected in JP1/AJS internal processing. |
Example 1
To change the maximum number of concurrently executable jobs to 1 for the time period from 1:00 to 5:00 on execution agent AP1, execute the following command:
ajsagtalt -a AP1 -c 01:00-05:00=1
Example 2
To add execution agent AP2 (with a priority of 1) to execution agent group APG1, execute the following command:
ajsagtalt -g APG1 -l AP2:1
Example 3
To remove execution agent AP3 from execution agent group APG1, execute the following command:
ajsagtalt -g APG1 -u AP3