Defines the name of the system that hosts the EDMserver of interest and the communication port name that will be used to communicate with this particular EDMserver.
The combination of <hostName> and <portName> uniquely identifies an EDMserver in a network. This communication set-up must be defined on the client host before the client can successfully access a multi-user EDMserver.
This function has no effect in a single-user EDMserver.
Related function: edmiGetCommunication .
Header:
#include "sdai.h"
Prototype:
EdmiError edmiDefineCommunication(SdaiString portName,
SdaiString hostName);
Arguments:
portName |
Specifies the name of the EDMserver service port. This name must be present in the "etc/services" file before a multi-user EDMserver can run successfully. The name of the EDMserver service port can be defined by the environment variable EDM_SERVICE_NAME. |
hostName |
Specifies the name of the system that runs the multi-user EDMserver of interest. The name of the host running EDMserver process can be defined by the environment variable EDM_HOST, |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0 : Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
EXAMPLE
EdmiError rstat;
SdaiAppInstance appInstance;
...
if (rstat = edmiDefineCommunication("edmd", "hepa")) {
/* Error in operation */
printf("\nError in edmiDefineCommunication: %s\n",
edmiGetErrorText(rstat));
goto error;
}
. . .