Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1

14.2.8 Changing the interval and number of retry attempts when a TCP/IP connection error occurs

As job execution control, TCP/IP is used to pass information between the processes for registering and delivering jobs, reporting and checking the job status, and checking the agent host status. However, if the host to be connected to is not running or if a network error has occurred, TCP/IP connection fails.

If the other host does not respond to a TCP/IP connection request, job execution control first waits for a maximum of 90 seconds for a response, and then makes two retry attempts at 20-second intervals (under the default settings). If both attempts fail, four or five minutes might pass before the connection finally resulted in an error.

If a communication error occurs during processing that registers or delivers a job, reports or checks the job status, or checks the agent host status, detection of the error might be delayed. This delay might result in a further delay in changing the job status.

If TCP/IP connection errors are frequent, you can set smaller values for the connection timeout value, the number of retry attempts, and the retry interval to speed up the detection of an error.

For details about changing the settings for delivering jobs to agent hosts, checking the job status, and checking the agent host status on the manager side, see 2.6 Setting up the communication control environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2.

The following table lists the definition keys for which values are to be changed, and their purpose.

Table 14-15 Definition keys for which values are to be changed

Definition key Purpose

For all scheduler services
JP1AJS2\SCHEDULER\QUEUE\MANAGER\Network

For a specific scheduler service
JP1AJSMANAGER\scheduler-service\QUEUE\MANAGER\Network

For submit jobs and a compatible ISAM configuration
JP1NBQMANAGER\Network

Reporting the job status

JP1NBQAGENT\Network Reporting the job status

JP1NBQCLIENT\Network Registering a job from the scheduler and executing a job from a command

For all scheduler services
JP1AJS2\SCHEDULER\QUEUE\NOTIFY\Network

For a specific scheduler service
JP1AJSMANAGER\scheduler-service\QUEUE\NOTIFY\Network

For submit jobs and a compatible ISAM configuration
JP1NBQNOTIFY\Network

Checking the job status on another system (such as JP1/NQSEXEC or JP1/OJE) and reporting the status

The following describes how to set the connection timeout value, retry interval, and number of retry attempts in job execution control.

Note that the procedure described below is not necessary if the queueless job execution facility is used.

Organization of this subsection

(1) Definition procedure

(2) Environment setting parameters

Definition key	Purpose
For all scheduler services JP1AJS2\SCHEDULER\QUEUE\MANAGER\Network For a specific scheduler service JP1AJSMANAGER\scheduler-service\QUEUE\MANAGER\Network For submit jobs and a compatible ISAM configuration JP1NBQMANAGER\Network	Reporting the job status
JP1NBQAGENT\Network	Reporting the job status
JP1NBQCLIENT\Network	Registering a job from the scheduler and executing a job from a command
For all scheduler services JP1AJS2\SCHEDULER\QUEUE\NOTIFY\Network For a specific scheduler service JP1AJSMANAGER\scheduler-service\QUEUE\NOTIFY\Network For submit jobs and a compatible ISAM configuration JP1NBQNOTIFY\Network	Checking the job status on another system (such as JP1/NQSEXEC or JP1/OJE) and reporting the status

(1) Definition procedure

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 parameters described in (2) below:
 
jajs_config -k definition-key "parameter-name-1"=value-1
["parameter-name-2"=value-2] 
["parameter-name-3"=value-3]
 
You can specify only one definition key. If you want to set environment setting parameters for different definition keys, you must execute the jajs_config command for each definition key.
Restart JP1/AJS3.
The new settings are applied.

(2) Environment setting parameters

Table 14-16 Environment setting parameters for job execution control

No. Definition key Environment setting parameter Explanation

1

For all scheduler services
[{JP1_DEFAULT|logical-host}\JP1AJS2\SCHEDULER\QUEUE\MANAGER\Network]^#

For a specific scheduler service
[{JP1_DEFAULT|logical-host}\JP1AJSMANAGER\scheduler-service\QUEUE\MANAGER\Network]^#

For submit jobs and a compatible ISAM configuration
[{JP1_DEFAULT|logical-host}\JP1NBQMANAGER\Network]^#

"ConnectTimeout"= Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by the job execution control manager.

2 "CommunicateRetryCount"= Defines the maximum number of retry attempts for a TCP/IP connection attempted by the job execution control manager.

3 "CommunicateRetryInterval"= Defines the retry interval (in seconds) for a TCP/IP connection attempted by the job execution control manager.

4 [{JP1_DEFAULT|logical-host}\JP1NBQAGENT\Network]^# "ConnectTimeout"= Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by the job execution control agent.

5 "CommunicateRetryCount"= Defines the maximum number of retry attempts for a TCP/IP connection attempted by the job execution control agent.

