Copyrights

MiniM Overview
Client GUI Utilities
MiniM Debugger
Macro Preprocessor
MiniM Server Connect
MiniM Web Access
External ZDLL Call
MiniM Embedded Edition
Devices
Transactional Database
Language Extensions
Telnet
Console
Licensing
StealthTrace

MiniM Server Connect is a client dll module to connect to MiniM Database server. Dll does not requires registration in the registry or complex installation. minimsc.dll need to be placed in PATH or in current directory with client application.

Dll exports functions using standard windows calling conventions and can be used in all development tools which can interact with windows dll.

MiniM Server Connect has several examples for C++, for Delphi, for Java, for C#, for VB.NET, and for ActivePerl. Examples show how to connect, disconnect, read data, execute commands, get data from server using special modes.

Java connection use special JNI dll, full source code included.

MiniM Server Connect give very simple to use API. For example, read data in C# can be such as:

// read version info
MiniMSC.MINIMSTR sexpr = new MiniMSC.MINIMSTR();
MiniMSC.MINIMSTR svalue = new MiniMSC.MINIMSTR();
MiniMSC.StringToMINIMSTR( "$zversion", ref sexpr);
if ( Connect.Read(ref sexpr, ref svalue) == 0)
{
  Console.WriteLine("MiniM error: {0}", Connect.GetLastError());
  return;
}

// read version info
String Value = Connect.Read( "$zversion");

Programmer can write own component with reqiured interface and error handling conventions.

Examples in distribution only show one of possible way to use.

Data Transfer Modes

MiniM Server Connect implements several modes to transfer data from MiniM Database.

Simple Read.

Client application call server to read one string or expression value. Server return data.

Device text output intercept.

Client application call server to execute commands. While server executes ones all data wrote to current device accepts on client as notification event.

Group binary read.

Client application call server to execute commands. Server can call special function to send back to client data without wait. This can be done many times and client got group of strings as series of events. By one event on each string. This mode can fastly transfer to client many data strings.

Callback binary read.

Client call server. Server can send to client data back and wait answer. On client side fired event and application can return to server data or call server again recursively. This mode can be used to create interactive applications. For example, server can ask user about some options, or about file overwrite.

All data MiniM Server Connect encoded as byte sequence, true unicode is not supported. To use MiniM Server Connect in unicode applications programmer should define translation from unicode to 8-bit byte encoding for server side and back translations. See Java examples with CodePage property for example. Programmer can use any byte coding in coordination with national collation server settings. Also programmer can define his own collation tables using MiniM Collation Editor.

For more information see this site topics, use search, or query additional info.