1. drmaa2_jsession_get_jarray(3)
  2. DRMAA2
  3. drmaa2_jsession_get_jarray(3)

NAME

drmaa2_jsession_get_jarray - drmaa2_jsession_get_jarray(3), Returns an array job.

SYNOPSIS

#include "drmaa2.h"

drmaa2_jarray drmaa2_jsession_get_job_array(const drmaa2_jsession jsession, const drmaa2_string id);

DESCRIPTION

Searches in the given drmaa2_jsession for a given array job. The drmaa2_jsession must be open. If the array job is found a newly allocated drmaa2_jarray is returned. The drmaa2_jarray stores a list of DRMAA2 jobs, which can be queried with drmaa2_jarray_get_jobs(3).

RETURN VALUES

Returns NULL in case of an error or when the id was not found in the DRMAA2 job session. Otherwise a newly allocated drmaa2_jarray object is returned, which must be freed by the calling function (drmaa2_jarray_free(3)).

EXAMPLE

/* ... array job id stems from a previous drmaa2_jarray_get_id() call ... */
drmaa2_jarray ja = drmaa2_jsession_get_job_array(js, id);

if (ja != NULL) {
   drmaa2_j_list jl = drmaa2_jarray_get_jobs(aj);
   if (jl != NULL) {
      printf("Amount of single jobs: %lld\n", drmaa2_list_size(jl));
      /* do something other with the jobs ... */
      drmaa2_list_free(&jl);
   }

  drmaa2_jarray_free(&ja);
}

SEE ALSO

drmaa2_jarray_free(3), drmaa2_jarray_get_session_name(3), drmaa2_jarray_get_job_template(3), drmaa2_jarray_get_jobs(3), drmaa2_jarray_get_id(3), drmaa2_jsession_get_session_name(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)

AUTHOR

Copyright Univa Corporation 2013

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