Hitachi

Advanced Shell 


9.4.5 adshjoberrコマンド(ジョブおよびジョブステップにエラーを通知する)

形式

adshjoberr 終了コード

機能

指定した場所からジョブおよびジョブステップにエラーを通知できます。指定した場所がジョブステップ内またはジョブステップ外の場合,次のように動作します。

ジョブステップ内に指定した場合

ジョブステップのonError属性の指定に関わらず,ジョブステップ正常ブロックの後続処理は実行しないで,ジョブステップエラーブロックが定義されていれば実行し,ジョブステップがエラー終了します。

ジョブステップ外に指定した場合

run属性がabnormalまたはalwaysの後続のジョブステップが定義されていれば実行し,ジョブがエラー終了します。

引数

終了コード ~<整数>((0255))

ジョブまたはジョブステップに通知する終了コードを定義します。

終了コード

終了コード

意味

0255

エラー終了

adshjoberrコマンドの引数に指定した終了コードをジョブまたはジョブステップに通知します。

1

エラー終了

続行不可能なエラーが発生しました。

200

エラー終了

コマンドラインの指定に誤りがあります。

注意事項

使用例

ファイルが存在しない場合,ジョブステップを終了コード1で異常終了させます。

ジョブ定義スクリプト
#-adsh_job J01

#-adsh_step_start S01
  cmd1
  if [[ ! -a /tmp/tempfile ]]; then
    echo "tempfile not found"
    adshjoberr 1
  fi
#-adsh_step_end
実行結果
********  ジョブコントローラのメッセージ出力  ********
17:02:02 046277 KNAX0091-I J01 ジョブが開始しました。
17:02:02 046277 KNAX7901-I ジョブコントローラは,ジョブ終了時にすべての非同期実行プロセスの完了を待ちます。
17:02:02 046277 KNAX7902-I ジョブコントローラは,"端末入力モード"で動作します。
17:02:02 046277 KNAX0092-I J01.S01 ステップが開始しました。
17:02:02 046277 KNAX6116-I コマンド(./cmd1, 行番号=4)が正常終了しました。rc=0 E-Time=0.001s C-Time=0.000s
17:02:02 046277 KNAX6112-I コマンド([[, 行番号=5)が正常終了しました。rc=0 E-Time=0.000s C-Time=0.000s
17:02:02 046277 KNAX6112-I コマンド(echo, 行番号=6)が正常終了しました。rc=0 E-Time=0.000s C-Time=0.000s
17:02:02 046277 KNAX6150-E ジョブステップにエラーが通知されました。rc=1 line=7
17:02:02 046277 KNAX6596-E J01.S01 ジョブステップがエラー終了しました。rc=1 E-Time=0.003s C-Time=0.000s
17:02:02 046277 KNAX0101-E J01 ジョブを実行中にエラーが発生しました。
17:02:02 046277 KNAX0098-I J01 ジョブが終了しました。rc=1 E-Time=0.004s C-Time=0.000s