BMOD

ジョブのジョブ実行依頼オプションを変更します。

概要

bmod [bsub_options] [job_ID | "job_ID[索引]"]

bmod [-g job_group_name | -gn] [job_ID]

bmod [-hostfile ファイル・パス | -hostfilen]

bmod [-sla サービス・クラス名 | -slan] [ジョブ ID]

bmod [-aps "system=値" | "admin=値" | -apsn] [job_ID]

bmod [-h | -V]

オプション・リスト

[-ar | -arn]

[-B | -Bn]

[-hl | -hln]

[-N | -Ne | -Nn]

[-r | -rn]

[-ul | -uln]

[-x | -xn]

[-a "esub_application [([引数[,引数...]])] ... "]

[-app application_profile_name | -appn]

[-aps "system=値" | "admin=値" | -apsn]

[-b begin_time | -bn]

[-C core_limit |-Cn]

[-c [時:]分[/host_name | /host_model] | -cn]

[-clusters "all [~cluster_name] ... | cluster_name[+[pref_level]] ... [others[+[pref_level]]]" | -clustern]

[-cwd "current_working_directory" | -cwdn]

[-D data_limit | -Dn]

[-data "[host_name:]abs_file_path [[host_name:]abs_file_path ...]" [-datachk] ... | -data "tag:tag_name [tag:tag_name ...]" ... | -datan]

[-E "pre_exec_command [引数 ...]" | -En]

[-Ep "post_exec_command [引数 ...]" | -Epn]

[-e err_file | -en]

[-eptl [時:]分 | -eptln]

[-eo err_file | -en]

[-ext[sched] "external_scheduler_options"]

[-F file_limit | -Fn]

[-f "local_file op [remote_file]" ... | -fn]

[-freq numberUnit | -freqn]

[-G ユーザー・グループ | -Gn]

[-g ジョブ・グループ名 | -gn]

[-i input_file | -in | -is input_file | -isn]

[-J job_name | -J "%job_limit" | -Jn]

[-Jd "job_description" | -Jdn]

[-jobaff "[# | ! | ~]属性名 ..." | "attribute([# | ! | ~]属性名 ...)" | "[# | ! | ~]samehost(ジョブID)" | "[# | ! | ~]samecu(ジョブID)" | -jobaffn]

[-k "checkpoint_dir [init=initial_checkpoint_period] [checkpoint_period]" | -kn]

[-L ログイン・シェル | -Ln]

[-Lp ls_project_name | -Lpn]

[-M mem_limit[!] | -Mn]

[-mig マイグレーションしきい値 | -mign]

[-n min_tasks[、 max_tasks] | -nn]

[-network network_res_req | -networkn]

[-notify "[exit ] [done ] [start ] [suspend]" | -notifyn]

[-o 出力ファイル | -on]

[-oo 出力ファイル | -oon]

[-outdir output_directory | -outdirn]

[-P プロジェクト名 | -Pn]

[-p process_limit | -pn]

[-ptl [時:]分 | -ptln]

[-Q "[exit_code ...] [EXCLUDE(exit_code ...)]"]

[-q "queue_name ..." | -qn]

[-R "res_req" [-R "res_req" ...] | -Rn]

[-rcacct "rc_account_name" | -rcacctn]

[-rnc resize_notification_cmd | -rncn]

[-S stack_limit | -Sn]

[-s シグナル | -sn]

[-sla サービス・クラス名 | -slan]

[-smt smt_value | -smtn]

[-sp 優先順位 | -spn]

[-stage " [storage= min_size [ , max_size ]] [:in=path_to_stage_in_script ] [:out=path_to_stage_out_script ] " | -stagen]

[-T スレッド制限 | -Tn]

[-t term_time | -tn]

[-ti | -tin]

[-U reservation_ID |-Un]

[-u mail_user | -un]

[-v swap_limit | -vn]

[-W [時:]分[/host_name | /host_model] | -Wn]

[-We [時間:]分[/host_name | /host_model] | -Wep [値] | -We+ [時間:]分 | -Wen]

[-w "dependency_expression" | -wn]

[-wa "[signal | コマンド | CHKPNT]" | -wan]

[-wt "job_warning_time" | -wtn]

[-Z "new_command" | -Zs "new_command" | -Zsn]

[job_ID | "job_ID[索引]"]

説明

