Knowledge Center Contents Previous Next |
lsb_getjobdepinfo()
Returns the job dependency information.
DESCRIPTION
lsb_getjobdepinfo() returns information about jobs (including job arrays) when a job has one or more dependencies on it.
SYNOPSIS
#include <lsf/lsbatch.h> struct jobDependInfo *lsb_getjobdepinfo(struct jobDepRequest *jobdepReq) struct dependJobs { LS_LONG_INT jobId; char *jobname; int level; int jobstatus; char hasDependency; char *condition; int satisfied; LS_LONG_INT depjobid; }; struct queriedJobs { LS_LONG_INT jobId; char *dependcondition; int satisfied; }; struct jobDependInfo { int options; int numQueriedJobs; struct quieriedJobs *queriedJobs; int level; int numJobs; struct dependJobs *depJobs; }; struct jobDepRequest { LS_LONG_INT jobId; int options; int level; };struct dependJobs
The dependJobs structure contains the following fields:
jobId
Job ID. By default, it is the parent job of the queried job. Modify to child job by setting QUERY_DEPEND_CHILD in options of JobDepRequest.
jobname
The job name associated with the job ID.
jobstatus
Job status of the job.
level
The number of degrees of separation from the original job.
hasDependency
Whether the job ID has a dependency or not. When you set QUERY_DEPEND_RECURSIVELY in options of JobDepRequest, 0 indicates job ID does not have a dependency. Otherwise, one or more of the following bits displays:
- JOB_HAS_DEPENDENCY: Job has a dependency.
- JOB_HAS_INDIVIDUAL_CONDITION: Job has an individual dependency condition when it is an element of job array.
condition
When you set "QUERY_DEPEND_DETAIL" into options, it is dependency condition of jobId. It is "" when you do not set "QUERY_DEPEND_DETAIL".
satisfied
Whether the condition is satisfied.
depJobId
Job ID. By default, it is the child job. Modify to parent job by setting QUERY_DEPEND_CHILD in options of JobDepRequest
struct queriedJobs
The queriedJobs structure contains the following fields:
jobId
Job ID of the queried job or job array.
dependcondition
The whole dependency condition of the job.
satisfied
Whether the condition is satisfied.
struct jobDependInfo
The jobDependInfo structure contains the following fields:
options
You can set the following bits into this field:
QUERY_DEPEND_RECURSIVELY
Query the dependency information recursively.
QUERY_DEPEND_DETAIL
Query the detailed dependency information.
QUERY_DEPEND_UNSATISFIED
Query the jobs that cause this job pend.
QUERY_DEPEND_CHILD
Query child jobs.
numQueriedJobs
The number of jobs you queried. By default, the value is 1. However, when you set QUERY_DEPEND_DETAIL in the options and you query a job array where some elements have a dependency condition that has changed, the value is the number of the changed element + 1.
queriedJobs
The jobs you queried.
level
The number of levels returned.
numJobs
The number of jobs returned.
depJobs
The returned dependency jobs.
structure jobDepRequest
The jobDepRequest structure contains the following fields:
jobid
Job ID of the queried job or job array.
options
You can set the following bits into this field:
QUERY_DEPEND_RECURSIVELY
Query the dependency information recursively.
QUERY_DEPEND_DETAIL
Query the detailed dependency information.
QUERY_DEPEND_UNSATISFIED
Query the jobs that cause this job pend.
QUERY_DEPEND_CHILD
Query child jobs.
level
The level when you set QUERY_DEPEND_RECURSIVELY.
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |