dc_adm_get_sv_status

名称

指定したユーザサーバのステータスの取得

形式

ANSI C ,C++の形式

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

K&R版 C の形式

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

機能

指定したノード識別子にあるユーザサーバの状態を取得します。

UAPで値を設定する引数

●node_id

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

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

●sv_name

ユーザサーバ名がある領域へのポインタを設定します。ユーザサーバ名の長さは,SERVER_NAME_SIZEで定義されている最大長以下にしてください。この最大長を超えた名称を設定した場合は,エラーリターンします。

●flags

DCNOFLAGSを設定します。

リターン値

リターン値が正の値のとき(ユーザサーバの状態を示します)

リターン値リターン値(数値)意味
DCADM_STAT_START_NORMAL2ユーザサーバは正常開始中です。
DCADM_STAT_START_RECOVER3ユーザサーバは再開始中です。
DCADM_STAT_ONLINE4ユーザサーバはオンライン中です。
DCADM_STAT_STOP5ユーザサーバは正常終了処理中です。
DCADM_STAT_TERM8ユーザサーバが停止中です。または異常終了中です。

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

リターン値リターン値(数値)意味
DCADMER_COMM-1851指定したOpenTP1ノードとは,次に示す理由で通信できません。
  • OpenTP1ノードのOpenTP1を,dcsetupコマンドで登録するか,または登録し直す必要があります。
  • マルチノード物理定義に指定した値が間違っています(OpenTP1ノードを登録していないか,指定したホスト名,またはポート番号が間違っています)。
  • 通信障害が起こりました(OpenTP1ノードのマシンの電源を入れていない,またはネットワーク障害が起こりました)。
DCADMER_PARAM-1852引数に設定した値が間違っています。
DCADMER_PROTO-1854dc_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-1867node_idに設定したノード識別子に該当するOpenTP1ノードはありません。
DCADMER_SWAP-1868系切り替えが起こっているため,ユーザサーバの状態を取得できません。