1drmaa_submit(3) Grid Engine DRMAA drmaa_submit(3)
2
6 drmaa_run_job, drmaa_run_bulk_jobs, drmaa_get_next_job_id,
7 drmaa_get_num_job_ids, drmaa_release_job_ids - Job submission
8
10 #include "drmaa.h"
11 int drmaa_run_job(
13 char *job_id,
14 size_t job_id_len,
15 drmaa_job_template_t *jt,
16 char *error_diagnosis,
17 size_t error_diag_len
18 );
19 int drmaa_run_bulk_jobs(
21 drmaa_job_ids_t **jobids,
22 drmaa_job_template_t *jt,
23 int start,
24 int end,
25 int incr,
26 char *error_diagnosis,
27 size_t error_diag_len
28 );
29 int drmaa_get_next_job_id(
31 drmaa_job_ids_t* values,
32 char *value,
33 int value_len
34 );
35 int drmaa_get_num_job_ids(
37 drmaa_job_ids_t* values,
38 int *size
39 );
40 void drmaa_release_job_ids(
42 drmaa_job_ids_t* values
43 );
44
46 drmaa_run_job() submits an Grid Engine job with attributes defined in
47 the DRMAA job template, jt. On success up to job_id_len bytes of the
48 job identifier are returned into the buffer, job_id.
49 drmaa_run_bulk_jobs()
51 The drmaa_run_bulk_jobs() submits a Grid Engine array job very much as
52 if the qsub(1) option `-t start-end:incr' had been used along with the
53 additional attributes defined in the DRMAA job template, jt. The same
54 constraints regarding value ranges are also in effect for the parame‐
55 ters start, end, and incr as for qsub(5) -t. On success a DRMAA job id
56 string vector containing job identifiers for each array job task is
57 returned into jobids. The job identifiers in the job id string vector
58 can be extracted using drmaa_get_next_job_id(3). The number of identi‐
59 fiers in the job id string vector can be determined using
60 drmaa_get_num_job_ids(3). Note that this function is only available in
61 the 1.0 implementation. The caller is responsible for releasing the
62 job id string vector returned into jobids using
63 drmaa_release_job_ids(3).
64 drmaa_get_next_job_id()
66 Each time drmaa_get_next_job_id() is called it returns into the buffer,
67 value, up to value_len bytes of the next entry stored in the DRMAA job
68 id string vector, values. Once the job ids list has been exhausted,
69 DRMAA_ERRNO_NO_MORE_ELEMENTS is returned.
70 drmaa_get_num_job_ids()
72 The drmaa_get_num_job_ids() returns into size the number of entries in
73 the DRMAA job ids string vector. This function is only available in
74 the 1.0 implementation.
75 drmaa_release_job_ids()
77 The drmaa_release_attr_job_id() function releases all resources associ‐
78 ated with the DRMAA job id string vector, values. This operation has no
79 effect on the actual Grid Engine array job tasks.
80
82 GE_ROOT Specifies the location of the Grid Engine standard con‐
83 figuration files.
84 GE_CELL If set, specifies the default Grid Engine cell to be
86 used. To address a Grid Engine cell Grid Engine uses (in
87 the order of precedence):
88 The name of the cell specified in the environment
90 variable GE_CELL, if it is set.
91 The name of the default cell, i.e. default.
93 GE_DEBUG_LEVEL If set, specifies that debug information should be writ‐
96 ten to stderr. In addition the level of detail in which
97 debug information is generated is defined.
98 GE_QMASTER_PORT
100 If set, specifies the tcp port on which ge_qmaster(8) is
101 expected to listen for communication requests. Most
102 installations will use a services map entry instead to
103 define that port.
104
106 Upon successful completion, drmaa_run_job(), drmaa_run_bulk_jobs(), and
107 drmaa_get_next_job_id() return DRMAA_ERRNO_SUCCESS. Other values indi‐
108 cate an error. Up to error_diag_len characters of error related diag‐
109 nosis information is then provided in the buffer error_diagnosis.
110
112 The drmaa_run_job(), drmaa_run_bulk_jobs(), and drmaa_get_next_job_id()
113 will fail if:
114 DRMAA_ERRNO_INTERNAL_ERROR
116 Unexpected or internal DRMAA error, like system call failure, etc.
117 DRMAA_ERRNO_DRM_COMMUNICATION_FAILURE
119 Could not contact DRM system for this request.
120 DRMAA_ERRNO_AUTH_FAILURE
122 The specified request is not processed successfully due to authoriza‐
123 tion failure.
124 DRMAA_ERRNO_INVALID_ARGUMENT
126 The input value for an argument is invalid.
127 DRMAA_ERRNO_NO_ACTIVE_SESSION
129 Failed because there is no active session.
130 DRMAA_ERRNO_NO_MEMORY
132 Failed allocating memory.
133 The drmaa_run_job() and drmaa_run_bulk_jobs() functions will fail if:
135 DRMAA_ERRNO_TRY_LATER
137 The DRM system indicated that it is too busy to accept the job. A retry
138 may succeed, however.
139 DRMAA_ERRNO_DENIED_BY_DRM
141 The DRM system rejected the job. The job will never be accepted due to
142 DRM configuration or job template settings.
143 The drmaa_get_next_job_id() will fail if:
145 DRMAA_ERRNO_INVALID_ATTRIBUTE_VALUE
147 When there are no more entries in the vector.
148
150 drmaa_attributes(3), drmaa_jobtemplate(3).
151GE 6.2u5 $Date: 2008/07/08 09:10:05 $ drmaa_submit(3)