modifies job submission options of a job
Modifies the options of a previously submitted job. See bsub for complete descriptions of job submission options you can modify with bmod.
Only the owner of the job, or LSF administrators, can modify the options of a job.
All options specified at submission time may be changed. The value for each option may be overridden with a new value by specifying the option as in bsub. To reset an option to its default value, use the option string followed by 'n'. Do not specify an option value when resetting an option.
The -i, -in, and -Z options have counterparts that support spooling of input and job command files (-is, -isn, -Zs, and -Zsn).
Options related to file names and job spooling directories support paths that contain up to 4094 characters for UNIX, or up to 255 characters for Windows.
Options related to command names can contain up to 4094 characters for UNIX, or up to 255 characters for Window; options related to job names can contain up to 4094 characters.
You can modify all options of a pending job, even if the corresponding bsub option was not specified.
Modifying a job that is pending in a chunk job queue (CHUNK_JOB_SIZE) removes the job from the chunk to be scheduled later.
Like bsub, bmod calls the master esub (mesub), which invokes any mandatory esub executables configured by an LSF administrator, and any executable named esub (without.application) if it exists in LSF_SERVERDIR. Only esub executables invoked by bsub can change the job environment on the submission host. An esub invoked by bmod cannot change the job environment.
-b modifies the job begin time. If the year field is specified and the specified time is in the past, the start time condition is considered reached and LSF dispatches the job if slots are available.
-t modifies job termination time. If the year field is specified and the specified time is in the past, the job modification request is rejected.
-cwdn sets the current working directory for the job to the directory where bmod is running.
-Epn cancels the setting of job-level post-execution commands. The job-level post-execution commands do not run. Application-level post-execution commands run if they exist.
For resizable jobs, bmod -R "rusage[mem | swp]" only affects the resize allocation request if the job has not been dispatched.
-m modifies the first execution host list. When used with a compound resource requirement, the first host allocated must satisfy the simple resource requirement string appearing first in the compound resource requirement.
-rn resets the rerunnable job setting specified by bsub –rn or bsub -r. The application profile and queue level rerunnable job setting if any is used. bmod -rn does not disable or override job rerun if the job was submitted to a rerunnable queue or application profile with job rerun configured. bmod –rn is different from bsub -rn, which does override the application profile and queue level rerunnable job setting.
-uln sets the user shell limits for pending jobs to their default values. -uln is not supported on Windows.
-Wen cancels the estimated job runtime. The runtime estimate does not take effect for the job.
-Q does not affect running jobs. For rerunnable and requeue jobs, -Q affects the next run.
By default, you can modify resource requirements for running jobs (-R "res_req" except -R "cu[cu_string]") and the estimated running time for running or suspended jobs (-We, -We+, -Wep). To modify additional job options for running jobs, define LSB_MOD_ALL_JOBS=Y in lsf.conf.
When LSB_MOD_ALL_JOBS=Y is set, the following are the only bmod options that are valid for running jobs. You cannot make any other modifications after a job has been dispatched.
Resource requirements (-R "res_req" except -R "cu[cu_string]")
Standard output (stdout) file name up to 4094 characters for UNIX and Linux or 255 characters for Windows (-o output_file)
Standard error (stderr) file name up to 4094 characters for UNIX and Linux or 255 characters for Windows (-e error_file)
Overwrite standard output (stdout) file name up to 4094 characters for UNIX and Linux or 255 characters for Windows (-oo output_file)
Overwrite standard error (stderr) file name up to 4094 characters for UNIX and Linux or 255 characters for Windows (-eo error_file)
Modified resource usage limits cannot exceed limits defined in the queue.
To modify the CPU limit or the memory limit of running jobs, the parameters LSB_JOB_CPULIMIT=Y and LSB_JOB_MEMLIMIT=Y must be defined in lsf.conf.
If you want to specify array dependency by array name, set JOB_DEP_LAST_SUB in lsb.params. If you do not have this parameter set, the job is rejected if one of your previous arrays has the same name but a different index.
Use LSF_UNIT_FOR_LIMITS in lsf.conf to specify a different unit for the limit (MB, GB, TB, PB, or EB).
bsub -R "rusage[res1=1]"
the new resource usage requirement for the job is [res2=1], not [res1=1; res2=1].
bmod does not support the OR (||) operator on the -R option.
bmod does not support multiple -R option strings for multi-phase rusage resource requirements.
Modified rusage consumable resource requirements for pending jobs must satisfy any limits set by the parameter RESRSV_LIMIT in lsb.queues. For running jobs, the maximums set by RESRSV_LIMIT must be satisfied but the modified rusage values can be lower than the minimum values.
Changes to multi-phase rusage strings on running jobs such as bmod -R "rusage[mem=(mem1 mem2):duration=(dur1 dur2)]" take effect immediately, and change the remainder of the current phase.
For example, a job is submitted with the following resource requirements:
and after 15 minutes of runtime, the following modification is issued:
The resulting rusage string is:
The running job will reserve (400-((400-300)*15/20)))=325 MB memory with decay for the next (20-15)=5 minutes of runtime. The second phase will then start, reserving 300 MB of memory for the next 10 minutes with no decay, and end up with no memory reserved for the rest of the runtime.
If after 25 minutes of runtime another modification is issued:
The job will reserve 100 MB of memory with no decay for the next 5 minutes of runtime, followed by no reserved memory for the remainder of the job.
To remove all of the string input specified using the bsub command, use the -Rn option.
-We [hour:]minute[/host_name | /host_model]: Sets an estimated run time. Specifying a host or host model normalizes the time with the CPU factor (time/CPU factor) of the host or model.
-We+ [hour:]minute]: Sets an estimated run time that is the value you specify added to the accumulated run time. For example, if you specify -We+ 30 and the job has already run for 60 minutes, the new estimated run time is now 90 minutes.
Specifying a host or host model normalizes the time with the CPU factor (time/CPU factor) of the host or model.
-Wep [value]: Sets an estimated run time that is the percentage of job completion that you specify added to the accumulated run time. For example, if you specify -Wep+ 25 (meaning that the job is 25% complete) and the job has already run for 60 minutes, the new estimated run time is now 240 minutes.
The range of valid values is greater than 0 and less than or equal to 100. Two digits after decimal are supported.
Specifying a host or host model normalizes the time with the CPU factor of the host or model (time/CPU factor).
bmod -g /risk_group/portfolio2/monthly 105
moves job 105 to job group /risk_group/portfolio2/monthly.
Like bsub -g, if the job group does not exist, LSF creates it.
bmod -g cannot be combined with other bmod options. It can only operate on pending jobs. It cannot operate on running or finished jobs.
You can modify your own job groups and job groups that other users create under your job groups. LSF administrators can modify job groups of all users.
You cannot move job array elements from one job group to another, only entire job arrays. If any job array elements in a job array are running, you cannot move the job array to another group. A job array can only belong to one job group at a time.
You cannot modify the job group of a job attached to a service class.
bmod -sla Kyuquot 2307
attaches job 2307 to the service class Kyuquot.
detaches job 2307 from the service class Kyuquot. If a default SLA is configured in lsb.params, the job is moved to the default service class.
Move job array elements from one service class to another, only entire job arrays
Modify the service class of job already attached to a job group. Use bsla to display the configuration properties of service classes configured in lsb.serviceclasses, the default SLA configured in lsb.params, and dynamic information about the state of each service class.
If a default SLA is configured in lsb.params, bmod -slan moves the job to the default SLA. If the job is already attached to the default SLA, bmod -slan has no effect on that job.
The -app option modifies a job by associating it to the specified application profile. The -appn option dissociates the specified job from its application profile. If the application profile does not exist, the job is not modified.
associates job 2308 with the application profile fluent.
dissociates job 2308 from the service class fluent.
Use bapp to display the properties of application profiles configured in LSB_CONFDIR/cluster_name/configdir/lsb.applications.
Administrators can use bmod -aps to adjust the APS value for pending jobs. bmod -apsn cancels previous bmod -aps settings. You cannot combing bmod -aps with other bmod options.
You can only change the APS value for pending resizable jobs.
Set a static non-zero APS value of a pending job. Setting a system APS value overrides any calculated APS value for the job. The system APS value cannot be applied to running jobs.
Set a non-zero ADMIN factor value for a pending job. The ADMIN factor adjusts the calculated APS value higher or lower. A negative admin value is lowers the calculated APS value, and a positive value raises the calculated APS value relative to other pending jobs in the APS queue.
You cannot configure APS weight, limit, or grace period for the ADMIN factor. The ADMIN factor takes effect as soon as it is set.
Run bmod -apsn to cancel previous bmod -aps settings. You cannot apply bmod -apsn on running jobs in an APS queue. An error is issued if the job has no system APS priority or ADMIN factor set.
Use the -rnc and -ar options to modify the autoresizable attribute or resize notification command for resizable jobs. You can only modify the autoresizable attribute for pending jobs (PSUSP or PEND). You can only modify the resize notification command for unfinished jobs (not DONE or EXIT jobs).