Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_modify()

Modifies a submitted job's parameters.

DESCRIPTION

lsb_modify() allows for the modification of a submitted job's parameters.

SYNOPSIS

#include <lsf/lsbatch.h> 
LS_LONG_INT lsb_modify (struct submit *jobSubReq, 
                         struct submitReply *jobSubReply, int jobId) 
struct submit { 
    int     options; 
    int     options2; 
    char    *jobName; 
    char    *queue; 
    int     numAskedHosts; 
    char    **askedHosts; 
    char    *resReq; 
    int     rLimits[LSF_RLIM_NLIMITS]; 
    char    *hostSpec; 
    int     numProcessors; 
    char    *dependCond; 
    char    *timeEvent; 
    time_t  beginTime; 
    time_t  termTime; 
    int     sigValue; 
    char    *inFile; 
    char    *outFile; 
    char    *errFile; 
    char    *command; 
    char    *newCommand; 
    time_t  chkpntPeriod; 
    char    *chkpntDir; 
    int     nxf; 
    struct xFile *xf; 
    char    *preExecCmd; 
    char    *mailUser; 
    int     delOptions; 
    int     delOptions2; 
    char    *projectName; 
    int     maxNumProcessors; 
    char    *loginShell; 
    char    *userGroup; 
    char    *exceptList; 
    int     userPriority; 
    char    *rsvId; 
    char    *jobGroup; 
    char    *sla; 
    char    *extsched; 
    int     warningTimePeriod; 
    char    *warningAction; 
    char    *licenseProject; 
    int     options3; 
    int     delOptions3; 
    char    *app; 
    int     jsdlFlag; 
    char    *jsdlDoc; 
    void    *correlator; 
    char    *apsString; 
    char    *postExecCmd; 
    char    *cwd; 
    int     runtimeEstimation; 
    char    *requeueEValues; 
    int     initChkpntPeriod; 
    int     migThreshold; 
    char    *notifyCmd; 
}; 
struct submitReply { 
    char *queue; 
    LS_LONG_INT badJobId; 
    char *badJobName; 
    int badReqIndx; 
}; 

PARAMETERS

*jobSubReq

Describes the requirements for job modification to the batch system. A job that does not meet these requirements is not submitted to the batch system and an error is returned.

See lsb_submit() for descriptions of the submit structure fields.

*jobSubReply

Describes the results of the job modification to the batch system.

See lsb_submit() for descriptions of the submitReply structure fields.

*jobId

The job to be modified. If an element of a job array is to be modified, use the array form jobID[i] where jobID is the job array name, and i is the index value.

RETURN VALUES

character:job ID

The function was successful, and sets the queue field of jobSubReply to the name of the queue that the job was submitted to.

integer:-1

Function failed.

ERRORS

If the function fails, lsberrno is set to indicate the error.

SEE ALSO

Related API

lsb_submit() - Submits or restarts a job in the batch system

ls_info() - Returns a pointer to an lsInfo structure

ls_task()

lsb_queueinfo() - Returns information about batch queues

Equivalent line command

bmod

Files

${LSF_ENVDIR-/etc}/lsf.conf


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next