20.12.2 Details of the environment setting parameters for monitoring agents

(1) AGMMONITORING

Use this parameter to specify whether to use the job distribution delay reduction function.

Format

"AGMMONITORING" = "{no|yes}"

Specifiable values

no

Does not use the job distribution delay reduction function.

yes

Uses the job distribution delay reduction function.

Default value

no

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(2) AGMERRAGTSTATRESETTIME

Use this parameter to specify the time before the status of an execution agent changes from Unconnectable to Not checked.

This parameter takes effect if yes is set for the AGMMONITORING environment setting parameter.

Format

"AGMERRAGTSTATRESETTIME" = dword: time-before-status-of-execution-agent-changes-from-Unconnectable-to-Not-checked

Specifiable values

00000000, or a value (in seconds) from 00000258 to 00015180 in hexadecimal (0, or a value from 600 to 86,400 in decimal)

Default value

dword:00015180 (86,400 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

Usually, you do not need to change this value. Read the following description, and then change this value as necessary.

• When the amount of time specified for this parameter elapses, the status of the execution agent changes from Unconnectable to Not checked. When this occurs, the execution agent is no longer checked to see whether its communication status has recovered. As a result, an execution agent that is not expected to recover is no longer checked, and fewer ports are used. Note that, when the status of an execution agent changes to Not checked, the distribution of jobs to that execution agent resumes. However, if communication fails when the next job is distributed, the status of the execution agent changes back to Unconnectable.

• If you specify 0, the status of an execution agent does not change from Unconnectable to Not checked until a communication recovery check succeeds. In this case, because a communication recovery check is repeated until the status of all Unconnectable execution agents changes to Connectable, the number of ports to be used increases.

• For this environment setting parameter, specify a value greater than the value specified for the QueuingJobRecoveryTime environment setting parameter for the job execution environment.

  If you are using the default values for the following environment setting parameters for communication control, specify a value that is at least 300 seconds greater than the value specified for QueuingJobRecoveryTime environment setting parameter. If the value has been changed from its default value, set a value greater than the value calculated by using the estimation formula.

Environment setting parameters for communication control^#

• "ClientConnectTimeout" = dword:connection-timeout-period

• "ClientRetryInterval" = dword:connection-retry-interval

• "ClientRetryCount" = dword:number-of-connection-retries

Estimation formula for the AGMERRAGTSTATRESETTIME environment setting parameter:

a + b x (c + d) + 300

a: The QueuingJobRecoveryTime environment setting parameter

b: The ClientRetryCount environment setting parameter (number of connection retries)

c: The ClientConnectTimeout environment setting parameter (connection timeout period)

d: The ClientRetryInterval environment setting parameter (connection retry interval)

#

If the environment setting parameters for the following definition keys have been changed, you will need to estimate a value. Specify JP1_DEFAULT for the physical host. For logical-host-name, specify the name of a logical host.

• [{JP1_DEFAULT|logical-host-name}\JP1AJS2\HOST\NETWORK]

• [{JP1_DEFAULT|logical-host-name}\JP1AJS2\HOST\NETWORK\QUEUEMANAGER]

• [{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\scheduler-service-name\NETWORK\QUEUEMANAGER]

To Page Top

(3) AGMINTERVALFORRECOVER

Use this parameter to specify the interval at which to conduct a communication status recovery confirmation.

This parameter takes effect if yes is set for the AGMMONITORING environment setting parameter.

Format

"AGMINTERVALFORRECOVER" = dword: communication-status-recovery-confirmation-interval

Specifiable values

A hexadecimal value (in seconds) from 0000003C to 00000E20 (60 to 3,600 in decimal)

Default value

dword:000000B4 (180 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

You do not need to change the value for normal operation.

If you want to accelerate the recovery detection of the communication error, change the interval for communication status recovery confirmation by using this parameter. However, if you decrease the value of this parameter, the load on the network will increase when the status of a large number of execution agents is Unconnectable.

To Page Top

(4) AGMCONNECTTIMEOUT

Use this parameter to specify the time in which to conduct a communication status confirmation and communication status recovery confirmation (connection timeout).

This parameter takes effect if yes is set for the AGMMONITORING environment setting parameter.

Format

"AGMCONNECTTIMEOUT" = dword: time-for-conducting-communication-status-confirmation-and-communication-status-recovery-confirmation

Specifiable values

A hexadecimal value (in seconds) from 0000000A to 00000258 (10 to 600 in decimal)

Default value

dword:0000000A (10 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

Depending on the connection timeout specifications or settings of the OS, the connection might time out before the time set for this parameter expires.

When the status of an execution agent that is operating normally becomes Unconnectable, an attempt to perform communication status confirmation might time out. If this occurs, change the amount of time after which communication times out as specified by this parameter.

To Page Top

(5) AGMPUTSYSLOG

This parameter is used to specify the output destination of the following messages that are output by the job distribution delay reduction function:

• KNAC1701-W

• KNAC1702-I

• KNAC1703-W

• KNAC1704-I

• KNAC1705-E

• KNAC1706-I

• KNAC1707-I

• KNAC1708-I

• KNAC1709-E

• KNAC1710-E

• KNAC1711-E

• KNAC1713-I

• KNAC1714-I

• KNAC1774-E

• KNAC1775-E

• KNAC1776-E

• KNAC1801-E

• KNAC1802-E

• KNAC1803-E

• KNAC1804-E

• KNAC1805-E

• KNAC1806-E

• KNAC1807-E

• KNAC1808-E

• KNAC1809-E

• KAVT0351-W

This parameter takes effect if yes is set for the AGMMONITORING environment setting parameter.

Format

"AGMPUTSYSLOG" = {no|yes}

Specifiable values

no

Messages are output to the integrated trace log only.

yes

Messages are output to the integrated trace log, syslog, and Windows event log.

Default value

no

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top