OpenTP1 Version 7 Programming Reference C Language
dc_adm_get_nodeconf_next - Acquire a node identifier
Format
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; |
Description
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.
Arguments whose value is set in the UAP
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 values
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. |
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.