SECTION 5 Job Submission Functions

Functions
int	drmaa_run_job (char *job_id, size_t job_id_len, drmaa_job_template_t *jt, char *error_diagnosis, size_t error_diag_len)
int	drmaa_run_bulk_jobs (drmaa_job_ids_t **jobids, drmaa_job_template_t *jt, int start, int end, int incr, char *error_diagnosis, size_t error_diag_len)

---

Function Documentation

int drmaa_run_bulk_jobs	(	drmaa_job_ids_t **	jobids,
		drmaa_job_template_t *	jt,
		int	start,
		int	end,
		int	incr,
		char *	error_diagnosis,
		size_t	error_diag_len
	)

Submits a set of parametric jobs tha can be run concurrently. For each parametric job the same template is used, and so must be properly set. Each job is identical except of it's index:

• DRMAA_PLACEHOLDER_INCR ranges form start to start+(incr*TOTAL_TASKS) in increments of size "incr", where TOTAL_TASKS is ((end - start)/incr)+1
• DRMAA_GW_TASKID ranges form 0 to TOTAL_TASKS in increments of size "1"
• DRMAA_GW_JOBID the job unique identifier assigned by GridWay These values can be used as arguments for each task and to generate input/output filenames.

GridWay will internally rescale the start-end range to 0-total_tasks The coherence of start, end and incr values are not check by drmaa_run_job(). Their coherence SHOULD be guarantee by the calling program.

Parameters:

	**jobids	Vector containing job identifiers. Its values can be access with the drmaa_get_next_job_id() function call
	jt	Pointer to a job_template structure. The job template *jt MUST BE previously allocated with a drmaa_allocate_job_template() function call. Job template values MUST be previously defined with drmaa_set_attribute() drmaa_set_vector_attribute() function calls.
	start	index associated to the first job, i.e. for this job DRMAA_PLACEHOLDER_INCR will be start.
	end	index associated to the last job, i.e. for this job DRMAA_PLACEHOLDER_INCR will be start+(incr*TOTAL_TASKS).
	incr	increment used to obtain the total number of job. This value could be negative
	error_diagnosis	string of characters with error related diagnosis information. The error diagnosis buffer will be filled in case of error. If the size of error_diagnosis buffer passed is smaller than the error message the resultant string will be truncated.
	error_diag_len	size of the error_diagnosis buffer. DRMAA_ERROR_STRING_BUFFER can be used for error_diag_len when appropiate.

Returns:

On success jobids will hold the jobs unique identifications as provided by the GridWay system, up to DRMAA_GW_JOBID_BUFFER characters.

• DRMAA_ERRNO_SUCCESS on success.
• DRMAA_ERRNO_INTERNAL_ERROR if the job template file could not be generated.
• DRMAA_ERRNO_DRM_COMMUNICATION_FAILURE could not contact GridWay daemon
• DRMAA_ERRNO_TRY_LATER If the number of jobs per session limit has been reached (1000 by default)
• DRMAA_ERRNO_NO_ACTIVE_SESSION if drmaa_init() function has not been previously called.
• DRMAA_ERRNO_NO_MEMORY if there is not enough system memory to allocate the job_ids list.

int drmaa_run_job	(	char *	job_id,
		size_t	job_id_len,
		drmaa_job_template_t *	jt,
		char *	error_diagnosis,
		size_t	error_diag_len
	)

This function submits a single job with the attributes defined in the job template.

Parameters:

	job_id	Job unique identification as provided by the GridWay system, up to job_id_len characters. job_id string SHOULD be of size DRMAA_GW_JOBID_BUFFER
	job_id_len	size of the job_id buffer. DRMAA_GW_JOBID_BUFFER SHOULD be used for job_id_len.
	jt	Pointer to a job_template structure. The job template *jt MUST BE previously allocated with a drmaa_allocate_job_template() function call. Job template values MUST be previously defined with drmaa_set_attribute() drmaa_set_vector_attribute() function calls.
	error_diagnosis	string of characters with error related diagnosis information. The error diagnosis buffer will be filled in case of error. If the size of error_diagnosis buffer passed is smaller than the error message the resultant string will be truncated.
	error_diag_len	size of the error_diagnosis buffer. DRMAA_ERROR_STRING_BUFFER can be used for error_diag_len when appropiate.

Returns:

On success job_id will hold the job unique identification as provided by the GridWay system, up to job_id_len characters.

• DRMAA_ERRNO_SUCCESS on success.
• DRMAA_ERRNO_INTERNAL_ERROR if the job template file could not be generated.
• DRMAA_ERRNO_DRM_COMMUNICATION_FAILURE could not contact GridWay daemon
• DRMAA_ERRNO_TRY_LATER If the number of jobs per session limit has been reached (1000 by default)
• DRMAA_ERRNO_NO_ACTIVE_SESSION if drmaa_init() function has not been previously called.