dm_job_list_next Function

public function dm_job_list_next(job_list, job, index, disabled, revolved) result(rc)

Returns copy of next enabled job. If disabled is .true., the next job is returned regardless of state. One-time jobs are disabled by this function. If the job list has been finished and restarted from the beginning, revolved is set to .true..

Call dm_job_list_any() or dm_job_list_count() beforehand to check if the job list contains any enabled jobs. Otherwise, this function returns E_EMPTY.

The function returns the following error codes:

• E_CORRUPT if job list is not initialised properly.
• E_EMPTY if job list is empty or has no more jobs left.

Arguments

Type	Intent	Optional	Attributes		Name
type(job_list_type),	intent(inout)			::	job_list	Job list type.
type(job_type),	intent(out)			::	job	Job type.
integer,	intent(out),	optional		::	index	Position in job list.
logical,	intent(in),	optional		::	disabled	Return disabled job.
logical,	intent(out),	optional		::	revolved	Job list was revolved.

Return Value integer