dc_xat_connect - Establish an association

Format

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;

Description

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.

Arguments whose values are set in the UAP

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 values

Return valueReturn value (numeric)Meaning
DC_OK0Normal termination.
DCXATER_INVAL-4570An incorrect value is specified as the argument.
DCXATER_MEMORY-4571The memory became insufficient.
DCXATER_PROTO-4572The function dc_rpc_open() is not called.
DCXATER_NOT_FOUND-4575The XATMI communication service address information cannot be obtained.
DCXATER_TERMINATING-4576The XATMI communication service is terminating.
DCXATER_COMM_SEND-4577The service request failed while it was being sent to the XATMI communication service.
DCXATER_COMM_RECV-4578The 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-4580The specified association name is not defined.
DCXATER_ASO_CONNECT_ALREADY-4581The association has already been established.
DCXATER_ASO_CONNECTING-4582The association is being established.
DCXATER_ASO_DISCONNECTING-4583The association is being released.
DCXATER_ASO_INITIATE-4584The association cannot be established due to the recipient mode.