LSF マルチクラスター機能環境で転送されたジョブを含む、以前に実行依頼されたジョブのオプションを変更します。 bmodで変更できるジョブ実行依頼オプションの詳細については、 bsub コマンド解説書を参照してください。

ジョブの所有者、ユーザー・グループ管理者 (ユーザー・グループに関連付けられているジョブの場合)、または LSF 管理者のみが、ジョブのオプションを変更できます。

投入時に指定されたすべてのオプションを変更することができます。各オプションの値は、 bsubのようにオプションを指定することにより、新しい値でオーバーライドできます。オプションを取り消すか、デフォルト値にリセットするには、オプション・ストリングの後に「n」を付けます。オプションをリセットするときは、オプション値を指定しないでください。

-i、 -in、および -Z オプションには、入力ファイルおよびジョブ・コマンド・ファイルのスプーリングをサポートする同等のオプションがあります (-is、 -isn、 -Zs、および -Zsn)。ファイル名およびジョブ・スプーリング・ディレクトリーに関連するオプションは、UNIX の場合は最大 4094 文字、Windows の場合は最大 255 文字を含むパスをサポートします。

コマンド名に関連するオプションには、UNIX の場合は最大 4094 文字、Windows の場合は最大 255 文字を含めることができます。ジョブ名に関連するオプションには、最大 4094 文字を含めることができます。

対応する bsub コマンド・オプションが指定されていない場合でも、保留中のジョブのすべてのオプションを変更できます。

転送された保留中のジョブのオプションの変更は、保留中のジョブのオプションの変更とは異なります。

オプション -m、 -q、 -sla、 -wは変更できません。
-aps、 -g、 -kオプションを指定した場合、変更は実行クラスターではなく、実行クラスターでのみ有効になります。
-J オプションの場合、ジョブ配列制限のみを変更すると、オプションは実行クラスターではなく実行依頼クラスターでのみ有効になります。
取り消しオプション (以前の -app 指定を取り消す -appn オプションなど) を適用する場合、その属性のデフォルト値はローカル・クラスター構成によって異なります。

bsubと同様に、 bmod コマンドは親 esub (mesub) を呼び出します。親 esub は、 LSF 管理者によって構成された必須の esub 実行可能ファイル、および esub という名前の実行可能ファイル (ファイル名に .application を含まない) が LSF_SERVERDIR ディレクトリーに存在する場合は、それを実行します。実行依頼ホスト上のジョブ環境を変更できるのは、 bsub コマンドによって呼び出される esub 実行可能ファイルのみです。 bmod コマンドによって呼び出された esub は、ジョブ環境を変更できません。 esub 実行可能ファイルの引数も変更できます。

-b オプションは、ジョブ開始時刻を変更します。年フィールドが指定され、指定された時刻が過去の時刻である場合、開始時刻条件に達したと見なされ、スロットが使用可能であれば LSF がジョブをディスパッチします。

-t オプションは、ジョブ終了時間を変更します。年フィールドが指定され、指定された時刻が過去の時刻である場合、ジョブ変更要求は拒否されます。

-clusters オプションを使用して、 LSF マルチクラスター機能ジョブのクラスター名を変更します。 bmod -clusters remote_clusters コマンドは、実行依頼クラスター上の保留中のジョブのみを変更できます。

-cwd オプションは、ジョブの現行作業ディレクトリー (CWD) を指定します。 -cwd オプションは、ジョブが保留状態の場合にのみ機能します。パスは、絶対パスにすることも、サブミット・ディレクトリーからの相対パスにすることもできます。実行依頼ディレクトリーが実行ホストに存在しない場合は、論理ホーム・ディレクトリーが試行されます。それが失敗すると、 tmp ディレクトリーが CWD に使用されます。

パスには、 bsub -cwd コマンドで説明したものと同じ動的パターンを含めることができます。

-cwdn オプションは、 -cwd オプションの値を bsub コマンドからサブミット・ディレクトリーにリセットします。

ジョブが -app オプションを指定して -cwd オプションを指定せずに実行依頼され、 LSB_JOB_CWD パラメーターが定義されていない場合は、指定されたアプリケーション・プロファイルに定義されている CWD が使用されます。 CWD がアプリケーション・プロファイルに定義されていない場合は、 DEFAULT_JOB_CWD 値が使用されます。 2 つのパラメーターのいずれも定義されていない場合、CWD にはサブミット・ディレクトリーが使用されます。

