OpenTP1 Version 7 Programming Reference C Language
dc_adm_get_nd_status - Acquire the status of a specified OpenTP1 node
Format
ANSI C, C++
#include <dcadm.h> int dc_adm_get_nd_status (char *node_id, DCLONG flags) |
K&R C
#include <dcadm.h> int dc_adm_get_nd_status (node_id, flags) char *node_id; DCLONG flags; |
Description
The function dc_adm_get_nd_status() acquires the status of a specified OpenTP1 node.
This function acquires the status of the execution system when the function dc_adm_get_nd_status() is called with a specified OpenTP1 node for the system switch configuration.
Arguments whose value is set in the UAP
node_id
Specify the pointer to the node identifier. Add a null character after the node identifier.
The length of the node identifier must be equal to the length defined by DCADM_NODE_ID_LEN. If a node identifier with a different length is specified, the function returns with an error.
flags
Specify DCNOFLAGS.
Return values
When the return value is positive (indicating the OpenTP1 node status):
Return value | Return value (numeric) | Explanation |
---|---|---|
DCADM_STAT_NOT_UP | 9 | Communication with the specified OpenTP1 node is impossible for the following reason:
|
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_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_rpc_open() was not called. |
DCADMER_MEMORY | -1861 | The memory became insufficient. |
DCADMER_DEF | -1862 | An incorrect value is specified in the multinode configuration definition or in the multinode physical definition. |
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 specified OpenTP1 node cannot use the multinode facility for the following reason:
|
DCADMER_NODE_NOT_EXIST | -1867 | The node identified by node_id is not included in the OpenTP1 nodes. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.