OpenTP1 Version 7 Programming Reference C Language
dc_adm_get_sv_status_next - Acquire the status of a user server
Format
ANSI C, C++
#include <dcadm.h> int dc_adm_get_sv_status_next (char *sv_name, DCLONG flags) |
K&R C
#include <dcadm.h> int dc_adm_get_sv_status_next (sv_name, flags) char *sv_name; DCLONG flags; |
Description
The function dc_adm_get_sv_status_next() acquires the statuses of user servers at a specified OpenTP1 node.
The data acquired by this function is data which was effective when the function dc_adm_get_sv_status_begin() was called.
Arguments whose value is set in the UAP
sv_name
Specify the pointer to the area which will receive the user server name. The length of the area must be equal to the length defined by SERVER_NAME_SIZE.
flags
Specify DCNOFLAGS.
Return values
When the return value is positive (indicating the status of the user server):
Return value | Return value (numeric) | Explanation |
---|---|---|
DCADM_STAT_TERM | 8 | The user server is halted or is being terminated abnormally. |
DCADM_STAT_START_NORMAL | 2 | The user server is normally being started. |
DCADM_STAT_START_RECOVER | 3 | The user server is being restarted. |
DCADM_STAT_ONLINE | 4 | The user server is online. |
DCADM_STAT_STOP | 5 | The user server is normally being terminated. |
When the return value is negative (indicating an error):
Return value | Return value (numeric) | Explanation |
---|---|---|
DCADMER_NO_MORE_ENTRY | -1865 | There is no more user server. The statuses of all user servers have been acquired. |
DCADMER_PARAM | -1852 | The value specified for the argument is invalid. |
DCADMER_PROTO | -1854 | The function dc_adm_get_sv_status_begin() was not called. |
The function dc_rpc_open() was not called. | ||
DCADMER_MULTI_DEF | -1864 | N is specified for multi_node_option in the system common definition. |
The TP1/Multi is not installed in the system. | ||
The correct version TP1/Multi is not installed in the system. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.