Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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:

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