Systemwalker Operation Manager リファレンスマニュアル - UNIX/Windows(R)共通 -

16.2.3 catch(スクリプト行を実行し処理例外をトラップする)

◆機能説明

スクリプト行を実行して処理例外をトラップします。

スクリプト実行時の処理例外とは、スクリプトの処理がそこで打ち切られ、プロセス自体が強制終了されるエラーです。このようなエラーが発生する例として、実行中のスクリプトに文法エラーや値未設定の変数に対する変数置換の他に、ファイルオープン時のエラー(openコマンド)や、実行プロセスの終了コードが0以外(execコマンド)など、実行時の条件によって発生するものがあります。

catchコマンドはこのような処理例外の発生時に、独自のリカバリ処理を行い、スクリプトのプロセスが終了するのを防ぐために使用します。

◆記述形式

catch {script} 【varname】

◆オプション

{script}

実行するスクリプトコマンド部分です。改行またはセミコロンで区切ることにより複数のコマンドが記述できます。

varname

処理例外が発生した場合にその原因を示すエラーテキストを格納する変数名です。省略時は、エラーテキストは格納されません。

◆復帰値

0：

処理例外は発生しませんでした

0以外：

処理例外が発生しました。

この場合、グローバル変数errorCodeに、詳細情報として以下の値が格納されます。

• スクリプトコマンドexecで実行したコマンドの終了コードが“0”以外で終了した場合

  CHILDSTATUS pid exitcode

  
  

  Pid

  【Windows版】

  　ここに入る数字は意味を持ちません。

  【UNIX版】

  　実行したコマンドのプロセスID

  exitcode

  実行したコマンドの終了コード 

• スクリプトコマンドexecで実行したコマンドがシグナルにより強制終了された場合

  CHILDKILLED pid sigName msg

  Pid

  【Windows版】

  　ここに入る数字は意味を持ちません。

  【UNIX版】

  　実行したコマンドのプロセスID 

  SigName

  実行したコマンドに送られたシグナル名

  Msg

  詳細メッセージ

• スクリプトコマンドexecで実行したコマンドがシグナルにより一時停止された場合

  CHILDSUSP pid sigName msg

  Pid

  【Windows版】

  　ここに入る数字は意味を持ちません。

  【UNIX版】

  　実行したコマンドのプロセスID 

  SigName

  プロセスに送られたシグナル名

  Msg

  詳細メッセージ

• スクリプトコマンドexprで算術エラーが発生した場合

  ARITH errName msg

  ErrName

  エラー内容

  Msg

  詳細メッセージ

• システムコールでエラーが起きた場合

  POSIX errName msg

  ErrName

  エラー内容

  Msg

  詳細メッセージ

• エラーとともに返されるメッセージ以外の情報がない場合

  NONE

◆使用例

ファイルを読み込み用にオープンし、失敗した場合は標準入力からの読み込みをする。

if {[catch {
　　　set file [open data.txt r]
}]} {
　　　set file "stdin"
}
gets $file buf
if {$file != "stdin"} {
　　　close $file
}

◆実行結果／出力形式

なし