Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


6.2.28 Setting to increase the maximum number of execution agents that can be registered in a manager host

By default, the maximum number of execution agents that can be registered in a manager host is set to 1,024. If you want to register more than 1,024 execution agents in the manager host, you can increase the maximum number of execution agents that can be registered in a manager host to 2,048.

This subsection describes how to increase the maximum number of execution agents that can be registered in a manager host.

Note that, if you cancel the increase of the maximum number of execution agents later, you will have to re-create the embedded database. Therefore, give due consideration before changing the setting of the maximum number. For details about how to cancel increasing the maximum number of execution agents, see (3) Procedure for canceling the increase of the maximum number of execution agents.

Organization of this subsection

(1) Definition procedure

  1. In Windows Control Panel, open the Services administrative tool, and stop the following service:

    • JP1/AJS3 service

  2. Execute the following command to set the environment setting parameters described in (2) below:

    jajs_config -k definition-key "parameter-name"=value
  3. Restart JP1/AJS3.

    The new settings are applied.

(2) Environment setting parameters

Table 6‒50: Environment setting parameter to set restrictions on file transmission

Definition key

Environment setting parameter

Explanation

[{JP1_DEFAULT|logical-host}\JP1AJS2\HOST]#

"AGENTLIMITEXTEND"=

Specifies settings to increase the maximum number of execution agents that can be registered in a manager host

#:

The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.

For details about the definition of this environment setting parameter, see 20.3.2(16) AGENTLIMITEXTEND.

(3) Procedure for canceling the increase of the maximum number of execution agents

If you cancel the increase of the maximum number of execution agents, you must re-create the embedded database.

The following describes how to re-create the embedded database and cancel the increase of the maximum number of execution agents:

  1. Delete execution agents so that the total number of registered agents is reduced to 1,024 or less.

  2. Back up the unit definition and execution agent information.

    If multiple scheduler databases are set up in one embedded database environment, back up all those scheduler databases.

    For details about how to perform the backup, see 2.2.3 Backing up the JP1/AJS3 - Manager setup information in the JP1/Automatic Job Management System 3 Administration Guide.

  3. Stop all the services that access the scheduler database. Such services include the JP1/AJS3 on the physical host and all logical hosts.

  4. Execute the following command to set 1 in the AGENTLIMITEXTEND environment setting parameter.

    jajs_config -k "[{JP1_DEFAULT|logical-host}\JP1AJS2\HOST]" "AGENTLIMITEXTEND"=dword:00000001
  5. Use the ajsembdbunset -e command to delete the embedded database environment.

    In a single embedded database environment, if you execute the ajsembdbunset command when multiple scheduler databases are set up, information about all the scheduler databases is deleted.

  6. Use the ajsembdbbuild command to create an embedded database.

    In the ajsembdbbuild command, specify arguments appropriately so that the embedded database environment to be built will be the same as the original environment (built before cancellation of the increase of the maximum number of execution agents).

  7. Use the ajsembdbsetup command to set up the embedded database.

    In the ajsembdbsetup command, specify arguments appropriately so that the embedded database environment to be set up will be the same as the original environment (set up before cancellation of the increase of the maximum number of execution agents).

    If you set up multiple scheduler databases for one embedded database environment, execute the ajsembdbsetup command repeatedly until all those scheduler databases are set up.

  8. Use the ajsembdbstop command to stop the embedded database.

  9. Start the JP1/AJS3 service.

  10. Restore the unit definition and execution agent information you backed up in step 2.

    If you have set up multiple scheduler databases for one embedded database environment, restore the unit definition and execution agent information for all those scheduler databases.

    For details, see 2.3.4 Recovering the JP1/AJS3 - Manager setup information in the JP1/Automatic Job Management System 3 Administration Guide.

  11. Register the required jobnet for execution.

    If jobnets have been registered for execution before cancellation of the increase of the maximum number, start the scheduler service (in cold-start mode) corresponding to the re-created embedded database.

(4) Notes

If you register additional execution agents after increasing the maximum number of execution agents, the time required to start the JP1/AJS3 service extends. If JP1/AJS3 startup time is being monitored by cluster software, you need to review the timeout setting in the cluster software. Therefore, after registering additional execution agents, check the startup time of the JP1/AJS3 service, and appropriately adjust the timeout setting in the cluster software.