Fixing Recovery Problems

Note: This information pertains only to jobs submitted using the lacobrts utility.

The lacobrts process has several return codes that determine if a step was successful. The UNIX shell automatically interprets the return code when lacobrts is run from the command line or from a shell script. Third-party products that start the lacobrts process must obtain and interpret the lacobrts return code. See the manufacturer's documentation for the batch job scheduler you are using to determine how this works.

The lacobrts process calls the C-language exit function with the return code parameters listed in the following table. The return values are obtained from the WS-RETURN-CODE working storage section in the application program.

Note: See the UNIX man pages for information about the C-language exit function. For information on how to interpret a UNIX return code, see the UNIX man pages for the C-language wait function.


Return Code	Interpretation
0	Step Successful
1 - or - Any Signal	Needs Recovery
2	Invalid Parameters
3	Process Terminated Due to Deadlock Time-out (SQL Databases Only)

If a report fails with a status of 1 or receives a signal, investigate the log to determine the error. Once the error is fixed, re-run the lacobrts command to continue the job. If a report fails with an error of 2, correct the parameter and resubmit the job.

Note: If you choose not to recover the job, you must delete the record that the running job created in the CKPOINT file in the Environment database. This is similar to deleting a Needs Recovery job from the Job Scheduler.