Universal Submit Job Return Codes

Return Codes

The Universal Submit Job command completes by sending an escape message to the external message queue. The severity code of this escape message is the USBMJOB return code.

The USBMJOB return code is determined in the following way:

When the submitted job completes, USBMJOB scans the job log, examining the severity code of all *ESCAPE, *NOTIFY, *STATUS, and function check messages.

  • If the submitted job completed abnormally (end code > 10), the USBMJOB return code will be set to the highest severity code examined in the submitted job's job log.
  • If the submitted job completes normally (end code < 20), the examined severity codes will be ignored and the USBMJOB return code will be set to 0.

Setting the return code with an escape message allows the Universal Command Server to pick up the return code for use in its return code processing.

The range of possible severity code values is 0 through 99.

If USBMJOB encounters a processing error, a severity code of 99 will be used, regardless of severity codes that may have been examined from the submitted job.