OpenTP1 Version 7 Programming Reference C Language
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 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. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.