Description

Creates a reference to an OpenEngine, running either locally or remotely.

Syntax

Error = CreateEngine (Engine, ServerSpec, DatabaseName, Flags, ShutdownSessions)

Parameters

The CreateEngine function has the following parameters.

ParameterDescription
EngineHandle for the engine. Pass null. CreateEngine will return an engine handle.
ServerSpec

Descriptor for local or remote server. Examples:

ServerSpecDescription
""Use default named pipe on local server
\\.\MYENGINEUse the named pipe MYENGINE on this machine.
\\192.168.0.1\MYENGINEUse the named pipe MYENGINE on the server at 192.168.0.1
\\192.168.0.1:666\MYENGINEUse the named pipe MYENGINE on the server at 192.168.0.1, port 666
DatabaseNameThe database .dbt file to use.
FlagsSee CreateEngine Constants.
ShutdownSessions
ValueDescription
0Leave the engine running after this session closes
1Causes the engine to shut down sessions when this connection is closed.

See also

CloseEngine(), CreateQueue()

Example

// Create an engine that will not shut down when the connections end
// Uses the named pipe REVCAPI_TEST
Error = CreateEngine(Engine, "\\.\REVCAPI_TEST", | "EXAMPLES",CREATE_ENGINE_OPEN_ALWAYS$,  1)
  • No labels