dc_adm_get_sv_status_begin

〈このページの構成〉

名称
形式
機能
UAPで値を設定する引数
リターン値

名称

ユーザサーバのステータス取得の開始

形式

ANSI C ，C++の形式

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

K&R版 C の形式

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

ページの先頭へ

機能

指定したノード識別子にあるユーザサーバの状態の取得を開始します。この関数が正常に終了すると，状態を取得する対象となるユーザサーバの個数をリターンします。

ページの先頭へ

UAPで値を設定する引数

●node_id

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

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

●entry_count

ユーザサーバの個数をリターンする領域へのポインタを設定します。ここに設定した領域へ，node_idに設定したOpenTP1ノードにあるユーザサーバの個数をリターンします。

●flags

DCNOFLAGSを設定します。

ページの先頭へ

リターン値

リターン値	リターン値（数値）	意味
DC_OK	0	正常に終了しました。entry_countに示す領域に，ユーザサーバ数を格納しました。
DCADMER_COMM	-1851	指定したOpenTP1ノードとは，次に示す理由で通信できません。 OpenTP1ノードのOpenTP1を，dcsetupコマンドで登録するか，または登録し直す必要があります。マルチノード物理定義に指定した値が間違っています（OpenTP1ノードを登録していないか，指定したホスト名，またはポート番号が間違っています）。通信障害が起こりました（OpenTP1ノードのマシンの電源を入れていない，またはネットワーク障害が起こりました）。
DCADMER_PARAM	-1852	引数に設定した値が間違っています。
DCADMER_PROTO	-1854	dc_adm_get_sv_status_begin関数は，すでに呼び出しています。
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	系切り替えが起こっているため，ユーザサーバの状態を取得できません。

ページの先頭へ