3.5 Job Arrays

Viewpoint supports Moab job arrays and displays information on the child jobs and the parent job in the job array.

Job arrays sent from Torque are treated as a single job (parent job).

This topic provides information specific to Moab job arrays in Viewpoint.

In this topic:

3.5.1 Viewing Job Arrays

Job array information is viewable from the Workload page. However, with the job array, instead of the Job ID, the job array ID is listed in the Job ID column and the information in the rest of the columns is the parent job information.

Expand the job ID to see a listing of the child jobs in the job array.

The following image shows an example of the expanded job array.

Click to enlarge

3.5.2 Viewing Job Array Details

Job detail information for a parent or child job in the job array is viewable using the Job Details page.

  • For the parent job, select the job array ID in the Job ID column.
  • For a child job, select the link for the child job from the expanded job array.

Once you have selected the job, the Job Details page displays. This page is similar to the Job Details page for non-job arrays, with these differences:

  • Parent job:
    • The Job Array area is present. Expand this area to view the child jobs for this job array.

      Click to enlarge

    • You can make changes to, hold, or cancel the parent job.

      • If you cancel a parent job, all child jobs will be canceled. However, if you hold the parent job, all the child jobs continue as normal.

  • Child job:
    • The parent job ID is listed under the Job Id field. Click the parent job ID to return to the parent job.
    • The Job Array area is not present, as this is a child job.
    • You can make changes to, hold, or cancel the child job.

3.5.3 Creating Job Arrays

Viewpoint also lets you create job arrays.

The user must have the Create Job permission applied. The user must also have access to an application template that has the "Job Arrays" label enabled and visible and/or editable and which includes a script with the "Moab Array Env Variables". See 1.7 Role Permissions and 4.4 Application Template Details.

You use the Create Job page to also create a job array; however you must choose an application template that enables creation of a job array.

When the Create Job page displays, you will see the job array-specification fields in the Basic Job Settings area. For example:

Click to enlarge

The "From" number is the first number you want appended to the job for the child job. The "To" number is the maximum number of child job. For example, if you specified the range as From 0 To 3. The job array will have four child jobs: jobID[0], jobID[1], jobID[2], and jobID[3].

Related Topics