Hitachi

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


dc_adm_get_nd_status

〈このページの構成〉

名称

指定したOpenTP1ノードのステータスの取得

形式

ANSI C C++の形式

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

K&R版 C の形式

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

機能

指定したOpenTP1ノードのステータスを取得します。

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

UAPで値を設定する引数

●node_id

ノード識別子へのポインタを設定します。ノード識別子の後ろにはヌル文字を付けます。

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

●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ノードとは,次に示す理由で通信できません。

  • OpenTP1ノードのOpenTP1を,dcsetupコマンドで登録するか,または登録し直す必要があります。

  • マルチノード物理定義に指定した値が間違っています(OpenTP1ノードを登録していないか,指定したホスト名,またはポート番号が間違っています)。

  • 通信障害が起こりました(OpenTP1ノードのマシンの電源を入れていない,またはネットワーク障害が起こりました)。

DCADM_STAT_SWAP

10

系切り替えが起こっています。

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

リターン値

リターン値(数値)

意味

DCADMER_COMM

-1851

プロセス間の通信エラーが起こりました。

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ノードはありません。