-hl オプションは、 Linux cgroup をサポートするホストに対して、ジョブごとのホスト・ベースのメモリーおよびスワップ制限の適用を有効にします。 -hln オプションは、ホスト・ベースのメモリーとスワップ制限の適用を無効にします。 -hl および -hln オプションは、保留中のジョブにのみ適用されます。 -hl オプションを使用したホスト・ベースのメモリーおよびスワップ制限の適用を有効にするには、 lsf.conf ファイルで LSB_RESOURCE_ENFORCE="memory" パラメーターを指定する必要があります。ジョブにメモリーまたはスワップの制限が指定されていない場合、または LSB_RESOURCE_ENFORCE="memory" パラメーターが指定されていない場合、ジョブに対してホスト・ベースのメモリー制限は設定されません。

-Epn オプションは、ジョブ・レベルの実行後コマンドの設定を取り消します。ジョブ・レベルの実行後コマンドは実行されません。アプリケーション・レベルの実行後コマンドは、存在する場合は実行されます。

デフォルト・ユーザー・グループが ( lsb.params ファイル内の DEFAULT_USER_GROUP パラメーターを使用して) 構成されている場合、 bmod -Gn コマンドはジョブをデフォルト・ユーザー・グループに移動します。ジョブが既にデフォルト・ユーザー・グループに接続されている場合、 bmod -Gn コマンドはそのジョブに影響を与えません。ジョブが実行できないユーザー・グループに移動されたジョブ (例えば、指定されたフェア・シェア・キューに共有がない場合) は、ジョブを実行できるデフォルト・ユーザー・グループに転送されます。

-gpu オプションは、ジョブに必要な GPU リソースのプロパティーを指定します。このオプションについて詳しくは、 bsub -gpu コマンドを参照してください。

サイズ変更可能ジョブの場合、 bmod -R "rusage[mem | swp]" コマンドは、ジョブがディスパッチされていない場合にのみ、サイズ変更割り振り要求に影響します。

-M オプションは、ジョブが再びキューに入れられる場合、およびジョブが再び実行される場合にのみ有効になります。

-m オプションは、最初の実行ホスト・リストを変更します。複合リソース要件で使用する場合、最初に割り振られるホストは、複合リソース要件内の最初の単純リソース要件ストリングを満たす必要があります。

-notify オプションを使用して通知要求を変更すると、変更されたレコードも JOB_MODIFY2 イベントに記録されます。 -notify オプションは、ジョブ配列またはジョブ配列エレメントでは機能しません。

-notifyn オプションは、ジョブ配列エレメントでは機能しません。

-outdir オプションは、ジョブが保留状態のときに出力ディレクトリーを作成します。このオプションは、出力ディレクトリーの動的パターンをサポートします。例えば、 user1 がコマンド bmod -outdir "/scratch/joboutdir/%U/%J_%I" myjobを実行すると、システムは次のディレクトリーを作成します。/scratch/joboutdir /user1/jobid_0ジョブ出力ディレクトリーの場合。

-outdirn オプションは、出力ディレクトリーの値を DEFAULT_JOB_OUTDIR パラメーター (定義されている場合) にリセットするか、出力ディレクトリーを元の bsub コマンドが実行されたサブミット・ディレクトリーに設定します。出力ディレクトリーを変更できるのは、ジョブが保留状態のときだけです。

-Q オプションは、実行中のジョブには影響しません。再実行可能ジョブおよび再キューイング・ジョブの場合、 -Q オプションは次の実行に影響します。

-q オプションは、新しい実行依頼であるかのように、ジョブを新しいキューに再実行依頼します。デフォルトでは、 LSF はキュー内のジョブを到着順にディスパッチするため、変更されたジョブは、元のキュー内の位置に関係なく、新しいキューの最後の位置に移動します。

-rn オプションは、 bsub -rn オプションまたは bsub -r オプションで指定された再実行可能ジョブ設定をリセットします。アプリケーション・プロファイルおよびキュー・レベルの再実行可能ジョブの設定 (使用されている場合)。ジョブが再実行可能キューまたはアプリケーション・プロファイルに実行依頼され、ジョブ再実行が構成されている場合、 bmod -rn コマンドはジョブ再実行を使用不可またはオーバーライドしません。 bmod -rn コマンドは、 bsub -rn コマンドとは異なります。このコマンドは、アプリケーション・プロファイルおよびキュー・レベルの再実行可能ジョブの設定をオーバーライドします。

