Viewing job array information

Use the bjobs and bhist commands to monitor the current and past status of job arrays.

Displaying job array status

The -A option of the bjobs command shows job array summary information.

Procedure

To display summary information about the currently running jobs submitted from a job array, use the -A option of the bjobs command.

For example, a job array of 10 jobs with job ID 123:

bjobs -A 123
JOBID    ARRAY_SPEC  OWNER  NJOBS PEND DONE  RUN EXIT SSUSP USUSP PSUSP 
123      myArra[1-10]     user1     10    3    3    4    0     0     0     0

Displaying job array dependencies

The bjdepinfo command shows job dependency information for a job array.

Procedure

To display information for any job dependency information for an array, use the bjdepinfo command.

For example, a job array (with job ID 456) where you want to view the dependencies on the third element of the array:

bjdepinfo -c "456[3]"
JOBID  CHILD CHILD_STATUS CHILD_NAME LEVEL
456[3] 300   PEND         job300     1

Displaying status of jobs submitted from an array

The bjobs command displays the status of the individual jobs submitted from a job array

Procedure

Use the bjobs command and specify the job array job ID to display the status of the individual jobs submitted from a job array. For jobs submitted from a job array, JOBID displays the job array job ID, and JOBNAME displays the job array name and the index value of each job.

For example, to view a job array with job ID 123:

bjobs 123
JOBID  USER   STAT   QUEUE     FROM_HOST  EXEC_HOST   JOB_NAME    SUBMIT_TIME 
123    user1  DONE   default   hostA      hostC       myArray[1]  Feb 29 12:34 
123    user1  DONE   default   hostA      hostQ       myArray[2]  Feb 29 12:34 
123    user1  DONE   default   hostA      hostB       myArray[3]  Feb 29 12:34 
123    user1  RUN    default   hostA      hostC       myArray[4]  Feb 29 12:34 
123    user1  RUN    default   hostA      hostL       myArray[5]  Feb 29 12:34 
123    user1  RUN    default   hostA      hostB       myArray[6]  Feb 29 12:34 
123    user1  RUN    default   hostA      hostQ       myArray[7]  Feb 29 12:34 
123    user1  PEND   default   hostA                  myArray[8]  Feb 29 12:34 
123    user1  PEND   default   hostA                  myArray[9]  Feb 29 12:34 
123    user1  PEND   default   hostA                  myArray[10] Feb 29 12:34

Displaying past job status

The bhist command displays historical information about array jobs.

Procedure

Use the bhist command and specify the job array job ID to display the past status of the individual jobs submitted from a job array.

For example, to view the history of a job array with job ID 456:

bhist 456
Summary of time in seconds spent in various states: 
JOBID  USER    JOB_NAME   PEND    PSUSP   RUN     USUSP   SSUSP   UNKWN   TOTAL 
456[1] user1   *rray[1]   14      0       65      0       0       0       79 
456[2] user1   *rray[2]   74      0       25      0       0       0       99 
456[3] user1   *rray[3]   121     0       26      0       0       0       147 
456[4] user1   *rray[4]   167     0       30      0       0       0       197 
456[5] user1   *rray[5]   214     0       29      0       0       0       243 
456[6] user1   *rray[6]   250     0       35      0       0       0       285 
456[7] user1   *rray[7]   295     0       33      0       0       0       328 
456[8] user1   *rray[8]   339     0       29      0       0       0       368 
456[9] user1   *rray[9]   356     0       26      0       0       0       382 
456[10]user1   *ray[10]   375     0       24      0       0       0       399

Displaying the current status of a specific job

The bjobs command shows the current status of a specific array job element.

Procedure

Use the bjobs command to display the current status of a specific job submitted from a job array. Specify the job array job ID and an index value in quotes.

For example, the status of the 5th job in a job array with job ID 123:

bjobs "123[5]"
JOBID  USER   STAT   QUEUE     FROM_HOST  EXEC_HOST   JOB_NAME    SUBMIT_TIME 
123    user1  RUN    default   hostA      hostL       myArray[5]  Feb 29 12:34

Displaying the past status of a specific job

The bhist command shows the historical status of a specific array job element.

Procedure

Use the bhist command to display the past status of a specific job submitted from a job array. Specify the job array job ID and an index value in quotes.

For example, the status of the 5th job in a job array with job ID 456:

bhist "456[5]"
Summary of time in seconds spent in various states: 
JOBID  USER    JOB_NAME   PEND    PSUSP   RUN     USUSP   SSUSP   UNKWN   TOTAL 
456[5] user1   *rray[5]   214     0       29      0       0       0       243