dc_adm_get_nodeconf_next - Acquire a node identifier

ANSI C, C++

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

K&R C

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

The function dc_adm_get_nodeconf_next() acquires the node identifier of one node in the multinode area containing the user server which has called this function or one node in a multinode subarea.

The data acquired by this function is data which was effective when the function dc_adm_get_nodeconf_begin() was called.

node_id

Specify the pointer to the area which will receive the node identifier. 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.

Return value	Return value (numeric)	Explanation
DC_OK	0	Normal termination.
DCADMER_NO_MORE_ENTRY	-1865	There is no more OpenTP1 node. All node identifiers have been acquired.
DCADMER_PARAM	-1852	The value specified for the argument is invalid.
DCADMER_PROTO	-1854	The function dc_adm_get_nodeconf_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.