(a) TP1/Client/W

_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_set_connect_inf_s(DCCLT_ID cltid,
                                char *inf,
                                unsigned short inf_len,
                                DCLONG flags)
 

Non-_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_set_connect_inf(char *inf,
                              unsigned short inf_len,
                              DCLONG flags)
 

(b) TP1/Client/P

_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_set_connect_inf_s(DCCLT_ID cltid,
                                char CLTFAR *inf,
                                unsigned short inf_len,
                                DCLONG flags)
 

Non-_s version of the function

 
#include <dcvclt.h>
DCLONG dc_clt_set_connect_inf(char CLTFAR *inf,
                              unsigned short inf_len,
                              DCLONG flags)
 

Sets terminal identification information dynamically.

When you use a permanent connection to communicate with a DCCM3 logical terminal, reporting the terminal identification information to the DCCM3 logical terminal allows you to use DCCM3's function for allocating a fixed terminal.

The terminal identification information specified in this function is valid only when the host name and the port number of the DCCM3 logical terminal are specified in the DCCLTRAPHOST client environment definition and DCNOFLAGS is specified in the flags argument of the dc_clt_connect_s function.

When this function is executed, the terminal identification information specified in the DCCLTCONNECTINF client environment definition is not referenced until the the dc_rpc_open_s function is reexecuted.

The terminal identification information specified in this function is referenced by the dc_clt_connect_s function which is executed after this function. These functions then report that information to the DCCM3 logical terminal.

If this function is executed more than once, the dc_clt_connect_s function references the terminal identification information specified immediately before the function.

• cltid
  Specify the client ID received by the dc_clt_cltin_s function.
  
• inf
  Specify the terminal identification information. If you want to use hexadecimal numbers to specify this information, use up to 64 bytes. If you want to use a character string to specify this information, use up to 64 characters (excluding any NULL characters).
  When you use a permanent connection to communicate with a DCCM3 logical terminal, use EBCDIK code to specify the logical terminal name of the DCCM3 logical terminal as the terminal identification information. However, DCCM3 only validates the first 8 bytes (the 9th and later bytes are ignored).
  
• inf_len
  Specify the terminal identification information length. You can specify a length between 1 and DCCLT_MAX_CONNECT_INF_SIZE. DCCLT_MAX_CONNECT_INF_SIZE is defined in the header file. The header file is dcvclt.h for TP1/Client/W. For TP1/Client/P, the header file is DCVCLT.H.
  
• flags
  Specify DCNOFLAGS.
  

Return Value	Value (decimal)	Meaning
DC_OK	0	Normal termination
DCCLTER_INVALID_ARGS	-2501	The value specified as the argument is incorrect.
DCCLTER_PROTO	-2502	The dc_rpc_open_s function is not executed.
DCCLTER_NO_BUFS	-2504	A necessary amount of buffer could not be allocated.
DCCLTER_INVALID_CLTID	-2544	The client ID specified in cltid differs from the client ID received by the dc_clt_cltin_s function.

• Reporting terminal identification information allows you to use DCCM3' function for allocating a fixed terminal only when DCCM3 is version 09-03 or later. For details about the function for allocating a fixed terminal, see the manual VOS3 Data Management System XDM E2 Description.
• If the logical terminal name of the DCCM3 logical terminal matching the terminal identification information defined in the dc_clt_set_connect_inf_s function is not defined in DCCM3, the dc_clt_connect_s function returns a DCCLTER_NET_DOWN error.