tibemsXAConnection_Create
Function
Purpose
Create a new XA connection to an EMS server; use XA for transactions.
C Declarations
tibems_status tibemsXAConnection_Create( tibemsConnection* connection, const char* brokerURL, const char* clientId, const char* username, const char* password ); tibems_status tibemsXAConnection_CreateSSL( tibemsConnection* connection, const char* brokerURL, const char* clientId, const char* username, const char* password, tibemsSSLParams sslParams, const char* pk_password );
COBOL Call
CALL "tibemsXAConnection_Create" USING BY REFERENCE connection, BY REFERENCE brokerURL, BY REFERENCE clientId, BY REFERENCE username, BY REFERENCE password, RETURNING tibems-status END-CALL.
Note:
On IBM z/OS systems, the
pk-password
must always be a null value.
Parameters
Parameter | Description |
---|---|
connection
|
Store the new connection in this location. |
brokerURL
|
URL location of the EMS server. If configuring a fault-tolerant client, enter two or more URLs, as described in Configuring C and COBOL Clients for Fault-Tolerant Connections. |
clientId
|
Identify the client program to the server with this unique ID. |
username
|
Identify the client program to the server with this user name. |
password
|
Authenticate the client program to the server with this password. |
sslParams
|
Establish TLS communication using these parameters. |
pk_password
|
Private key password for TLS. |
Status Code | Description |
---|---|
TIBEMS_OK
|
The call succeeded. |
TIBEMS_SERVER_NOT_CONNECTED
|
|
TIBEMS_SECURITY_EXCEPTION
|
|
TIBEMS_INVALID_CLIENT_ID
|
The client ID is not unique; that is, another client already uses the ID. |