OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P

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

4.3.5 dc_rpc_set_watch_time_s - Updating the wait time for service response

Organization of this subsection
(1) Form
(2) Purpose
(3) Arguments set by UAPs
(4) Return values

(1) Form

(a) _s version of the function
 
#include <dcvrpc.h>
DCLONG dc_rpc_set_watch_time_s(DCCLT_ID cltid, DCLONG var)
 
(b) Non-_s version of the function
 
#include <dcvrpc.h>
DCLONG dc_rpc_set_watch_time(DCLONG var)
 

(2) Purpose

Changes the timeout for the response of the service request. When the timeout is changed by using this function, the subsequent dc_rpc_call_s functions will use the new timeout until the dc_rpc_close_s function is executed. Note that this function does not change the value of DCWATCHTIM in the client environment definition.

Before you change the timeout by executing the dc_rpc_set_watch_time_s function, execute the dc_rpc_get_watch_time_s function to acquire the current value so that you can restore the previous setting after changing the timeout.

(3) Arguments set by UAPs

(4) Return values

Return Value Value (decimal) Meaning
DC_OK 0 Normal termination
DCRPCER_INVALID_ARGS -2401 An invalid value is specified for var.
DCRPCER_PROTO -2402 The dc_rpc_open_s function is not executed.
DCRPCER_NO_BUFS -2404 Insufficient memory
DCRPCER_INVALID_CLTID -2544 The client ID specified for cltid differs from the one received from the dc_clt_cltin_s function.