dc_adm_get_sv_status_next - Acquire the status of a user server

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;

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.

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.

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.
DCADMER_PROTO	-1854	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.