dc_adm_get_nd_status_next
- 〈このページの構成〉
形式
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関数を呼び出した時点のものです。
UAPで値を設定する引数
●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ノードが停止中です。または異常終了中です。 |
DCADM_STAT_NOT_UP |
9 |
指定した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ノードでは,次に示す理由でマルチノード機能は使えません。
|