...
| Code Block | ||||
|---|---|---|---|---|
| ||||
EdmiError edmiDefineServerContext(SdaiString serverContextName,
SdaiString userName,
SdaiString groupName,
SdaiString password,
SdaiString communicationType,
SdaiString edmServerPortNumber,
SdaiString edmServerHostName,
SdaiString edmiTunnelName,
SdaiString edmiTunnelPortNumber,
SdaiString edmiTunnelHostName,
SdaiString proxyServerPortNumber,
SdaiString proxyServerName,
SdaiUnsignedInt *serverContextId);
|
Creates a detailed specification of the EDMInterface communication parameters for communication between an EDMclient and an EDMserver.
...
A defined server context is identified by its unique numeric server context id. A server context id is a mandatory input parameter to all edmiRemote API function calls. Any number of server contexts may be defined in an EDMclient session at the same time, thereby allowing simultaneous access to any number of remote EDMdatabase located anywhere in the world by TCP or HTTP communication.
...
Arguments
...
| Type | Name | Comment |
| SdaiString | serverContextName | Optional name of the server context. Server context names must start with a character followed by any combination of alphanumeric characters and underscore. |
| SdaiString | userName | The name of the edmUser to connect to the EDMserver. The edmUser name is case insensitive and mandatory. |
| SdaiString | groupName | The name of the edmGroup to connect to the EDMserver. The edmGroup name is case insensitive and optional. |
| SdaiString | password | The password of the edmUser specified by <userName>. The password parameter is mandatory. |
| SdaiString | communicationType | The nature of the communication with an EDMserver. Valid communication types are;
|
| SdaiString | edmServerPortNumber | The service port number used for remote communication with an EDMserver. Valid for <communicationType> "TCP" and "HTTP". |
| SdaiString | edmServerHostName | The name or IP-address of the machine hosting the EDMserver to communicate with. Valid for <communicationType> "TCP" and "HTTP". |
| SdaiString | edmiTunnelName | The name and full path of the HTTP Tunnel Servlet. Valid only for <communicationType> "HTTP". |
| SdaiString | edmiTunnelPortNumber | The tunnel service port number used by the machine hosting the HTTP Tunnel Servlet. Used by the HTTP tunnel for controling remote communication between an EDMserver and a thin EDMClient. Valid only for <communicationType> "HTTP". |
| SdaiString | edmiTunnelHostName | The name or IP-address of the machine hosting the HTTP Tunnel Servlet. Valid only for <communicationType> "HTTP". |
| SdaiString | proxyServerPortNumber | The service port number used for communication by the proxy server. Valid for <communicationType> "TCP" and "HTTP". |
| SdaiString | proxyServerName | The name or IP-address of the machine hosting the proxy service. Valid for <communicationType> "TCP" and "HTTP" |
| SdaiUnsignedInt | *serverContextId | Variable that will receive the unique numeric identificator of the defined server context. |
...
Return Value
...
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Options
...
Example
...
| Code Block | ||
|---|---|---|
| ||
EdmiError rstat; SdaiUnsignedInt serverContextId; . . . if (rstat = edmiDefineServerContext("MyContext", |
...
"Johnny", "supervisor", "w34rS7", |
...
"HTTP", "9090", "EDMServerHost", |
...
"/http/MyHttpTunnel", "7408 "192.136.64.13", |
...
"1120", "OurProxyServer", &serverContextId)) { |
...
printf("\nError %d in edmiDefineServerContext", rstat); |
...
goto err; |
...
}
. . . |
See also
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|