Precheck Job Exit Handling Methods

Follow

If users wish to have a Precheck job exit with a specific status the following can be used:

exit <<JAMS_ECANCELJOB>> 

 

Which will exit the precheck job with an Error Severity.

A user could also use:

<<JAMS.Message.CancelJobSuccess>>

 

OR

$Host.SetShouldExit(<<JAMS.Message.CancelJobError>>)

 

This Parameter is defined in the JAMS reference manual:

 

A Precheck Job has four options.

  1. It can loop, waiting for the prerequisites.
  2. It can exit with the status JAMS_TRYAGAIN and JAMS will resubmit the Precheck Job after the precheck interval has elapsed.
  3. It can exit with a bad status and JAMS will perform normal notification actions and then resubmit the Precheck job after the precheck interval has elapsed.
  4. It can exit with the status JAMS_xCANCELJOB, where x is S, I, W, E or F and denotes the severity of the status. JAMS will cancel the Job which caused the Precheck to run and the final status of the Job which caused the Precheck to run will be the status which the Precheck Job returned.
 

If the Precheck Job is parsed or jacketed then the following predefined parameters are available, and defined as DCL symbols:

 

JAMS_TRYAGAIN The integer value of the status JAMS_TRYAGAIN.
JAMS_SCANCELJOB The integer value of the status JAMS_SCANCELJOB.
JAMS_ICANCELJOB The integer value of the status JAMS_ICANCELJOB.
JAMS_WCANCELJOB The integer value of the status JAMS_WCANCELJOB.
JAMS_ECANCELJOB The integer value of the status JAMS_ECANCELJOB.
JAMS_FCANCELJOB The integer value of the status JAMS_FCANCELJOB.
JAMS_CANCELJOB The integer value of the status JAMS_CANCELJOB. This status is also an E level status and is included for backwards compatibility.
JAMS_PRECHECK_ENTRY The entry number of the Job which this Job is doing the checking for.
JAMS_PRECHECK_COUNT The number of times that the Precheck Job has run for this entry.



Have more questions? Submit a request

Comments