-ti オプションは、孤立ジョブの即時自動終了をジョブ・レベルで有効にします。 -ti および -tin オプションはコマンド・フラグであり、サブオプションではないため、 bsub コマンドで実行依頼された -w オプションから元の依存関係式を再指定する必要はありません。 bmod -w [-ti | -tin] コマンドまたは bmod -ti | -tin コマンドのいずれかを使用できます。 -tin オプションは、実行依頼された従属ジョブの -ti サブオプションを取り消します。この場合、クラスター・レベルの構成が優先されます。

-uln オプションは、保留中のジョブのユーザー・シェル制限をデフォルト値に設定します。 -uln オプションは Windows ではサポートされません。

-温は、見積もられたジョブ実行時間を取り消します。ジョブの実行時の見積もりは有効になりません。

実行中のジョブの変更

デフォルトでは、ジョブを実行するためのリソース要件を変更できます (-R "res_req" except -R "cu [cu_string]")。および実行中または中断状態のジョブの推定実行時間 (-We、 -We +、 -Wep)。ジョブを実行するための追加のジョブ・オプションを変更するには、 lsf.confで LSB_MOD_ALL_JOBS=Y を定義します。

注: 有効なリソース要件として複合リソース要件または代替リソース要件を使用する実行中のジョブで bmod -R コマンドを使用することは許可されていません。実行中のジョブの複合リソース要件または代替リソース要件の変更も拒否されます。

LSB_MOD_ALL_JOBS=Y パラメーターが設定されている場合、ジョブを実行するために変更できるのは、一部の bsub オプションのみです。ジョブがディスパッチされた後は、他の変更を行うことはできません。 bmod を使用して、ジョブを実行するための以下のオプションを変更できます。

CPU 制限 (-c [hour:]minute[/host_name |/host_model])
メモリー制限 (-M mem_limit)
再実行可能ジョブ (-r | -rn)
リソース要件 (-R "res_req" ( -R "cu [cu_string]"を除く)
実行制限 (-W run_limit[/host_name |/host_model])

注: 保留中のジョブの実行制限も変更できます。
スワップ制限 (-v swap_limit)
標準出力 (stdout) ファイル名 (UNIX および Linux の場合は最大 4094 文字、Windows の場合は 255 文字) (-o output_file)
標準エラー (stderr) ファイル名 (UNIX および Linux の場合は最大 4094 文字、Windows の場合は 255 文字) (-e error_file)
UNIX および Linux の場合は最大 4094 文字、Windows の場合は 255 文字までの標準出力 (stdout) ファイル名を上書きする (-oo output_file)
上書き標準エラー (stderr) ファイル名 (UNIX および Linux の場合は最大 4094 文字、Windows の場合は 255 文字) (-eo error_file)

リモートで実行中のジョブの場合、変更できるのは以下の属性のみです。

CPU 制限 ([-c cpu_limit[/host_spec] | -cn])
メモリー制限 ([-M mem_limit | -Mn])
再実行可能属性 ([-r | -rn])
実行制限([-W[時:]分[/ホスト名| /ホストモデル] |-Wn])
スワップ制限 ([-v swap_limit | -vn])
標準出力/エラー ([-o out_file | -on] [-oo out_file | -oon] [-e err_file | -en] [-eo err_file | -en])

変更されたリソース使用量の制限は、キューに定義されている制限を超えることはできません。

実行中のジョブの CPU リミットまたはメモリーリミットを変更するには、パラメーター LSB_JOB_CPULIMIT=Y および LSB_JOB_MEMLIMIT=Y を lsf.conf ファイルで定義する必要があります。

デフォルトでは、以下のリソース使用量制限のオプションは KB 単位で指定されます。

コア制限 (-C)
メモリー制限 (-M)
スタック制限 (-S)
スワップ制限 (-v)

lsf.conf の LSF_UNIT_FOR_LIMITS を使用して、制限に別の単位 (MB、GB、TB、PB、EB、または ZB) を指定します。

リソース要件の変更

bmod の -R オプションは、以前のリソース要件仕様を完全に置き換えます。既存の仕様に変更は追加されません。例えば、次のコマンドを使用してジョブを実行依頼したとします。

bsub -R "rusage[res1=1]"

次に、以下のように変更します。

bmod -R "rusage[res2=1]"

ジョブの新しいリソース使用要件は、以下のとおりです。[res2=1]、そうではない[res1=1; res2=1].

bmod は、 -R オプションで OR (||) 演算子をサポートしません。

bmod は、複数フェーズの rusage リソース要件に対する複数の -R オプション・ストリングをサポートしていません。

保留中のジョブに対して変更された rusage 使用可能リソース要件は、 lsb.queues ファイル内のパラメーター RESRSV_LIMIT によって設定されたすべての制限を満たす必要があります。ジョブを実行するには、 RESRSV_LIMIT パラメーターで設定された最大値を満たす必要がありますが、変更された rusage 値は最小値より小さくすることができます。

bmod -R "rusage[mem=(mem1 mem2):duration=(dur1 dur2)]" などの実行中のジョブで複数フェーズの rusage ストリングを変更すると、即時に有効になり、現行フェーズの残りの部分が変更されます。

例えば、以下のリソース要件を持つジョブが実行依頼されたとします。

bsub -R "rusage[mem=(500 300 200):duration=(20 30):decay=(1 0)]" myjob

また、実行時間が 15 分になると、以下の変更が実行されます。

bmod -R "rusage[mem=(400 300):duration=(20 10):decay=(1 0)]" job_ID

結果は、以下の rusage ストリングになります。

rusage[mem=(400 300):duration=(20 10):decay=(1 0)]

実行中のジョブは、実行時の次の (20-15)=5 分間、減衰する (400-((400-300)*15/20)))=325 MB メモリーを予約します。 2 番目のフェーズが開始され、次の 10 分間、減衰なしで 300 MB のメモリーが予約され、残りのランタイム用に予約されたメモリーがなくなります。

