Hitachi

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


dc_adm_get_sv_status_next

〈このページの構成〉

名称

ユーザサーバのステータスの取得

形式

ANSI C ,C++の形式

#include <dcadm.h>
int  dc_adm_get_sv_status_next(char *sv_name,DCLONG flags)

K&R版 C の形式

#include <dcadm.h>
int  dc_adm_get_sv_status_next(sv_name,flags)
char       *sv_name;
DCLONG     flags;

機能

指定したOpenTP1ノードにあるユーザサーバの状態を取得します。

取得するデータは,dc_adm_get_sv_status_begin関数を呼び出したタイミングで取得したデータです。

UAPで値を設定する引数

●sv_name

ユーザサーバ名を受け取る領域へのポインタを設定します。この領域には,SERVER_NAME_SIZEで定義している長さが必要です。

●flags

DCNOFLAGSを設定します。

リターン値

リターン値が正の値のとき(ユーザサーバの状態を示します)

リターン値

リターン値(数値)

意味

DCADM_STAT_START_NORMAL

2

ユーザサーバは正常開始中です。

DCADM_STAT_START_RECOVER

3

ユーザサーバは再開始中です。

DCADM_STAT_ONLINE

4

ユーザサーバはオンライン中です。

DCADM_STAT_STOP

5

ユーザサーバは正常終了処理中です。

DCADM_STAT_TERM

8

ユーザサーバが停止中です。または異常終了中です。

リターン値が負の値のとき(エラーが起こったことを示します)

リターン値

リターン値(数値)

意味

DCADMER_PARAM

-1852

引数に設定した値が間違っています。

DCADMER_PROTO

-1854

dc_adm_get_sv_status_begin関数を呼び出していません。

dc_rpc_open関数を呼び出していません。

DCADMER_MULTI_DEF

-1864

システム共通定義のmulti_node_optionオペランドにNを指定しています。

システムにTP1/Multiが組み込まれていません。

システムに正しいバージョンのTP1/Multiが組み込まれていません。

DCADMER_NO_MORE_ENTRY

-1865

ユーザサーバは,これ以上ありません。すべてのユーザサーバの状態の取得を終了しました。