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

ajsagtalt

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.

-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, and custom 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.

e
Jobs are accepted and then delivered to the target host.

i
New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.

h
Jobs are accepted but are not delivered to the target host.

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

Return values

0 Normal end.

4

An environment variable used for command execution is incorrect.

The JP1/AJS3 service is not running.

The -h option is specified but the specified logical host does not exist or environment settings are incorrect.

The target host is starting operation, stopping operation, has stopped operation, or is operating in reduced mode.

The specified execution agent does not exist.

The specified execution agent group does not exist.

The authentication server is not running.

A compatible ISAM configuration is used.

8 An argument specified in the command is incorrect.

12 Memory became insufficient during command processing.

16 The database area is not enough. Alternatively, secondary allocation of the database area failed.

20 An attempt to access the database or shared memory failed because the access target was locked.

24 Permission to execute the command is not granted.

36

A database input or output error occurred.

An error occurred in communication with the JP1/AJS3 service or the JP1/AJS3 service does not respond.

40 A system limit was exceeded during allocation of shared memory, file descriptors, or resources for exclusive use.

120 An unexpected error was detected for an OS system call.

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

[Contents][Back][Next]

[Trademarks]

0	Normal end.
4	An environment variable used for command execution is incorrect. The JP1/AJS3 service is not running. The -h option is specified but the specified logical host does not exist or environment settings are incorrect. The target host is starting operation, stopping operation, has stopped operation, or is operating in reduced mode. The specified execution agent does not exist. The specified execution agent group does not exist. The authentication server is not running. A compatible ISAM configuration is used.
8	An argument specified in the command is incorrect.
12	Memory became insufficient during command processing.
16	The database area is not enough. Alternatively, secondary allocation of the database area failed.
20	An attempt to access the database or shared memory failed because the access target was locked.
24	Permission to execute the command is not granted.
36	A database input or output error occurred. An error occurred in communication with the JP1/AJS3 service or the JP1/AJS3 service does not respond.
40	A system limit was exceeded during allocation of shared memory, file descriptors, or resources for exclusive use.
120	An unexpected error was detected for an OS system call.
124	An unexpected error was detected in JP1/AJS internal processing.