1. drmaa2_jsession_get_job_categories(3)
  2. DRMAA2
  3. drmaa2_jsession_get_job_categories(3)


drmaa2_jsession_get_job_categories - drmaa2_jsession_get_job_categories(3), Returns a list of available job categories.


#include "drmaa2.h"

drmaa2_string_list drmaa2_jsession_get_job_categories(const drmaa2_jsession jsession);


Returns a list of job categories available in the job session. For Univa(R) Grid Engine(TM) a job category is represented by a job class. Hence requesting a job category in the drmaa2_jtemplate is equivalent to requesting a job class with qsub(3). The job category list is a list of job classes defined in Univa(R) Grid Engine(TM). If there is no job category defined in Univa(R) Grid Engine(TM) the job category list is defined but empty (size of 0). After a sucessful creation of the list (with 0 or more elements) the list must be freed by the caller after usage with the drmaa2_list_free(3) function. The drmaa2_string_list is created with a callback function which frees all allocated strings.


Returns a list of strings with job category names. The list has 0 or more entries. In case of an failure NULL is returned and the error id and error string is set for the calling thread.


drmaa2_jsession js = drmaa2_create_jsession("mysession", NULL);

if (js == NULL) {
   drmaa2_string error = drmaa2_lasterror_text();
   fprintf(stderr, "Error during creation of job session with the name %s: %s\n", 
              "mysession", error);
} else {
   drmaa2_string_list categories = drmaa2_jsession_get_job_categories(js);

   if (categories == NULL) {
      drmaa2_string error = drmaa2_lasterror_text();
      fprintf(stderr, "Error during getting job categories list: %s\n", error);
   } else {
      long size, i;

      size = drmaa2_list_size(categories);
      for (i = 0; i < size; i++) {
         fprintf(stdout, "%s\n", (char *) drmaa2_list_get(categories, i));
         /* ... if job category has a specific name -> add it to jtemplate ... */

   /* close jsession */
   /* free jsession */

   /* remove the job session from the Univa(R) Grid Engine(TM) master process */
   if (drmaa2_destroy_jsession("mysession") != DRMAA2_SUCCESS) {
      /* an error happend */
      drmaa2_string error = drmaa2_lasterror_text();
      fprintf(stderr, "Error during destruction of job session with the name %s: %s\n", 
                  "mysession", error);


drmaa2_jtemplate_create(3), drmaa2_jsession_get_session_names(3), drmaa2_jsession_get_session_name(3), drmaa2_jsession_get_jobs(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_size(3), drmaa2_list_get(3), drmaa2_list_free(3)


Copyright Univa Corporation 2013

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