実行時間が 25 分になると、別の変更が発行されます。

bmod -R "rusage[mem=(200 100):duration=(20 10):decay=(1 0)]" job_ID

ジョブは 100 MB のメモリーを予約しますが、次の 5 分間は減衰しません。その後、ジョブの残りのための予約済みメモリーはありません。

bsub コマンドを使用して指定されたすべてのストリング入力を除去するには、 -Rn オプションを使用します。

開始ジョブの場合、 bmod -R は、ジョブ・リソース使用量とともに、ジョブの有効なリソース要件を変更します。スケジュール済みジョブの有効なリソース要件ストリングは、スケジューラーがディスパッチ決定を行うために使用するリソース要件を表します。 bmod -R は、リソース要件の rusage 部分を更新し、他のセクションを元のリソース要件のまま保持します。 rusage は、常にジョブ・ランタイムの割り振りを表し、ジョブ・リソースの使用量とともに変更されます。ジョブを実行する場合、リソース要件を以下のいずれかのリソース要件に変更することはできません。

複合
代替
rusage の兄弟
複合から単純へ

ジョブの推定実行時間の変更

以下のオプションは、ジョブの推定実行時間を変更します。

-We [時:]分[/host_name | /host_model]

推定実行時間を設定します。ホストまたはホスト・モデルを指定すると、ホストまたはモデルの CPU 係数 (時間 /CPU 係数) で時間が正規化されます。

-We+ [時:]分]

指定した値を累積実行時間に加算した推定実行時間を設定します。例えば、 -We+ 30 を指定した場合に、ジョブが 60 分間実行されると、新しい推定実行時間は 90 分になります。

ホストまたはホスト・モデルを指定すると、ホストまたはモデルの CPU 係数 (時間 /CPU 係数) で時間が正規化されます。

-Wep [値]

推定実行時間を設定します。これは、累積実行時間に追加するように指定したジョブ完了のパーセンテージです。例えば、 -Wep+ 25 (ジョブが 25% 完了したことを意味します) を指定し、ジョブが 60 分間実行された場合、新規の推定実行時間は 240 分になります。

有効な値の範囲は、0 より大きく、100 以下です。 10 進数の後の 2 桁がサポートされます。

ホストまたはホスト・モデルを指定すると、ホストまたはモデルの CPU 係数 (時間 /CPU 係数) で時間が正規化されます。

ジョブ・グループの変更

ジョブまたはジョブ配列をあるジョブ・グループから別のジョブ・グループに移動するには、 bmod の -g オプションを使用して、ジョブ・グループ・パスを指定します。例えば、次のコマンドは、ジョブ 105 をジョブ・グループに移動します。/risk_group/portfolio2/monthly:

