15.3.14 Changing the send retry interval and the number of retries for sending unreported information
If inter-process communication between the event/action control manager and the event/action control agent fails for a reason such as a busy network or a defective line, the information that could not be sent is managed as unreported information.
The following describes the default values for the send retry interval and the maximum number of retries.
- For a resend from the manager host to the agent host:
-
The values for the send retry interval and the maximum number of retries vary according to the type of error that has occurred.
- Error 1: When connection to the agent host times out
-
The send retry interval is 300 seconds for the first retry, 600 seconds for the second retry, 900 seconds for the third retry, 1,800 seconds for the fourth retry, and 3,600 seconds for the fifth and subsequent retries. The maximum number of retries is 27 (24 hours).
- Error 2: In all other cases
-
The send retry interval is 30 seconds, and the maximum number of send retries is 2,880 (24 hours).
- For the resending of information from the agent host to the manager host (resending information when a monitoring condition for an event job is satisfied, including event jobs defined as start conditions):
-
Irrespective of the type of error, the send retry interval is 10 seconds, and the maximum number of send retries is 8,640 (for a total of 24 hours).
You can change the send retry interval and the maximum number of retries for resending unreported information both from the manager host to the agent host due to error 2, and from the agent host to the manager host. Note, however, that changing these settings changes the resend processing from the manager host to the agent host as described below.
- Before the settings are changed:
-
Regardless of the type of error that has occurred, send retries end after 24 hours.
- After the settings are changed:
-
Send retries end when either of the following occurs:
-
Error 1 repeats during the 24 hours.
-
Error 1 or Error 2 occurs and the number of send retries has reached the maximum.
-
Therefore, if the settings are changed when both Error 1 and Error 2 have occurred, the completion of a resend operation could take a long time. This problem can be prevented by specifying the settings that apply the same send retry interval and maximum number of send retries regardless of whether Error 1 or Error 2 occurs.
For details, see 15.3.13 Settings for ensuring that the sending of unreported information is retried at regular intervals.
Use the procedure below for changing the settings.
- Organization of this subsection
(1) Definition procedure
(a) For a standard configuration
-
Stop the JP1/AJS3 service.
Execute the following commands to confirm that all processes have stopped:
# /etc/opt/jp1ajs2/jajs_stop#1 # /opt/jp1ajs2/bin/jajs_spmd_status
- #1:
-
Confirm that automatic termination has been set.
-
Execute the following command to set the environment setting parameter described in (2) below:
jajs_config -k definition-key "parameter-name"=value
-
Restart JP1/AJS3.
The new settings are applied.
(b) For a compatible ISAM configuration
-
Stop the JP1/AJS3 service.
Execute the following commands to confirm that all processes have stopped:
# /etc/opt/jp1ajs2/jajs_stop#1 # /opt/jp1ajs2/bin/jajs_spmd_status
- #1:
-
Confirm that automatic termination has been set.
-
In an editor such as vi, create a configuration file that defines the environment setting parameter described in (2) below.
-
Save the file and then execute the following command:
jbssetcnf configuration-file-name
The path of the jbssetcnf command is /opt/jp1base/bin/jbssetcnf. For details on this command, see the Job Management Partner 1/Base User's Guide.
-
Restart JP1/AJS3.
The contents of the configuration file are applied to the system.
(2) Environment setting parameter
|
Definition key |
Environment setting parameter |
Explanation |
|---|---|---|
|
"NotificationRetryInterval"= |
Interval for retrying the sending of unreported information |
|
"NotificationRetryCount"= |
Maximum number of retries for sending unreported information |
- #:
-
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 defining the environment setting parameters for communication from the manager host to the agent host, see the following:
-
2.4.2(10) NotificationRetryInterval in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
-
2.4.2(11) NotificationRetryCount in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
For details about defining the environment setting parameters for communication from the agent host to the manager host, see the following:
-
2.4.2(24) NotificationRetryInterval in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
-
2.4.2(25) NotificationRetryCount in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2