dc_adm_get_sv

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

ANSI C ，C++の形式

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

K&R版 C の形式

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

●node_id

ノード識別子，または文字列 '＊' へのポインタを設定します。ノード識別子の後ろには，ヌル文字を付けます。文字列 '＊' へのポインタを設定した場合は，この関数を呼び出したOpenTP1ノードを指定したと仮定されます。

ノード識別子の長さは，DCADM_NODE_ID_LENで定義されている長さにしてください。これ以外の長さの名称を設定した場合は，エラーリターンします。

●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_COMM	-1851	指定したOpenTP1ノードとは，次に示す理由で通信できません。 OpenTP1ノードのOpenTP1を，dcsetupコマンドで登録するか，または登録し直す必要があります。マルチノード物理定義に指定した値が間違っています（OpenTP1ノードを登録していないか，指定したホスト名，またはポート番号が間違っています）。通信障害が起こりました（OpenTP1ノードのマシンの電源を入れていない，またはネットワーク障害が起こりました）。
DCADMER_PARAM	-1852	引数に設定した値が間違っています。
DCADMER_PROTO	-1854	dc_rpc_open関数を呼び出していません。
DCADMER_MEMORY	-1861	メモリが不足しました。
DCADMER_DEF	-1862	マルチノード構成定義に指定した値が間違っています。
DCADMER_MULTI_DEF	-1864	システム共通定義のmulti_node_optionオペランドにNを指定しています。または，マルチノード物理定義に指定した値が間違っています。
		システムにTP1/Multiが組み込まれていません。
		システムに正しいバージョンのTP1/Multiが組み込まれていません。
DCADMER_REMOTE	-1866	指定したOpenTP1ノードでは，次に示す理由でマルチノード機能は使えません。システム共通定義のmulti_node_optionオペランドにNを指定しています。システムにTP1/Multiが組み込まれていません。システムに正しいバージョンのTP1/Multiが組み込まれていません。メモリが不足しました。
DCADMER_NODE_NOT_EXIST	-1867	node_idに設定したノード識別子に該当するOpenTP1ノードはありません。
DCADMER_SWAP	-1868	系切り替えが起こっているため，ユーザサーバの状態を取得できません。