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 valueReturn value (numeric)Explanation
DCADM_STAT_TERM8The user server is halted or is being terminated abnormally.
DCADM_STAT_START_NORMAL2The user server is normally being started.
DCADM_STAT_START_RECOVER3The user server is being restarted.
DCADM_STAT_ONLINE4The user server is online.
DCADM_STAT_STOP5The user server is normally being terminated.

When the return value is negative (indicating an error):

Return valueReturn value (numeric)Explanation
DCADMER_NO_MORE_ENTRY-1865There is no more user server. The statuses of all user servers have been acquired.
DCADMER_PARAM-1852The value specified for the argument is invalid.
DCADMER_PROTO-1854The function dc_adm_get_sv_status_begin() was not called.
The function dc_rpc_open() was not called.
DCADMER_MULTI_DEF-1864N 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.