Knowledge Center Contents Previous Next |
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 |