6.2.20 Placing all running jobs in an end status when a communication error occurs
JP1/AJS3 periodically (at five-minute intervals) performs polling to monitor running jobs (PC and Unix jobs that are not queueless jobs, and queue, action, and custom jobs executed on JP1/AJS3).
If a communication error occurs during the monitoring on the agent host on which a job is to be executed, JP1/AJS3 does not immediately declare an abnormal end. Instead, it retries communication for a specified period of time (default: 10 minutes) while waiting for recovery from the system or communication error on the agent host. If the error is a temporary, recoverable error, then operation is not stopped needlessly.
If there has been no recovery on the agent host when the polling period ends, jobs are placed in an end status# one by one in order by expiration of a job's wait time for recovery. However, if many jobs are being executed, a long time might be required before all jobs have been placed in an end status. In some cases, therefore, depending on the operation, immediate recovery will have precedence over waiting for recovery in the event of an error. For these cases, you can specify settings so that all jobs being executed on the same agent host are immediately paced in an end status# if there has been no error recovery on the agent host when the polling period ends. For the jobs in an execution agent group, these settings are applied to the jobs that are running on the same agent host. Immediately placing jobs in an end status enables recovery action to be taken sooner.
- #:
-
For a job defined in a jobnet, the job status changes to Killed, and -1 is set as the return code. For a submit job executed by the jpqjobsub command, the job status changes to the status specified by the -rs option (the default is Hold).
The following describes how to specify the settings for placing all running jobs in an end status when a communication error occurs.
- Organization of this subsection
(1) Definition procedure
-
In Windows Control Panel, open the Services administrative tool, and stop the following service:
-
JP1/AJS3 service
- Cautionary note:
-
In a cluster system, check the cluster settings, and also stop the JP1/AJS3 service on each logical host.
-
-
Execute the following command to set the environment setting parameter described in (2) below:
jajs_config -k definition-key "parameter-name"=value
-
Restart the service that you stopped in step 1.
The new settings are applied.
(2) Environment setting parameter
|
Definition key |
Environment setting parameter |
Explanation |
|---|---|---|
|
"ExecutingJobChangeStatus"= |
Specifies that all running jobs are placed in an end status when a communication error occurs. |
- #:
-
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 2.3.2(23) ExecutingJobChangeStatus in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2.