6.4.1 開始終了UOC
機能
システムテスト支援の開始・終了時、およびコマンドによる実行形態の追加・削除時にUOCを実行します。
形式
ANSI C、C++の形式
#include <escom.h> ESLONG uoc_func(ESSTENINTERFACE *parm)
説明
システムテスト支援を開始・終了、または実行形態を追加・削除する時に呼び出されるUOCです。システムテスト支援は、各情報を格納したパラメタの領域アドレスを引数としてUOCに渡します。
システムテスト支援は、uoc_func(開始終了UOC)を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。
パラメタの内容
ESSTENINTERFACEのパラメタ内容
typedef struct es_sten_interface { char testid[32]; ……… テスト識別子 ESULONG call_timing; ……… 呼び出しタイミング ESULONG run_mode; ………実行形態 ESULONG abort_code; ………強制停止理由コード char reserve1[20];……… 予備領域 } ESSTENINTERFACE;
システムテスト支援が設定するパラメタ項目
- testid
-
システムテスト支援開始時に指定したテスト識別子を設定します。
- call_timing
-
呼び出しタイミングを設定します。
ES_PROC_ST:プロセス開始時
ES_PROC_EN:プロセス終了時
ES_MODE_AD:実行形態追加時
ES_MODE_DL:実行形態削除時
- run_mode
-
実行形態を設定します。実行形態が複数の場合は論理和で設定します。
ESCLT_RUNMODE_P:並行実行
ESCLT_RUNMODE_A:蓄積実行
ESCLT_RUNMODE_R:リプレイ実行
ESCLT_RUNMODE_C:PCAP実行
呼び出しタイミングがプロセス開始、実行形態追加、実行形態削除の場合、esstart、esmodadd、
esmoddelコマンドで指定された実行形態を設定します。
呼び出しタイミングがプロセス終了の場合は実行中の実行形態を設定します。
ユーザが設定するパラメタ項目
- abort_code
-
システム検証支援を強制停止する理由を示すコードを0 ~ 4294967295の範囲で設定できます。
このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。
リターン値
次のコードでリターン値を設定してください。
- ES_UOC_OK
-
正常リターン。処理を続行します。
- ES_UOC_NG
-
異常リターン。呼び出しタイミングに応じて異常処理を行います。
-
プロセス開始時
異常終了します。
-
プロセス終了時
処理を続行します。(ES_UOC_OKとして扱います)
-
実行形態追加/実行形態削除時
実行形態の追加、または削除を中止します。
-
- ES_UOC_ABORT
-
異常リターン。KFSE64109-Eメッセージを出力し、プロセスダウンします。
- 上記以外
-
異常リターン。ES_UOC_NGと同じ動作をします。