Rational® ClearQuest® API のルーチンによって予期しない状態が検出された場合、そのルーチンから例外がスローされます。例外が呼び出し側プログラムでキャッチされない場合は、言語インタープリタによりプログラムが終了させられます。Rational ClearQuest API 呼び出しが失敗する可能性がある場合は、例外をキャッチして処理する必要があります。
通常、Perl エラーを処理するには、Perl の eval ステートメントを使用してエラーを分析します。次の構文を使用します。
eval {enter statements you want to monitor};
実行時に Perl エンジンが eval ブロックのステートメント内でエラーを検出した場合は、その eval ブロックのほかの部分をスキップし、対応するエラー テキストに $@ を設定します。
次に例を示します。
eval{$objectName->MethodName();};
if ($@)
{
print "Error using MethodName method. Error: $@¥n";
}
else
{
# continue without error ...
}
これに対する例外として、一般的に失敗することが予期されている関数がいくつかあります。特に、フィールドを検証する関数とフィールドを設定する関数は、例外をスローする代わりにエラー通知を戻します。詳しくは、「エラーのチェックと検証」を参照してください。