Description
|
|
Establishes an IPC connection to the specified partner process on the
specified node with the specified IPC mechanism and initializes the IPC
identifier.
 |
For connecting to the Java-Client the IPC connection type "tcpip" is available. For connecting to a server process of
Agile e6 the IPC connection type "tcpip" is also used.
|
|
Syntax
|
|
int eci_connect (edb_data_header *ipc_id, connection_types conn, char
*node, char *resource, char *partner_id, char *my_id)
|
 Input Parameter
|
|
conn
| Type of IPC Connection |
value |
| tcpip |
1 |
node
| When conn = |
Must
be entered for "node": |
| 1 |
Host name where Java-Client or the
Agile e6 process as a service is running |
Resource (identifier of IPC resource)
| When
conn = |
Must be entered for "resource"
:
|
| 1 |
Socket number or socket name |
| Alternate Syntax for Resource
|
|
| :h:<host>:t:<transportmode>:r:<resource> |
host: hostname
transportmode: {1|57}
resource: {socketnumber|topic} |
| |
Example:
eci_connect(IpcId, 1, "nothing", ":h:myhost:t:57:r:eci_dde_loop",
"agile", "CAD");
equivalent to
eci_connect(IpcId, 57, "nothing", "eci_dde_loop", "agile", "CAD")
|
partner_id
| Identifier of partner process, e.g. "
Agile e6" |
my_id
Identification of own process, e.g. "CAX".
The value of this parameter must be unique (e.g. id+Hostname+Process-ID).
The first 20 characters of the parameter must be different (if a second
eci_connect call is executed). |
|
 Output
Parameter
|
ipc_id
| Identifier of IPC connection |
|
 Return value
|
|
0
|
connection established
|
|
<> 0
|
error during connect
|
|
Example
|
|
Connect to Java Client, Java Client
is running on host "theHost", ECI port is 44444 and has been started with option "-p
ECI-TOPIC:myTopic".
edb_data_header *IpcId;
eci_connect(IpcId, 1, "theHost", "agile","CAX");
| Parameter |
Explanation |
| conn = 1 |
Type of IPC connection: tcpip |
| node = theHost |
Host name where JavaClient is running |
| resource = "myTopic" |
Topic has value "myTopic".
If no ECI-TOPIC is defined when starting Agile
e6 with the option "-p" , "eci_dde_loop" is used as a default
ECI-TOPIC. |
| partner_id = "agile" |
Identification for
Agile e6 process |
| my_id = "CAX" |
Identification of own process |
|
Open the IPC Connection (eci_connect)