dc_adm_get_sv_status_begin
名称
ユーザサーバのステータス取得の開始
形式
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ノードとは,次に示す理由で通信できません。
|
DCADMER_PARAM | -1852 | 引数に設定した値が間違っています。 |
DCADMER_PROTO | -1854 | dc_adm_get_sv_status_begin関数は,すでに呼び出しています。 |
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ノードでは,次に示す理由でマルチノード機能は使えません。
|
DCADMER_NODE_NOT_EXIST | -1867 | node_idに設定したノード識別子に該当するOpenTP1ノードはありません。 |
DCADMER_SWAP | -1868 | 系切り替えが起こっているため,ユーザサーバの状態を取得できません。 |