15.2.22 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
(2) Environment setting parameters
(3) Notes

(1) Definition procedure

Stop the JP1/AJS3 service.

Execute the following commands to confirm that all processes have stopped:

- When Standard is specified as Exec. Service of the job
```
# /etc/opt/jp1ajs2/jajs_stop^#1
# /opt/jp1ajs2/bin/jajs_spmd_status
```
#1:

Confirm that automatic termination has been set.

- When Queueless Agent is specified as Exec. Service of the job (when the job is a queueless job)
```
# /opt/jp1ajs2/bin/ajsqlstop
# /opt/jp1ajs2/bin/ajsqlftpstop^#1
# /opt/jp1ajs2/bin/ajsqlstatus
```
#1:

This command must be executed only on JP1/AJS3 - Manager.
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 JP1/AJS3.

The new settings are applied to the configuration definition.

To Page Top

(2) Environment setting parameters

Table 15‒44: Environment setting parameter for operation settings when the transfer of job result files fail
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:

To Page Top

(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.11.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 15.2.24 Placing restrictions on file transmission.

To Page Top