Verarbeitung von SQL-Anweisungen im Pipe, Socket oder Batchbetrieb.
yardsrv { -p | -b <dateiname> } [ -V ]
Das Programm yardsrv ist der SQL-Serverprozeß, der entweder von einem Clientprogramm im lokalen Betrieb (Pipebetrieb) oder vom Netzwerkdämon yardnetd im Netzwerkbetrieb (Socketbetrieb) gestartet wird. Das Programm kann auch auf Shellebene zur Bearbeitung von SQL-Anweisungen direkt aufgerufen werden (Batchbetrieb).Die folgenden Optionen stehen zur Verfügung:
- -p
- Der SQL-Server liest seine Eingaben aus einer Pipe und schreibt seine Ausgaben in eine Pipe. Dieses ist der Normalbetrieb, wenn der Server von einem Clientprozeß gestartet wird. Der Clientprozeß muß mit der Bibliothek libsql.a gelinkt worden sein, die die entsprechenden Routinen zum Aufruf des SQL-Servers enthält. Bei Netzwerkbetrieb erfolgt die Kommunikation über sockets.
Diese Option kann nicht von der Shellebene aus verwendet werden.
- -b
- Der SQL-Server liest seine Eingaben aus der Datei dateiname und schreibt seine Ausgaben auf die Standardausgabe. Wird statt einem Dateinamen ein "-" angegeben, liest yardsrv von der Standardeingabe. Auf diese Art können im Batchbetrieb beliebige SQL-Statements ausgeführt werden. Fehlermeldungen werden auf die Standard Fehlerausgabe geschrieben. Die Datei dateiname darf nur SQL-Kommandos und Kommentare in C-Notation enthalten (/*...*/).
Der Serverprozeß reagiert auf das Signal SIGTERM mit einem Abbruch. Lediglich die aktuelle Transaktion wird zurückgesetzt. Im Batchbetrieb führt auch das Signal SIGINT zum Abbruch. Niemals sollte das Signal SIGKILL zum Abbruch eines Prozesses verwendet werden, auch wenn das Signal SIGTERM zunächst wirkungslos erscheint. Die Beendigung der aktuellen Transaktion kann einige Zeit in Anspruch nehmen, so daß das Prozeßende nicht sofort erfolgt.
Der Abbruch einer Datenbankverbindung kann auch durch Beenden (nicht über SIGKILL) des Clientprozesses erfolgen, da sich der Serverprozeß selbst beendet, sobald er feststellt, daß der Clientprozeß nicht mehr läuft. Auch in diesem Fall wird die aktuelle Transaktion zurückgesetzt.
Zu den SQL-Anweisungen, die von yardsrv verarbeitet werden können, siehe auch Kapitel 4, SQL-Referenz.
Die Shellvariable YARDHOME muß gesetzt sein.Die Shellvariable YARDDBS muß gesetzt sein.
Das DBS muß im Online Mode sein.