OpenTP1ノードのステータスの取得

ANSI C ，C++の形式

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

K&R版 C の形式

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

この関数を呼び出したユーザサーバがあるマルチノードエリアのOpenTP1ノード，または指定したマルチノードサブエリアにあるOpenTP1ノードの状態を，1件取得します。

系切り替え構成のOpenTP1ノードを指定してdc_adm_get_nd_status_next関数を呼び出した場合は，実行系の状態を取得します。

この関数で取得するOpenTP1ノードの状態は，dc_adm_get_nd_status_begin関数を呼び出した時点のものです。

●node_id

OpenTP1ノードのノード識別子を受け取る領域へのポインタを設定します。ノード識別子の最後にはヌル文字が設定されます。この領域は，DCADM_NODE_ID_SIZEで定義している長さだけ必要です。

●flags

DCNOFLAGSを設定します。

リターン値が正の値のとき（OpenTP1ノードの状態を示します）

リターン値	リターン値（数値）	意味
DCADM_STAT_START_NORMAL	2	OpenTP1ノードは正常開始中です。
DCADM_STAT_START_RECOVER	3	OpenTP1ノードは再開始（リラン）中です。
DCADM_STAT_ONLINE	4	OpenTP1ノードはオンライン中です。
DCADM_STAT_STOP	5	OpenTP1ノードは正常終了処理中です。
DCADM_STAT_STOPA	6	OpenTP1ノードは計画停止Aで終了処理中です。
DCADM_STAT_STOPB	7	OpenTP1ノードは計画停止Bで終了処理中です。
DCADM_STAT_TERM	8	OpenTP1ノードが停止中です。または異常終了中です。
DCADMER_STAT_NOT_UP	9	指定したOpenTP1ノードとは，次に示す理由で通信できません。 OpenTP1ノードのOpenTP1を，dcsetupコマンドで登録するか，または登録し直す必要があります。 マルチノード物理定義に指定した値が間違っています（OpenTP1ノードを登録していないか，指定したホスト名，またはポート番号が間違っています）。 通信障害が起こりました（OpenTP1ノードのマシンの電源を入れていない，またはネットワーク障害が起こりました）。
DCADM_STAT_SWAP	10	系切り替えが起こっています。

リターン値が負の値のとき（エラーが起こったかどうかを示します）

リターン値	リターン値（数値）	意味
DCADMER_COMM	-1851	プロセス間の通信エラーが起こりました。
DCADMER_PARAM	-1852	引数に設定した値が間違っています。
DCADMER_PROTO	-1854	dc_adm_get_nd_status_begin関数を呼び出していません。
		dc_rpc_open関数を呼び出していません。
DCADMER_MULTI_DEF	-1864	システム共通定義のmulti_node_optionオペランドにNを指定しています。
		システムにTP1/Multiが組み込まれていません。
		システムに正しいバージョンのTP1/Multiが組み込まれていません。
DCADMER_NO_MORE_ENTRY	-1865	OpenTP1ノードは，これ以上ありません。 すべてのOpenTP1ノードの状態を取得し終わりました。
DCADMER_REMOTE	-1866	node_idに返されたノード識別子で示す OpenTP1ノードでは，次に示す理由でマルチノード機能は使えません。 システム共通定義のmulti_node_optionオペランドにNを指定しています。 システムにTP1/Multiが組み込まれていません。 システムに正しいバージョンのTP1/Multiが組み込まれていません。 メモリが不足しました。