6.2.24 Operation settings when job result file transfer fails
In JP1/AJS3, the job result file (standard output file or standard error output file) is transferred from the agent host to the manager host when a job process finishes.
If the transfer fails, the job status is set to Ended abnormally because the job result file cannot be checked on the manager host. Therefore, even though the job process has finished normally, the job status is treated as Ended abnormally because of the failure to transfer the job result file. However, note that in this state, you can set the job status to Ended normally by changing the operation settings after the failure.
The following is the procedure for specifying the settings.
- Organization of this subsection
(1) Definition procedure
-
In Windows Control Panel, open the Services administrative tool, and stop the following service:
-
When Standard is specified for Exec. Service of the job
JP1/AJS3 service
-
Queueless Agent is specified for Exec. Service of the job
JP1/AJS3 Queueless Agent 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
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 the services that you stopped in step 1.
The new settings are applied.
(2) Environment setting parameters
|
Definition key |
Environment setting parameter |
Explanation |
|---|---|---|
|
[{JP1_DEFAULT|logical-host}\JP1NBQAGENT\Job]#1 |
"IgnoreResultFileError"= |
Operation to be executed if an error occurs during the transfer processing for a job result file if Basic is specified for the service that is to execute the job |
|
[JP1_DEFAULT\JP1QLAGENT]#2 |
"IgnoreResultFileError"= |
Operation to be executed if an error occurs during the transfer processing of a job result file if Queueless is specified for the service that is to execute the job |
- #1:
-
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.
- #2:
-
This setting applies to both physical and logical hosts.
For details about the definition of these environment setting parameters, see the following:
(3) Notes
-
If you execute a job by using a jobnet and the standard error output file is not defined in the detailed definition of the job, a temporary standard error output file is created and transferred to the manager host. For details about the standard error output file, see 7.10.1 Notes on the standard output file and standard error output file in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
-
If the transfer of the job result file fails when 1 is specified for the IgnoreResultFileError environment setting parameter, the setting values of the NotfyJobStateInterval and NotfyJobStateCount environment setting parameters used to set the resending interval and the number of times for a job result file is resent do not take effect. This is because the job result file is not resent and completion of the job has priority. Also, for the same reason, you cannot view the contents of the standard error output file in the Execution result details dialog box in JP1/AJS3 - View.
-
For passing information setting jobs, the required information is retrieved from the standard output file of the preceding job and passed to the succeeding job. Therefore, if 1 is set for the IgnoreResultFileError environment setting parameter and an error occurs during transfer of the result file for the preceding job, a message (KAJS7622-E) is output and the passing information setting job might abnormally terminate.
-
If 0 is set for the IgnoreResultFileError environment setting parameter and a job result file transfer fails, -1 is set as the return code of the job and the job status is set to Ended abnormally. Therefore, even if you have set that the job is to be retried, the job is not retried automatically.
If 1 is set for the IgnoreResultFileError environment setting parameter and a job result file transfer fails, the return code of the job process is set as the return code of the job and the job status is set to Ended normally, Ended with warning, or Ended abnormally. Which value is set depends on how the end of processing is judged. If the job status is set to Ended abnormally and the condition for automatic job retry is satisfied, the job is retried automatically.
For details about automatic retrying, see 2.4.13 Automatic retry for abnormally ending jobs in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
-
If you specify 1 for the IgnoreResultFileError environment setting parameter, note the following:
If the size of transmitted files exceeds the upper limit, the running job ends abnormally when 1 is set for the SendFileSizeStatus setting environment parameter or ends with a warning when 2 is set for the SendFileSizeStatus environment setting parameter. Therefore, when you want to enable the IgnoreResultFileError environment setting parameter and prevent the data that exceeded the upper limit of the transmitted-file size from being transmitted, specify 3 for the SendFileSizeStatus environment setting parameter.
For details about the upper limit of the size of transmitted files, see 6.2.27 Placing restrictions on file transmission.