RFC Client-Side Runtime Control

使用する
手順

使用する

ここで説明するクラスを使用して、エラーのあるバックグラウンドユニットを再起動したり、それらを削除したりできます。インバウンドとアウトバウンドのbgRFCタイプtとタイプqの組み合わせごとにクラスが存在します。

グラフィック：クライアントメソッド

手順

メソッドGET_UNIT_STATEは、バックグラウンドユニットの次のステータスを返します。

戻り値	意味
IF_BGRFC_CLIENT => UNIT_STATE_BLOCKED	キューが定義されているため、他のキューを最初に実行する必要があるため、ユニットunit_idはまだ実行できません。
IF_BGRFC_CLIENT => UNIT_STATE_LOCKED	ユニットunit_idは、このユニットにロックが設定されているか、ユニットがロックされたキューの一部であるため、実行できません。
IF_BGRFC_CLIENT => UNIT_STATE_COMMUNICATION_ERR	宛先システムとの通信エラーにより、ユニットunit_idを実行できませんでした。
IF_BGRFC_CLIENT => UNIT_STATE_EXECUTION_ERR	ユニットunit_idの実行中にエラーが発生しました。
IF_BGRFC_CLIENT => UNIT_STATE_EXECUTED	ユニットunit_idがすでに実行されているか、 unit_idの値が有効なユニットを指定していません。
IF_BGRFC_CLIENT => UNIT_STATE_RUNNABLE	ユニットunit_idを実行できます。
IF_BGRFC_CLIENT => UNIT_STATE_IN_EXECUTION	ユニットunit_idが実行されています。
IF_BGRFC_CLIENT => QUEUE_STATE_UNKNOWN	ユニットの状態は不明です。

複数の戻りコードが可能な場合は、一番上のコードが返されます。

さらに、 GET_QUEUE_STATEメソッドを使用して、qRFCユニットのキューのステータスを照会できます。次のいずれかのステータスを返すことができます。

戻り値	意味
IF_BGRFC_CLIENT => QUEUE_STATE_LOCKED	キューの最初のユニットはロックされています。この値は、現在のキュー位置に設定されているキューロックがキューの先頭に達した場合にも返されます。
IF_BGRFC_CLIENT => QUEUE_STATE_COMMUNICATION_ERR	宛先システムとの通信エラーにより、キューの最上位ユニットを実行できませんでした。
IF_BGRFC_CLIENT => QUEUE_STATE_EXECUTION_ERR	キューの最上位ユニットの実行中にエラーが発生しました。
IF_BGRFC_CLIENT => QUEUE_STATE_EMPTY	キューは空です。
IF_BGRFC_CLIENT => QUEUE_STATE_RUNNABLE	キューの最初のユニットを実行できます。
IF_BGRFC_CLIENT => QUEUE_STATE_IN_EXECUTION	キューの最初のユニットが実行されています。
IF_BGRFC_CLIENT => UNIT_STATE_BLOCKED	ユニットは前のユニットによってブロックされています。
IF_BGRFC_CLIENT => UNIT_STATE_EXECUTED	ユニットは正常に実行されます。
IF_BGRFC_CLIENT => UNIT_STATE_INVALID_UNIT_ID	不明なユニットID。
IF_BGRFC_CLIENT => UNIT_STATE_RETRY	ユニットは再度実行されるため、ロックされます。
IF_BGRFC_CLIENT => UNIT_STATE_UNKNOWN	ユニットの状態は不明です。

エラーのあるユニットによってキューがブロックされている場合、このユニットのunit_idは、 GET_FAILD_UNIT_BY_QUEUEメソッドを呼び出すことで検出できます。

エラーのあるユニットは、 RUN_FAILED_UNITを呼び出すことで再開できます。このメソッドは、スケジューラーにユニットを再起動させ、ユニットが実行されるまで待機しません。ユニットの遡及開始試行回数と最後の開始試行の瞬間が自動的にログに記録され、モニターに表示されます。ユニットが正常に処理された後、ユニットは削除され、以下のユニットがスケジューラーによって自動的に開始される可能性があります。ユニットが正常に処理されなかった場合、このキューは次のキューをブロックし続けます。指定されたユニットでエラーが発生しなかった場合、例外CX_RFC_NO_FAILED_LUWが発生します。テキスト要素LUW_NOT_FOUNDを持つ例外CX_RFC_INVALID_LUWは、このunit_idを持つユニットがないことを指定します。

エラーのあるユニットは、 DELETE_FAILED_UNITメソッドを使用して削除できます。この削除プロセスは、常にトレースレコードによってログに記録されます。