|Top Previous Next
In any client-server environment there can be problems submitting jobs to the server. The problems can be a result of a network problem, or a license problem, or just a mistake in the client command line, such as a bad rule file or output destination. In the client's uf100c.ini file, a failhist=days value can be specified so the client will retain job input, command lines, and error messages when a job fails to run at the server.
When this parameter is set to a number greater than 0, then the client will store failure history so that the failed jobs can be resubmitted, optionally with overridden command line options to correct problems related to command line mistakes.
Failed Job Storage
The queue for failed jobs is found in one of two places:
Under this directory, history is stored by date in directories formatted as yyyymmdd. Each failed job is stored with three files. A .in file contains the job's print stream, a .arg file contains the job's command line arguments, and a .err file contains the error message pertaining to that job's failure.
Failed job history is maintained for the number of days specified in the failhist parameter of uf100c.ini. Directories older than that date in the failhist directory are removed as jobs are run.
To re-run a job, or several jobs, you use the command line client, uf100c on Linux or uf100cc.exe on Windows, with the -rerun option. Arguments before the -rerun option are used as overrides to any found in the failed job's arguments file, so you can use this to fix problems with the original command line. For example, if jobs failed because of a bad rule file name, you can specify a new rule file with -f correctname.rul in the command line before the -rerun option.
After the -rerun should be one or more file name references from the failhist directory structure. These names can be plain file names or full path names. They can include any of the .in, .arg, or .err extensions. The process of re-running jobs normalizes the names. There are three special circumstances: