1. drmaa2_jarray_resume(3)
  2. DRMAA2
  3. drmaa2_jarray_resume(3)

NAME

drmaa2_jarray_resume - drmaa2_jarray_resume(3), Resumes a job array.

SYNOPSIS

#include "drmaa2.h"

drmaa2_error drmaa2_jarray_resume(drmaa2_jarray jarray);

DESCRIPTION

A drmaa2_jarray is the equivalent of an Univa(R) Grid Engine(TM) array job. It consists of several single drmaa2_j jobs. This function resumes the array job, i.e. all DRMAA2 jobs which belong the array job are resumed if they are in an appropriate state (i.e. user suspended). Jobs which are not in suspended state can't be resumed, i.e. jobs which are queued, finished or running are not signalled. The action Univa(R) Grid Engine(TM) performs on the job depends on the Univa(R) Grid Engine(TM) configuration.

This call is asynchronous in a way that after performing the action the result might be not immediately visible.

RETURN VALUES

Returns an error id in case something went wrong otherwise DRMAA2_SUCCESS is returned. In case of an error the error description is set in the context of the calling thread. The error description can be fetched with the drmaa2_lasterror_text(3) call.

EXAMPLE

/* ... ja is the array job which was returned by drmaa2_jsession_run_bulk_jobs() ... */

if (DRMAA2_SUCCESS == drmaa2_jarray_resume(ja)) {
   printf("All users suspended jobs are singalled in order to resume...\n");
}

SEE ALSO

drmaa2_jarray_free(3), drmaa2_jarray_get_job_template(3), drmaa2_jarray_get_session_name(3), drmaa2_jarray_get_id(3), drmaa2_jsession_get_contact(3), drmaa2_jsession_get_job_array(3), drmaa2_jsession_run_job(3), drmaa2_jsession_run_bulk_jobs(3), drmaa2_jsession_wait_any_started(3), drmaa2_jsession_wait_any_terminated(3), drmaa2_open_jsession(3), drmaa2_list_get(3), drmaa2_list_size(3), drmaa2_list_free(3)

AUTHOR

Copyright Univa Corporation 2013

  1. Univa Corporation
  2. October 2013
  3. drmaa2_jarray_resume(3)