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
-
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.
-
Use the following method to set the environment setting parameters described in (2) below:
-
For environment setting parameters in the definition key [{JP1_DEFAULT|logical-host-name}\JP1NBQAGENT\Job]:
Execute the following command:
jajs_config -k definition-key "parameter-name"=value
-
For environment setting parameters in the definition key [JP1_DEFAULT\JP1QLAGENT]:
In an editor such as vi, create a configuration file that defines the environment setting parameters, 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 new settings are applied to the configuration definition.
(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:
-
2.3.2(90) IgnoreResultFileError in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
-
2.7.2(20) IgnoreResultFileError in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2
(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.8.1 Notes on the standard output file and standard error output file in the Job Management Partner 1/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.10 Automatic retry for abnormally ending jobs in the Job Management Partner 1/Automatic Job Management System 3 System Design (Work Tasks) Guide.