bmod -g /risk_group/portfolio2/monthly 105

bsub -gと同様に、ジョブ・グループが存在しない場合は、 LSF によって作成されます。

bmod -g オプションを他の bmod オプションと組み合わせることはできません。保留中のジョブに対してのみ操作できます。実行中または終了したジョブを操作することはできません。

自分のジョブ・グループ、および他のユーザーが自分のジョブ・グループの下に作成したジョブ・グループを変更することができます。 LSF 管理者は、すべてのユーザーのジョブ・グループを変更できます。

ジョブ配列エレメントを 1 つのジョブ・グループから別のジョブ・グループに移動することはできません。移動できるのは、ジョブ配列全体のみです。ジョブ配列内のいずれかのジョブ配列エレメントが実行中の場合、ジョブ配列を別のグループに移動することはできません。ジョブ配列は、一度に 1 つのジョブ・グループにのみ属することができます。

サービス・クラスに関連付けられたジョブのジョブ・グループを変更することはできません。ジョブ・グループは、保証目標を持つリソース・ベースの SLA では使用できません。

配列の依存関係を配列名で指定する場合は、 lsb.params ファイルで JOB_DEP_LAST_SUB パラメーターを設定します。このパラメーターが設定されていない場合、前の配列の 1 つの名前が同じで、索引が異なると、ジョブは拒否されます。

サービス・クラス内のジョブの変更

-sla オプションは、ジョブを指定されたサービス・クラスに付加することによってジョブを変更します。 -slan オプションは、指定されたジョブをサービス・クラスから切り離します。サービス・クラスが存在しない場合、ジョブは変更されません。例えば、次のコマンドは、ジョブ 2307 をサービス・クラスに接続します。Duncan:

bmod -sla Duncan 2307

次のコマンドは、サービス・クラスからジョブ 2307 を切り離します。Duncanlsb.paramsでデフォルトの SLA が構成されている場合、ジョブはデフォルトのサービス・クラスに移動されます。

bmod -slan 2307

以下のジョブ変更を行うことはできません。

-sla オプションは、他の bmod オプションと一緒に使用します。
ジョブ・グループに既に接続されているジョブのサービス・クラスを変更します。 (時間ベースの SLA のみ。) bsla コマンドを使用して、 lsb.serviceclasses ファイルで構成されているサービス・クラスの構成プロパティー、および各サービス・クラスの状態に関する動的情報を表示します。
割り当てられた保証 SLA を満たさなくなるようにジョブを変更します。 SLA を保証するために自動接続されたジョブは、必要に応じて別の SLA に再接続しますが、指定された SLA で実行依頼されたジョブは、引き続き SLA アクセス制限を満たす必要があります。

lsb.params ファイル内の ENABLE_EGO_DEFAULT_SLA パラメーターを使用してデフォルトの SLA が構成されている場合、 bmod -slan オプションはジョブをデフォルトの SLA に移動します。ジョブが既にデフォルトの SLA に付加されている場合、 bmod -slan オプションはそのジョブに影響しません。

アプリケーション・プロファイルに関連したジョブの変更

-app オプションは、ジョブを指定されたアプリケーション・プロファイルに関連付けることによってジョブを変更します。 -appn オプションは、指定されたジョブとそのアプリケーション・プロファイルとの関連付けを解除します。アプリケーション・プロファイルが存在しない場合、ジョブは変更されません。

保留中のジョブについてのみ、アプリケーション・プロファイルを変更できます。例えば、以下のコマンドは、ジョブ 2308 をアプリケーション・プロファイルに関連付けます。fluent:

bmod -app fluent 2308

次のコマンドは、サービス・クラスからジョブ 2308 の関連付けを解除します。fluent:

bmod -appn 2308

LSB_CONFDIR/cluster_name/configdir/lsb.applicationsで構成されているアプリケーション・プロファイルのプロパティーを表示するには、 bapp を使用します。

絶対優先順位スケジューリング・オプションの変更

管理者は、 bmod -aps を使用して、保留中のジョブの APS 値を調整できます。 bmod -apsn は、以前の bmod -aps 設定を取り消します。 bmod -aps を他の bmod オプションと組み合わせることはできません。

APS 値を変更できるのは、保留中のサイズ変更可能ジョブの場合のみです。

