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 |
|