6 "CommunicateRetryInterval"= Defines the retry interval (in seconds) for a TCP/IP connection attempted by the job execution control agent.

7 [{JP1_DEFAULT|logical-host}\JP1NBQCLIENT\Network]^# "ConnectTimeout"= Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by job execution commands and the scheduler.

8 "CommunicateRetryCount"= Defines the maximum number of retry attempts for a TCP/IP connection attempted by job execution commands and the scheduler.

9 "CommunicateRetryInterval"= Defines the retry interval (in seconds) for a TCP/IP connection attempted by job execution commands and the scheduler.

10

For all scheduler services
[{JP1_DEFAULT|logical-host}\JP1AJS2\SCHEDULER\QUEUE\NOTIFY\Network]^#

For a specific scheduler service
[{JP1_DEFAULT|logical-host}\JP1AJSMANAGER\scheduler-service\QUEUE\NOTIFY\Network]^#

For submit jobs and a compatible ISAM configuration
[{JP1_DEFAULT|logical-host}\JP1NBQNOTIFY\Network]^#

"ConnectTimeout"= Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by the process that reports the job execution control status.

11 "CommunicateRetryCount"= Defines the maximum number of retry attempts for a TCP/IP connection attempted by the process that reports the job execution control status.

12 "CommunicateRetryInterval"= Defines the retry interval (in seconds) for a TCP/IP connection attempted by the process that reports the job execution control status.

#:

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 these environment setting parameters, see the following:

2.3(24) ConnectTimeout in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(25) CommunicateRetryCount in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(26) CommunicateRetryInterval in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(67) ConnectTimeout in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(68) CommunicateRetryCount in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(69) CommunicateRetryInterval in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(75) ConnectTimeout in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(76) CommunicateRetryCount in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(77) CommunicateRetryInterval in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(81) ConnectTimeout in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(82) CommunicateRetryCount in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

2.3(83) CommunicateRetryInterval in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2

No.	Definition key	Environment setting parameter	Explanation
1	For all scheduler services [{JP1_DEFAULT\|logical-host}\JP1AJS2\SCHEDULER\QUEUE\MANAGER\Network]^# For a specific scheduler service [{JP1_DEFAULT\|logical-host}\JP1AJSMANAGER\scheduler-service\QUEUE\MANAGER\Network]^# For submit jobs and a compatible ISAM configuration [{JP1_DEFAULT\|logical-host}\JP1NBQMANAGER\Network]^#	"ConnectTimeout"=	Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by the job execution control manager.
2	"CommunicateRetryCount"=	Defines the maximum number of retry attempts for a TCP/IP connection attempted by the job execution control manager.
3	"CommunicateRetryInterval"=	Defines the retry interval (in seconds) for a TCP/IP connection attempted by the job execution control manager.
4	[{JP1_DEFAULT\|logical-host}\JP1NBQAGENT\Network]^#	"ConnectTimeout"=	Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by the job execution control agent.
5	"CommunicateRetryCount"=	Defines the maximum number of retry attempts for a TCP/IP connection attempted by the job execution control agent.
6	"CommunicateRetryInterval"=	Defines the retry interval (in seconds) for a TCP/IP connection attempted by the job execution control agent.
7	[{JP1_DEFAULT\|logical-host}\JP1NBQCLIENT\Network]^#	"ConnectTimeout"=	Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by job execution commands and the scheduler.
8	"CommunicateRetryCount"=	Defines the maximum number of retry attempts for a TCP/IP connection attempted by job execution commands and the scheduler.
9	"CommunicateRetryInterval"=	Defines the retry interval (in seconds) for a TCP/IP connection attempted by job execution commands and the scheduler.
10	For all scheduler services [{JP1_DEFAULT\|logical-host}\JP1AJS2\SCHEDULER\QUEUE\NOTIFY\Network]^# For a specific scheduler service [{JP1_DEFAULT\|logical-host}\JP1AJSMANAGER\scheduler-service\QUEUE\NOTIFY\Network]^# For submit jobs and a compatible ISAM configuration [{JP1_DEFAULT\|logical-host}\JP1NBQNOTIFY\Network]^#	"ConnectTimeout"=	Defines the timeout value (in milliseconds) for a TCP/IP connection attempted by the process that reports the job execution control status.
11	"CommunicateRetryCount"=	Defines the maximum number of retry attempts for a TCP/IP connection attempted by the process that reports the job execution control status.
12	"CommunicateRetryInterval"=	Defines the retry interval (in seconds) for a TCP/IP connection attempted by the process that reports the job execution control status.

[Contents][Back][Next]

[Trademarks]