edmiDefineServerContext

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; "HTTP": Stateless transaction oriented communication with a remote EDMserver by the Hyper Text Transfer Protocol. "TCP": Stateless transaction oriented communication with a remote EDMserver by the Transfer Communication Protocol. "LOCAL_DB": Stateful transaction oriented communication with a locally connected EDMserver. The communication type will be as specified for the locally connected EDMserver. The local connection communication type must be defined by edmiDefineCommunication or edmiDefineCommunicationEx "LOCAL_CONTEXT": Stateful non-transaction oriented communication with a locally connected EDMserver. The communication type will be as specified for the locally connected EDMserver. The local connection communication type must be defined by edmiDefineCommunication or edmiDefineCommunicationEx
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

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_EDMInterface'.

Options

Example

 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; 
 }
 . . .

EDMsix

edmiDefineServerContext

Arguments

Return Value

Options

Example

See also

Filter by label