parms
Eine auf NULL endende Zeichenfolge, die eine durch Semikolons getrennte Liste mit Parametereinstellungen enthält, und
zwar in der Form KEYWORD=Wert. Zum Beispiel
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:
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:
Starten eines Datenbankservers mit dem Namen server_1:
start dbeng12 -n server_1 demo.db
Der Start eines neuen Servers wird erzwungen und es wird eine Verbindung zu ihm hergestellt:
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).