OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

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.