(a) TP1/Client/W

_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_send_s(DCCLT_ID cltid, char *buff,
                     DCLONG sendleng, char *hostname,
                     unsigned short portnum, DCLONG flags)
 

Non-_s version of the function

 
#include <dcvclt.h>
int dc_clt_send(char *buff, DCLONG sendleng,
                char *hostname,
                unsigned short portnum, DCLONG flags)
 

(b) TP1/Client/P

_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_send_s(DCCLT_ID cltid, char CLTFAR *buff,
                     DCLONG sendleng,
                     char CLTFAR *hostname,
                     unsigned short portnum, DCLONG flags)
 

Non-_s version of the function

 
#include <dcvclt.h>
int dc_clt_send(char CLTFAR *buff, DCLONG sendleng,
                char CLTFAR *hostname,
                unsigned short portnum, DCLONG flags)
 

Sends messages to the MHP.

Before issuing the dc_clt_send_s function, the dc_rpc_open_s function with flags set to DCCLT_ONEWAY_SND or DCCLT_SNDRCV must be issued.

• cltid
  Set the client ID received by the dc_clt_cltin_s function.
  
• buff
  Set the area that contains messages to send. The area must be greater than the length specified in sendleng.
  
• sendleng
  Set the length of a message to send.
  
• hostname
  Specify the host name of the node to be connected when no connection is established.
  If NULL is specified, the function accesses the contents of DCSNDHOST in the client environment definition that was acquired when the dc_rpc_open_s function was issued.
  You can specify a maximum of 63^# characters for the host name.
  You can specify an IP address in decimal dot notation for the host name.
  

  # If you specify 00000008 for DCCLTOPTION in the client environment definition, you can specify a maximum of 255 characters for the host name.

• portnum
  Specify the port number of the node to be connected by establishing a connection when no connection is established.
  If 0 is specified, the function accesses the contents of DCSNDPORT in the client environment definition that was acquired when the dc_rpc_open_s function was issued.
  
• flags
  Specify whether to release the connection after sending message.
  

  DCNOFLAGS

  Does not release the connection after sending message.

  DCCLT_SND_CLOSE

  Releases the connection after sending message.

  Except error situations, specifying DCNOFLAGS maintains the connection until you issue the dc_rpc_close_s function.
  

Return Value	Value (decimal)	Meaning
DC_OK	0	Normal termination
DCCLTER_INVALID_ARGS	-2501	Invalid argument
DCCLTER_PROTO	-2502	The dc_rpc_open_s function has not been issued. Or else, the dc_rpc_open_s function has been issued with DCCLT_ONEWAY_SND or DCCLT_SNDRCV not specified in flags.
DCCLTER_NO_BUFS	-2504	Insufficient memory
DCCLTER_NET_DOWN	-2506	Network error
DCCLTER_TIMED_OUT	-2507	A request for connection establishment timed out.
DCCLTER_SYSERR	-2518	System error
DCCLTER_RESOURCE	-2538	Insufficient resource
DCCLTER_WRONG_HOST	-2539	The host name is invalid, or has not been specified in both hostname and DCSNDHOST.
DCCLTER_CONNREFUSED	-2541	A connection establishment request to the remote system was rejected.
DCCLTER_INVALID_CLTID	-2544	The client ID specified for cltid differs from the one received by the dc_clt_cltin_s function.
DCCLTER_PORT_IN_USE	-2547	Port numbers that can be assigned automatically by the operating system are insufficient.

If the remote system releases the connection when the function sends a message to the remote system, depending on the length of the message, the function might not be able to detect that the connection has been released. However, a subsequent function might detect it. Keep this in mind when you create a CUP.