TP1/Client/W or TP1/Client/P

(a) _s version of the function

 
#include <dcvrpc.h>
DCLONG dc_rpc_open_s(DCCLT_ID cltid, DCLONG flags)
 

(b) Non-_s version of the function

 
#include <dcvrpc.h>
int dc_rpc_open(DCLONG flags)
 

Initializes the environment for calling OpenTP1 SPPs or using the TCP/IP communication function.

Execute the dc_rpc_open_s function before executing a remote procedure call, transaction control, or various functions for the transaction control.

• cltid
  Set the client ID received by the dc_clt_cltin_s function.
  
• flags
  Specifies the environment to be initialized.
  

  DCNOFLAGS

  Environment for calling SPPs

  DCCLT_ONEWAY_SND

  Environment for sending send-only messages

  DCCLT_ONEWAY_RCV

  Environment for receiving receive-only messages

  DCCLT_SNDRCV

  Environment for sending and receiving messages.

  If DCNOFLAGS is specified, the TCP/IP communication function cannot be used.
  Even if any other than DCNOFLAGS is specified, the RPC function can be used.
  If DCCLT_SNDRCV is specified, the DCCLT_ONEWAY_SND and DCCLT_ONEWAY_RCV must not be specified at the same time.
  

Return Value	Value (decimal)	Meaning
DC_OK	0	Normal termination
DCRPCER_INVALID_ARGS	-2401	Invalid argument
DCRPCER_PROTO	-2402	The dc_rpc_open_s function has already been issued. Alternatively, the dc_clt_cltin_s function has not been executed.
DCRPC_FATAL	-2403	The return value has been returned because of failure to initialize, or an invalid client environment definition.
DCRPCER_PORT_IN_USE	-2447	A specified port number is in use.
DCCLTER_INVALID_CLTID	-2544	The client ID specified in cltid differs from the client ID received by the dc_clt_cltin_s function.

Issuing the dc_rpc_close_s function must not be immediately followed by issuing the dc_rpc_open_s function with flags set to DCCLT_ONEWAY_RCV, as the following describes. The dc_rpc_open_s function can only be issued 15-20 seconds later.

• After the dc_rpc_open_s function is issued with flags set to DCCLT_ONEWAY_RCV, the dc_clt_receive_s function has been issued and a message is being received. The CUP issues the dc_rpc_close_s function to free the connection before the remote system frees it.