dc_adm_get_nd_status_next - Acquire the status of an OpenTP1 node

ANSI C, C++

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

K&R C

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

The function dc_adm_get_nd_status_next() acquires the status of one OpenTP1 node in the multinode area containing the user server which has called this function or of one OpenTP1 node in a specified multinode subarea.

This function acquires the status of the execution system when the function dc_adm_get_nd_status_next() is called with a specified OpenTP1 node for the system switch configuration.

The OpenTP1 node status as acquired by this function is the status which stood when the function dc_adm_get_nd_status_begin() was called.

node_id

Specify the pointer to the area which will receive the node identifier of the OpenTP1 node. A null character is added at the end of the node identifier. The length of the area must be equal to the length defined by DCADM_NODE_ID_SIZE.

flags

Specify DCNOFLAGS.

When the return value is positive (indicating the OpenTP1 node status):

Return value	Return value (numeric)	Explanation
DCADMER_STAT_NOT_UP	9	Communication with the specified OpenTP1 node is impossible for the following reason: The OpenTP1 at the OpenTP1 node must be defined or redefined with the dcsetup command. The value specified in the multinode physical definition is incorrect (the OpenTP1 node is not defined or the specified host name or port number is incorrect). A communication error occurred (power is not supplied to the OpenTP1 node machine or a network error occurred).
DCADM_STAT_TERM	8	The OpenTP1 node is halted or is being terminated abnormally.
DCADM_STAT_START_NORMAL	2	The OpenTP1 node is normally being started.
DCADM_STAT_START_RECOVER	3	The OpenTP1 node is normally being restarted.
DCADM_STAT_ONLINE	4	The OpenTP1 node is online.
DCADM_STAT_STOP	5	The OpenTP1 node is normally being terminated.
DCADM_STAT_STOPA	6	The OpenTP1 node is being terminated according to plan A.
DCADM_STAT_STOPB	7	The OpenTP1 node is being terminated according to plan B.
DCADM_STAT_SWAP	10	The system is being switched.

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

Return value	Return value (numeric)	Explanation
DCADMER_NO_MORE_ENTRY	-1865	There is no more OpenTP1 node. The statuses of all OpenTP1 nodes have been acquired.
DCADMER_COMM	-1851	An inter-process communication error occurred.
DCADMER_PARAM	-1852	The value specified for the argument is invalid.
DCADMER_PROTO	-1854	The function dc_adm_get_nd_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.
DCADMER_REMOTE	-1866	The OpenTP1 node identified by the node identifier returned to node_id cannot use the multinode facility for the following reason: 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. The memory became insufficient. The memory became insufficient.