Completing manual jobs with exit codes

You can specify exit codes when completing manual jobs. The exit code you specify determines the state of the manual job. Exit codes can be any number from 0 to 255.

If you did not define custom success exit codes in the Manual Job Definition, an exit code of 0 indicates the manual job was successful and the state is set to Done. Any other exit code indicates the manual job failed and its state is set to Exit.

If you defined custom success exit codes in the Manual Job Definition, an exit code of 0 and any of the numbers you specified in the Non-zero success exit codes field indicates the manual job was successful and the state is set to Done. Any other exit code indicates the manual job failed and its state is set to Exit.

Complete a manual job with an exit code

Procedure

  1. In Flow Manager, select the manual job, right-click and select Complete Manual Job.
  2. In the Exit code field, enter the exit code for the job.
  3. Click the Complete Manual Job button.

    You can view the exit code you entered by selecting the manual job, right-clicking and choosing View Runtime Attributes.

From the command-line

Use the jcomplete command with the -e option.

Example: Complete a manual job with exit code 4

jcomplete -d "printed check numbers 4002 to 4532" -e 4 -i 42 payprt:checkprinter

completes the manual job checkprinter with exit code 4 in the flow payprt with flow ID 42, and adds the comment "printed check numbers 4002 to 4532".