-aps "system=値" job_ID: 保留中のジョブの静的なゼロ以外の APS 値を設定します。システム APS 値を設定すると、ジョブの計算された APS 値がオーバーライドされます。システム APS 値は、実行中のジョブに適用できません。
-aps "admin=値" job_ID: 保留中のジョブにゼロ以外の ADMIN 因数値を設定する。 ADMIN 係数は、計算された APS 値を上位または下位に調整します。負の管理値を指定すると、計算された APS 値が低くなり、正の値を指定すると、APS キュー内の他の保留ジョブと比較して計算された APS 値が増加します。
ADMIN 要素に対して APS の重み、制限、または猶予期間を構成することはできません。 ADMIN 係数は、設定されるとすぐに有効になります。
-アプスン: 以前の bmod -aps 設定を取り消すには、 bmod -apsn オプションを使用します。 bmod -apsn オプションは、APS キュー内の実行中のジョブには適用できません。ジョブにシステム APS 優先順位または ADMIN 要素が設定されていない場合は、エラーが発行されます。

サイズ変更可能ジョブの変更

-rnc および -ar オプションを使用して、サイズ変更可能ジョブの自動化可能属性またはサイズ変更通知コマンドを変更します。自動化可能属性を変更できるのは、保留中のジョブの場合のみです (PSUSPまたはPEND)。サイズ変更通知コマンドは、未完了のジョブに対してのみ変更できます (変更できません)。DONEまたはEXITジョブ)。

-rnc resize_notification_cmd: ジョブ割り振りが変更されたとき (縮小と拡大の両方) に、最初の実行ホストで呼び出される実行可能ファイルの名前を指定します。 bmod -rnc オプションは、アプリケーション・プロファイルに指定されているすべての通知コマンドをオーバーライドします。
-rncn: ジョブから通知コマンド設定を削除してください。
-ar: ジョブが自動化可能であることを指定します。
-アーン: ジョブからジョブ・レベルの自動化可能属性を除去してください。

PE ジョブのネットワーク・スケジューリング・オプションの変更

-network オプションは、 IBM Parallel Environment (PE) ジョブのネットワーク・スケジューリング・オプションを変更します。 -networkn オプションは、PE ジョブのネットワーク・スケジューリング・オプションをすべて削除します。

LSB_MOD_ALL_JOBS=yの場合でも、ジョブを実行するためのネットワーク・スケジューリング・オプションを変更することはできません。

アフィニティー・ジョブのメモリー再利用の変更

bmod コマンドを使用してアフィニティー・リソース要求で実行中のジョブのメモリー rusage を変更すると、 bhosts -l -aを使用すると、ホスト・レベルの使用可能メモリーと NUMA ノード内の使用可能メモリーが不整合になる可能性があります。不整合は、変更されたリソース要件がアフィニティー・スケジューリングの次のスケジューリング・サイクルで有効になるために発生しますが、ホスト・レベルでは即時に有効になります。 bmod コマンドは、 LSF がアカウントするリソース使用量のみを更新します。実行中のジョブには影響しません。メモリー・バインディングの場合、プロセスがいくつかの NUMA ノードにバインドされると、 LSF は、プロセスが物理メモリーを取得する NUMA ノードを制限します。 LSF は、プロセス用に物理メモリーを予約するようオペレーティング・システムに要求しません。

ユーザー指定のホスト・ファイルを使用したジョブの変更

ユーザー指定のホスト・ファイルを使用して保留中のジョブを変更するには、 -hostfile オプションを使用します。

bmod -hostfile "host_alloc_file" ./a.out <job_id>

ユーザー指定のホスト・ファイルには、ユーザーがジョブに使用したい特定のホストとスロットが含まれています。例えば、ネットワーク接続状況などの要因に基づいて、ジョブの最適なホスト割り振りが分かっている場合は、ユーザー指定のホスト・ファイルを使用してジョブをサブミットすることを選択できます。ユーザー指定のホスト・ファイルは、タスクを起動する順序を指定し、ファイル内で指定されたスロットをランク付けします。結果のランク・ファイルは、他のアプリケーション (MPI など) でも使用可能になります。

重要:

-hostfile は、 -n または -m オプションと一緒に使用することはできません。
-hostfile オプションは、 -R または複合 res_reqと組み合わせることはできません。
タスク形状を有効にした場合は、競合が発生してジョブが失敗する可能性があるため、ユーザー指定のホスト・ファイルを使用しないでください。
タスクの準備ができているときにリソースが使用できない場合は、ユーザー指定のホスト・ファイルの代わりに事前予約を使用して、予約済みスロットが使用可能であることを確認し、ジョブが円滑に実行されるようにします。

