OpenTP1 Version 7 Programming Reference C Language

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

dc_uto_test_status - Report the test status of a user server

Format

ANSI C, C++

#include <dcuto.h>
int  dc_uto_test_status (struct DC_UTOSTAT *test_stat,
                         DCLONG flags)

K&R C

#include <dcuto.h>
int  dc_uto_test_status (test_stat, flags)
struct  DC_UTOSTAT  *test_stat;
DCLONG     flags;

Description

The function dc_uto_test_status() returns the status of testing a user server that called this function. The test status is stored in an argument after this function returns normally. If this function returns with an error, information on the test status stored in the argument is undefined.

Arguments whose values are set in the UAP

test_stat

Specify the address of the structure indicating the status of testing a user server.

flags

Specify DCNOFLAGS.

Arguments whose values are returned from the OpenTP1

test_stat

Information on the status of testing a user server is returned with a structure. The structure formats are as follows:

struct  DC_UTOSTAT {
                      char  testID[5];
                      char  mode;
                      char  gbl_tran;
                      char  type;
                      char  svr_tran;
                      char  comd;
                      char  _res[22];
};

Return values

Return value Return value (numeric) Explanation
DC_OK 0 Normal termination. The test status is returned in the area indicated by the structure DC_UTOSTAT.
DCUTOER_PROTO -2701 The function dc_rpc_open() is not called.
DCUTOER_TRAN -2734 The UAP is linked with an OpenTP1 library which is inoperable with the current transaction service.
DCUTOER_PARAM_FLAGS -2757 The value specified for flags is invalid.
DCUTOER_PARAM_ADDS -2758 The value specified for test_stat is invalid.

Note

When the function dc_uto_test_status() is called from an MHP, the following values are returned to the structure DC_UTOSTAT: