User's Manual

Chapter 17: Module - eDMSAPI
The module eDMSAPI consists of two separate programs. One program is eDMSAPI and is written in
Visual Basic. The other program is called CSTA_Service.exe and is written in C++.
In general, both programs reside in the default directory C:\SOPHO Messenger@Net\Exe, unless
otherwise implemented in your environment.
Overview
eDMSAPI.exe
The eDMSAPI is the Visual Basic component of the eDMSAPI module. The program
communicates with two processes: the eKERNEL and the CSTA Service. The eKERNEL is
the central engine that centralizes all database access and communication with input and
output capable modules.
The eDMSAPI communicates with both eKERNEL and CSTA_Service.exe by means of TCP
sockets. In both communications, eDMSAPI is a TCP client software that connects to the two
other components, acting as TCP server software.
For external clients (eWEB), the eDMSAPI acts as a multiple socket server.
At start up, eDMSAPI contacts the eKERNEL by means of a socket connection. For the
eDMSAPI module to locate the eKERNEL, the eDMSAPI must start up with parameters that
identify the eDMSAPI module and locate the eKERNEL program. These parameters are
provided to eDMSAPI in the Properties section of the shortcut that initiates eDMSAPI. This
shortcut is usually located in the Windows Startup group (click Start on the Windows task bar
and choose Programs > Startup).
Figure 82: Typical parameters in the shortcut
In the example shown in Figure 82: Typical parameters in the shortcut on page 135, eDMSAPI
identifies itself as belonging to Site 1, and specifies the location of eKERNEL through IP
address *LOCAL and port 3101. The special value *LOCAL refers to the assigned IP address
DECT Messenger Installation and Commissioning — Book 1 March 2012 135