dc_uto_test

分散トランザクション処理機能　OpenTP1 プログラム作成リファレンス C言語編

ANSI C ，C++の形式

 
#include <dcuto.h>
int  dc_uto_test_status(struct DC_UTOSTAT *test_stat,
                        DCLONG flags)

K&R版 C の形式

 
#include <dcuto.h>
int  dc_uto_test_status(test_stat,flags)
struct  DC_UTOSTAT  *test_stat;
DCLONG     flags;

●test_stat

ユーザサーバのテスト状態を示す情報が，構造体で返されます。構造体の形式は次のとおりです。

 
struct  DC_UTOSTAT {
                    char  testID[5];
                    char  mode;
                    char  gbl_tran;
                    char  type;
                    char  svr_tran;
                    char  comd;
                    char  _res[22];
                    };

testID
テストユーザID（環境変数 DCUTOKEYに設定した値）が設定されます。
mode
ユーザサーバがテストモードで稼働しているかどうかが設定されます。

DCUTO_TEST

テストモードで稼働しています。

DCUTO_NOTEST

テストモードで稼働していません。
gbl_tran
グローバルトランザクションの処理状態が設定されます。

DCUTO_TRN_COMMIT

同期点処理でコミットします。

DCUTO_TRN_ROLLBACK

同期点処理でロールバックします。

DCUTO_TRN_NOTRN

非トランザクションの状態です。

NULL（ヌル文字）

非テストモードです。または，MCFのライブラリを結合したMHPです。
type
ユーザサービス定義のtest_modeオペランドに指定した，テスト種別が設定されます。

DCUTO_TEST_MODE_TARGET

テスト専用UAP（target）としてテストしています。

DCUTO_TEST_MODE_USABLE

使用可能UAP（usable）としてテストしています。

DCUTO_TEST_MODE_SIMMHP

シミュレートMHP（simmhp）としてテストしています。

DCUTO_TEST_MODE_NO

テスト対象外UAP（no）です。
svr_tran
ユーザサービス定義のtest_transaction_commitオペランドで指定した，トランザクションの同期点の扱いが設定されます。

DCUTO_TRN_COMMIT

同期点でコミット（Y）します。

DCUTO_TRN_ROLLBACK

同期点でロールバック（N）します。

NULL（ヌル文字）

非テストモードです。または，MCFのライブラリを結合したMHPです。
comd
ユーザサービス定義のtest_adm_call_commandオペランドで指定した，コマンドの実行結果の扱いが設定されます。

DCUTO_COMMAND_DO

コマンドを実行（do）します。

DCUTO_COMMAND_SKIP

実行結果に仮定値を設定（skip）します。

DCUTO_COMMAND_FILE

運用コマンド結果データファイルのデータを使用（file）します。

NULL（ヌル文字）

非テストモードです。または，MCFのライブラリを結合したMHPです。

リターン値	リターン値（数値）	意味
DC_OK	0	正常に終了しました。構造体 DC_UTOSTATに示す領域にテストの状態が設定されました。
DCUTOER_PROTO	-2701	dc_rpc_open関数を呼び出していません。
DCUTOER_TRAN	-2734	UAPが，現在稼働しているトランザクションサービスでは動作できないバージョンのOpenTP1ライブラリと結合されています。
DCUTOER_PARAM_FLAGS	-2757	flagsに設定した値が間違っています。
DCUTOER_PARAM_ADDS	-2758	test_statに設定した値が間違っています。