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_NORMAL |
2 |
ユーザサーバは正常開始中です。 |
DCADM_STAT_START_RECOVER |
3 |
ユーザサーバは再開始中です。 |
DCADM_STAT_ONLINE |
4 |
ユーザサーバはオンライン中です。 |
DCADM_STAT_STOP |
5 |
ユーザサーバは正常終了処理中です。 |
DCADM_STAT_TERM |
8 |
ユーザサーバが停止中です。または異常終了中です。 |
リターン値が負の値のとき(エラーが起こったことを示します)
リターン値 |
リターン値(数値) |
意味 |
---|---|---|
DCADMER_COMM |
-1851 |
指定したOpenTP1ノードとは,次に示す理由で通信できません。
|
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ノードでは,次に示す理由でマルチノード機能は使えません。
|
DCADMER_NODE_NOT_EXIST |
-1867 |
node_idに設定したノード識別子に該当するOpenTP1ノードはありません。 |
DCADMER_SWAP |
-1868 |
系切り替えが起こっているため,ユーザサーバの状態を取得できません。 |