OpenTP1 Version 7 Programming Reference C Language
dc_adm_status - Report the status of a user server
Format
ANSI C, C++
#include <dcadm.h> int dc_adm_status (DCLONG flags) |
K&R C
#include <dcadm.h> int dc_adm_status (flags) DCLONG flags; |
Description
The function dc_adm_status() reports the status of the user server that called the function. The user server status is reported with the return value.
Argument whose value is set in the UAP
flags
Specify DCNOFLAGS.
Return values
When the return value is positive (indicating the user server status):
Return value | Return value (numeric) | Explanation |
---|---|---|
DCADM_STAT_START_NORMAL | 2 | The user server is being started normally. |
DCADM_STAT_START_RECOVER | 3 | The user server is being restarted normally. |
DCADM_STAT_ONLINE | 4 | The user server is in online mode. |
DCADM_STAT_STOP | 5 | The user server is being terminated. |
When the return value is negative (indicating an error):
Return value | Return value (numeric) | Explanation |
---|---|---|
DCADMER_COMM | -1851 | An error occurred during communication between processes. |
DCADMER_PARAM | -1852 | The argument value is invalid. |
DCADMER_STS_IO | -1853 | A status information input/output error occurred. |
DCADMER_PROTO | -1854 | The function dc_adm_status() was called from a UAP that handles offline work. The function dc_adm_status() cannot be used with UAP that handles offline work. |
The function dc_rpc_open() was not called. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.