どのユーザーでも、ユーザー指定のホスト・ファイルを作成できます。サブミット・ホストからユーザーがアクセスできる必要があります。以下の形式で、1 行に 1 つのホストがリストされます。

# This is a user specified host file
<host_name1>   [<# slots>]
<host_name2>   [<# slots>]
<host_name1>   [<# slots>]
<host_name2>   [<# slots>]
<host_name3>   [<# slots>]
<host_name4>   [<# slots>]

ユーザー指定のホスト・ファイルには、以下の規則が適用されます。

ホストのスロット数の指定はオプションです。スロット番号が示されていない場合、デフォルトは 1 です。
ホスト名は、ローカル・クラスター内のホストにすることも、リモート・クラスターからリースされたホスト (host_name@cluster_name) にすることもできます。
ユーザー指定のホスト・ファイルには、同じクラスターのホストのみが含まれている必要があります。
ホスト名は、ドメイン・ネームの有無にかかわらず入力できます。

ホスト名は複数回使用でき、ホストの順序はタスクの配置を表します。

#first three tasks
host01                      3
#fourth tasks
host02
#next three tasks
host03                      3

コメントは # 文字で開始します。

ジョブがクリーンアップされると, ユーザー指定のホスト・ファイルが他のジョブ関連ファイルと一緒に削除されます。

保留中のジョブに指定されているユーザー指定のホスト・ファイルを除去するには、 -hostfilen オプションを使用します。

bmod -hostfilen <job_id>

ジョブ・データ要件の変更

-data オプションは、 bsub-data オプションを指定してサブミットされた保留中のジョブのデータ・ステージング要件を変更します。以前に指定されたファイルのファイル転送がまだ進行中の場合、それらのファイルは停止されません。必要に応じて、新しいデータ管理要件のために新しい転送のみが開始されます。ジョブのデータ・ステージング要件を取り消すには、 -datan を使用します。

ジョブのデータ要件を変更すると、 -data オプションの以前のデータ要件ストリング全体が新しいデータ要件ストリングに置き換えられます。データ要件ストリングの一部を変更または追加する場合は、変更とともにデータ要件ストリング全体を bmod -data に指定する必要があります。

ファイルまたはフォルダーが存在するかどうか、ユーザーがそれらにアクセスできるかどうか、ファイルまたはフォルダーのサイズと変更時刻のディスカバリー、および bmod コマンドからのハッシュの生成が転送ジョブで行われます。これにより、データ要件の有無にかかわらず、ジョブ間の変更パフォーマンスが均等化されます。 -datachk オプションは、データ要件を持つジョブの完全検査を実行できます。 -datachk オプションは、 -data コマンドでのみ指定できます。データ要件がタグに関するものである場合、このオプションは無効です。

ジョブのデータ要件を変更するには、指定されたファイルに対する読み取り権限が必要です。

bmod -data または bmod -datan を使用して、実行中または終了したジョブのデータ管理要件を変更したり、別のクラスターとの間で既に転送されているジョブのデータ管理要件を変更したりすることはできません。

例えば、最初に以下のコマンドを使用して実行依頼されたジョブがあるとします。

bsub -data /proj/user1/dataset_A_%I -J A[1-10] myjob.sh

また、以下のコマンドを使用してジョブを変更します。

bmod -data /proj/user1/dataset_B_%I "A[1]"

次に、すべてのパス /proj/user1/dataset_B_1、 /proj/user1/dataset_B_2 ... /proj/user1/dataset_B_10 が存在しなければなりません。 bmod コマンドが成功した場合でも、 A[1] のデータ要件には 10 個のデータ・ファイルがすべて含まれています。

オプション

job_ID | "job_ID[index]": 指定されたジョブ ID を持つジョブを変更します。
"job_ID[index]"によって指定されたジョブ配列エレメントを変更します。
-h: コマンドの使用法を stderr に出力して終了します。
-V: LSF リリース・バージョンを stderr に出力して終了します。

制限事項

ジョブがディスパッチされる前に -e または -eo を指定しないと、実行中のジョブのジョブ・エラー・ファイルの名前を変更できません。リモートで実行中のジョブのジョブ出力オプションの変更はサポートされていません。