dc_xat_connect - Establish an association

ANSI C, C++

#include <dcxat.h>
int dc_xat_connect (char *svcname, char *aso_name,
                    DCLONG flags)

K&R C

#include <dcxat.h>
int dc_xat_connect (svcname, aso_name, flags)
char     *svcname;
char     *aso_name:
DCLONG   flags;

The function dc_xat_connect() requests the XATMI communication service specified in svcname to establish the association specified in aso_name.

The function dc_xat_connect() sends a request to establish an association to the remote system. Then, control is returned. The function cannot receive a report of association establishment.

The function dc_xat_connect() can be used only for OSI TP communication using TP1/NET/OSI-TP-Extended.

The function dc_xat_connect() can be called from within or outside transaction processing.

svcname

Specify the name of the XATMI communication service to be requested to establish an association. As an XATMI communication service name, specify the XATMI communication service definition file name to be specified in the xat_invoke_server operand of the XATMI communication service definition.

aso_name

Specify the name of the association to be established. As an association name, specify the connection name specified in the -c option of the nettalccn operand of the protocol specific definition (TP1/NET/OSI-TP-Extended definition).

flags

Specify DCNOFLAGS.

Return value	Return value (numeric)	Meaning
DC_OK	0	Normal termination.
DCXATER_INVAL	-4570	An incorrect value is specified as the argument.
DCXATER_MEMORY	-4571	The memory became insufficient.
DCXATER_PROTO	-4572	The function dc_rpc_open() is not called.
DCXATER_NOT_FOUND	-4575	The XATMI communication service address information cannot be obtained.
DCXATER_TERMINATING	-4576	The XATMI communication service is terminating.
DCXATER_COMM_SEND	-4577	The service request failed while it was being sent to the XATMI communication service.
DCXATER_COMM_RECV	-4578	The service request failed while it was being received from the XATMI communication service. The XATMI communication service may be making a request to establish a connection.
DCXATER_ASO_NAME	-4580	The specified association name is not defined.
DCXATER_ASO_CONNECT_ALREADY	-4581	The association has already been established.
DCXATER_ASO_CONNECTING	-4582	The association is being established.
DCXATER_ASO_DISCONNECTING	-4583	The association is being released.
DCXATER_ASO_INITIATE	-4584	The association cannot be established due to the recipient mode.