unsigned int db_start_engine(
SQLCA * sqlca,
char * parms 
);

Startet den Datenbankserver, falls er nicht läuft.

Eine Beschreibung der Schritte, die von dieser Funktion ausgeführt werden, wenn ForceStart nicht angegeben wurde, finden Sie unter Speicherort eines Datenbankservers ermitteln.

Wenn der Datenbankserver bereits lief oder erfolgreich gestartet wurde, ist der Rückgabewert TRUE (von Null verschieden) und SQLCODE wird auf 0 gesetzt. Fehlerinformationen werden in SQLCA zurückgegeben.

Der folgende Aufruf von db_start_engine startet den Datenbankserver und nennt ihn demo. Er lädt die Datenbank nicht, trotz des DBF-Verbindungsparameters:

db_start_engine( &sqlca, 
    "DBF=Beispielverzeichnis\\demo.db;START=dbeng12" );

Falls Sie den Server und eine Datenbank starten möchten, fügen Sie die Datenbankdatei in den StartLine-Verbindungsparameter (START) ein:

db_start_engine( &sqlca,
   "SERVER=eng_name;START=dbeng12 Beispielverzeichnis\\demo.db" );

Dieser Aufruf startet den Server, nennt ihn eng_name und startet die SQL Anywhere-Beispieldatenbank auf diesem Server.

Die Funktion db_start_engine versucht, eine Verbindung zu einem Server herzustellen, bevor einer gestartet wird, um zu verhindern, dass ein Server gestartet wird, der bereits läuft.

Der Verbindungsparameter ForceStart (FORCE) wird nur von der Funktion db_start_engine verwendet. Wenn er auf YES gesetzt wird, wird nicht versucht, eine Verbindung zu einem Server herzustellen, bevor einer gestartet wird. Dadurch kann das folgende Befehlspaar wie erwartet arbeiten:

Wenn ForceStart (FORCE) nicht verwendet wird und ohne den ServerName-Parameter (Server), hätte der zweite Befehl versucht, eine Verbindung zu server_1 herzustellen. Die Funktion db_start_engine übernimmt nicht den Servernamen von der Option -n des Parameters StartLine (START).