dc_adm_get_nd_status_next

名称

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関数を呼び出した時点のものです。

UAPで値を設定する引数

●node_id

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

●flags

DCNOFLAGSを設定します。

リターン値

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

リターン値リターン値(数値)意味
DCADM_STAT_START_NORMAL2OpenTP1ノードは正常開始中です。
DCADM_STAT_START_RECOVER3OpenTP1ノードは再開始(リラン)中です。
DCADM_STAT_ONLINE4OpenTP1ノードはオンライン中です。
DCADM_STAT_STOP5OpenTP1ノードは正常終了処理中です。
DCADM_STAT_STOPA6OpenTP1ノードは計画停止Aで終了処理中です。
DCADM_STAT_STOPB7OpenTP1ノードは計画停止Bで終了処理中です。
DCADM_STAT_TERM8OpenTP1ノードが停止中です。または異常終了中です。
DCADMER_STAT_NOT_UP9指定したOpenTP1ノードとは,次に示す理由で通信できません。
  • OpenTP1ノードのOpenTP1を,dcsetupコマンドで登録するか,または登録し直す必要があります。
  • マルチノード物理定義に指定した値が間違っています(OpenTP1ノードを登録していないか,指定したホスト名,またはポート番号が間違っています)。
  • 通信障害が起こりました(OpenTP1ノードのマシンの電源を入れていない,またはネットワーク障害が起こりました)。
DCADM_STAT_SWAP10系切り替えが起こっています。

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

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