ポスト
外部状況メッセージを送信し、データ・ファイルをジョブに添付します。
概要
bpost [-i メッセージインデックス ] [-d " 説明 " [-N INFO | WARNING | ERROR | CRITICAL] ] [-a データファイル ] ジョブID | "ジョブ[IDインデックス]" | -J ジョブ名説明
外部状況情報を提供するか、システム内のジョブにデータを送信します。
デフォルトでは、メッセージ索引を操作します。0. デフォルトでは、メッセージを投稿します。"no description".
- メッセージおよびデータは、自分自身のジョブにのみ送信できます。
- 他のユーザーによって投入されたジョブにメッセージおよびデータを送ることはできません。
- 他のユーザーによって実行依頼されたジョブにメッセージを送信できるのは、root 管理者と LSF 管理者のみです。
- root 管理者および LSF 管理者は、他のユーザーによって実行依頼されたジョブにデータ・ファイルを添付することはできません。
- メッセージおよびデータは、自分自身のジョブにのみ送信できます。
- 他のユーザーによって投入されたジョブにメッセージおよびデータを送ることはできません。
- root 管理者および LSF 管理者は、自分のジョブにのみメッセージとデータを送信できます。
ジョブは、システムからクリーンアップされるまでメッセージを受け入れることができます。 アプリケーションがあるジョブから別のジョブにデータを転送する必要がある場合は、 bpost コマンドの -a オプションを使用して、データ・ファイルをジョブに添付します。 次に、 bread コマンドを使用して、添付ファイルを別のファイルにコピーします。
複数のメッセージおよび添付データ・ファイルを同じジョブに関連付けることができます。 ジョブの処理中に、 bread または bstatus コマンドを使用して、ジョブに通知されたメッセージを取得します。 bread を使用して、メッセージ添付ファイルを外部ファイルにコピーします。
例えば、アプリケーションには、 LSF が内部で提供するジョブ状況記述以外のジョブ状況記述が必要になる場合があります。PEND,RUN,SUSP)。 -d オプションを使用して、独自の状況テキストまたはジョブ記述テキストをジョブへのメッセージとして配置します。
bstatus -d "description" myjob
以下のコマンドと同等です。
bpost -i 0 -d "description" myjob
LSF マルチクラスター機能を使用する場合は、両方のクラスターで LSF バージョン 7 以降を実行する必要があります。 LSF マルチクラスター機能 ジョブにファイルを添付することはできません。
LSF マルチクラスター機能 接続が失われた ( mbatchd デーモンがダウンしている) 場合は、接続がリカバリーされたときにメッセージを保存して再送することができます。 メッセージはローカル・クラスターにバックアップされ、元の順序で再送されます。
オプション
- -データ・ファイル
- 指定されたデータ・ファイルをジョブ外部ストレージに接続します。 このオプションは、 LSF マルチクラスター機能 ジョブの場合は無視されます。ファイルを添付できるのは、ジョブがローカル・クラスターで実行される場合のみです。
lsb.params ファイル内の JOB_ATTA_DIR パラメーターを使用して、添付データ・ファイルが保存されるディレクトリーを指定します。 ディレクトリーには、少なくとも 1 MB のフリー・スペースが必要です。 mbatchd デーモンは、ファイルを転送する前に、ジョブ接続ディレクトリー内に使用可能なスペースがあるかどうかを検査します。
lsb.params ファイル内の MAX_JOB_ATTA_SIZE パラメーターを使用して、ジョブ・メッセージ添付の最大サイズを設定します。
- --d"説明"
- ユーザー自身の状況テキストをジョブへのメッセージとして入れます。 メッセージ記述の最大長は 512 文字です。
例えば、アプリケーションには、 LSF が内部で提供するジョブ状況記述以外のジョブ状況記述が必要になる場合があります。PEND,RUN,SUSP).
デフォルトの説明は次のとおりです。"no description".
- --i message_index
- 指定されたメッセージ索引を操作します。
デフォルトのメッセージ索引は次のとおりです。0.
lsb.params ファイル内の MAX_JOB_MSG_NUM パラメーターを使用して、ジョブのメッセージの最大数を設定します。 LSF マルチクラスター機能では、競合を避けるために、 MAX_JOB_MSG_NUM パラメーターはすべてのクラスターで同じでなければなりません。
- --N情報|警告|エラー|クリティカル
- 指定された通知レベルのメッセージを ( -d オプションから) lsf.conf ファイルの LSF_AC_PNC_URL パラメーターで指定された LSF Application Center 通知に送信します。 通知の長さは 1024 バイト未満でなければなりません。1024 バイト未満でない場合、 LSF はメッセージを切り捨てます。
- job_ID|"job_ID[index]"| ジョブ名
- 必須。 指定されたジョブを操作します。 LSF マルチクラスター機能 ジョブ転送モデルでは、常にローカル・ジョブ ID を使用する必要があります。
ジョブ名の最大長は 4094 文字です。 ジョブ名が固有ではありません。
ワイルドカード文字 (*) は、ジョブ名内の任意の場所で使用できますが、配列指標内で使用することはできません。 例えば、パターン job* は以下を返します。jobAおよびjobarray[1]. *AAA*[1] パターンは、以下を含む名前を持つジョブ配列内の最初のエレメントを返します。AAAただし、ワイルドカードが配列指標内にあるため、パターン job1[*] は何も返しません。
- -h
- コマンドの使用法を stderr に出力して終了します。
- -V
- LSF リリース・バージョンを stderr に出力して終了します。
例
bpost -i 1 -N INFO -d "step 1" -a step1.out 2500
メッセージ・テキストを書き込みます。step 1メッセージ索引 1 および LSF Application Center 「 INFO レベルでの通知 ( LSF_AC_PNC_URL パラメーターが lsf.conf ファイルで正しく指定されている場合)」に追加し、ファイル step1.out をジョブ 2500 に添付します。
関連資料
bread, bstatus, MAX_JOB_ATTA_SIZE, MAX_JOB_MSG_NUM