LSB_BJOBS_CONSISTENT_EXIT_CODE

Syntax

LSB_BJOBS_CONSISTENT_EXIT_CODE=Y | N

Description

When LSB_BJOBS_CONSISTENT_EXIT_CODE=Y, the bjobs command exits with 0 only when unfinished jobs are found, and 255 when no jobs are found, or a non-existent job ID is entered.

No jobs are running:
bjobs
No unfinished job found
echo $?
255
Job 123 does not exist:
bjobs 123
Job <123> is not found
echo $?
255
Job 111 is running:
bjobs 111
JOBID   USER    STAT  QUEUE      FROM_HOST   EXEC_HOST   JOB_NAME   SUBMIT_TIME
111     user1   RUN   normal     hostA       hostB       myjob      Oct 22 09:22
echo $?
0
Job 111 is running, and job 123 does not exist:
bjobs 111 123
JOBID   USER    STAT  QUEUE      FROM_HOST   EXEC_HOST   JOB_NAME   SUBMIT_TIME
111     user1 RUN   normal     hostA hostB myjob Oct 22 09:22
Job <123> is not found
echo $?
255
Job 111 is finished:
bjobs 111
No unfinished job found 
echo $?
255

When LSB_BJOBS_CONSISTENT_EXIT_CODE=N, the bjobs command exits with 255 only when a non-existent job ID is entered. bjobs returns 0 when no jobs are found, all jobs are finished, or if at least one job ID is valid.

No jobs are running:
bjobs
No unfinished job found 
echo $?
0
Job 123 does not exist:
bjobs 123
Job <123> is not found
echo $?
0
Job 111 is running:
bjobs 111
JOBID   USER    STAT  QUEUE      FROM_HOST   EXEC_HOST   JOB_NAME   SUBMIT_TIME
111     user1 RUN   normal     hostA hostB myjob Oct 22 09:22
echo $?
0
Job 111 is running, and job 123 does not exist:
bjobs 111 123
JOBID   USER    STAT  QUEUE      FROM_HOST   EXEC_HOST   JOB_NAME   SUBMIT_TIME
111     user1 RUN   normal     hostA hostB myjob Oct 22 09:22
Job <123> is not found
echo $?
255
Job 111 is finished:
bjobs 111
No unfinished job found 
echo $?
0

Default

N