(a) TP1/Client/W

_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_receive2_s(DCCLT_ID cltid, char *buff,
                         DCLONG *recvleng, DCLONG timeout,
                         DCLONG flags)
 

Non-_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_receive2(char *buff, DCLONG *recvleng,
                       DCLONG timeout, DCLONG flags)
 

(b) TP1/Client/P

_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_receive2_s(DCCLT_ID cltid, char CLTFAR *buff,
                         DCLONG CLTFAR *recvleng,
                         DCLONG timeout,
                         DCLONG flags)
 

Non-_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_receive2(char CLTFAR *buff,
                       DCLONG CLTFAR *recvleng,
                       DCLONG timeout, DCLONG flags)
 

Receives messages from the MHP.

Before issuing the dc_clt_receive2_s function, you need to issue the dc_rpc_open_s function with flags set to DCCLT_ONEWAY_RCV or DCCLT_SNDRCV.

• cltid
  Set the client ID received by the dc_clt_cltin_s function.
  
• buff
  Set the area that contains messages to receive. The area must be greater than the length specified in recvleng.
  
• recvleng
  Set the length of a message to receive.
  
• timeout
  Set the maximum wait time in seconds for receiving messages. The timeout value must be an integer between -1 and 65535.
  Specifying -1 lets the program wait indefinitely until it receives a message. Specifying 0 disables the program from waiting for messages. When no messages are available for reception, the function returns an error with DCCLTER_TIMED_OUT.
  Specifying 1 to 65535 allows the program to wait for messages for the specified seconds. When no messages are received within the time, the function returns an error with DCCLTER_TIMED_OUT.
  
• flags
  Specify whether to release the connection after message reception.
  

  DCNOFLAGS

  Does not release the connection after message reception.

  DCCLT_RCV_CLOSE

  Releases the connection after message reception.

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

• buff
  Return the received message.
  
• recvleng
  Return the length of the received message.
  

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. Alternatively the dc_rpc_open function has been issued with DCCLT_ONEWAY_RCV or DCCLT_SNDRCV not specified in flags.
DCCLTER_NO_BUFS	-2504	Insufficient memory
DCCLTER_NET_DOWN	-2506	Network error
DCCLTER_TIMED_OUT	-2507	Timeout occurred during reception of the message.
DCCLTER_SYSERR	-2518	System error
DCCLTER_RESOURCE	-2538	Insufficient resource
DCCLTER_CONNFREE	-2542	The remote system released the connection.
DCCLTER_INVALID_CLTID	-2544	The client ID specified for cltid differs from the one received by the dc_clt_cltin_s function.

• The dc_clt_receive2_s function returns control to the CUP when:
  
  • The program has received a message for the full length specified in recvleng from the MHP.
    (Control is not returned to the CUP if the received message is shorter than the specified length.)
    
  • A timeout error occurs during message reception from the MHP.
  • The MHP releases the connection.
  • A network error occurs.
• When the dc_clt_receive2_s function is issued, a disconnection from the MHP allows the function to return an error with DCCLTER_CONNFREE.