OpenTP1 Version 7 Programming Reference C Language
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:
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.