Zum Hauptinhalt springen

Script-Utility

CONZEPT 16-Server - Script-Utility Beschreibung der Funktionen des CONZEPT 16-Script-Utilitys

Das Script-Utility ist ein Kommandozeilenprogramm, welches den Status von Datenbanken abfragen und auch setzen kann. Daneben kann es auch zur Anzeige der binären Log-Dateien verwendet werden. Das Script-Utility ist dabei für folgende Betriebssysteme verfügbar:

  • c16_serv_cmd_win.exe: Windows 32- und 64-Bit
  • c16_serv_cmd_l32: Linux 32-Bit
  • c16_serv_cmd_l64: Linux 64-Bit

Dem Programm müssen zur Durchführung der Kommandos bestimmte Argumente an der Kommandozeile übergeben werden. Die Kommandos sind für alle Betriebssysteme identisch. Die Argumente hängen vom jeweiligen Kommando ab.

  c16_serv_cmd_* <Kommando> [<Argumente>]
info

Bei der Angabe von Argumenten wird zwischen Groß- und Kleinschreibung unterschieden.

Der Rückgabewert gibt Aufschluss darüber, ob und mit welchem Ergebnis das Kommando durchgeführt wurde. Wird das Script-Utility in einer Script-Datei verwendet, kann dieser Rückgabewert über den Errorlevel des Betriebssystems ermittelt und ausgewertet werden. Zusätzlich zum Rückgabewert wird auf der Kommandozeile auch ein Fehlerwert und eine entsprechende Information ausgegeben. Die ausgegebenen Fehlertexte entsprechen den Log-Einträgen .

Durch die Angabe des Parameters -quiet oder -quiet=inf kann die Textausgabe von Informationen in der Kommandozeile unterdrückt werden. Durch die Angabe von -quiet=err werden zusätzlich Fehlerausgaben unterdrückt. Ebenso können Ausgabe forciert werden. Durch die Angabe des Parameters -noquiet=err werden Fehlermeldungen ausgegeben. Bei der Angabe von -noquiet=inf oder -noquiet werden ebenfalls Informationen ausgegeben.

Falls Kommandos ausgeführt werden, die den Datenbankserver betreffen, muss das Server-Kennwort angegeben werden. Wurde kein Server-Kennwort definiert, kann die Angabe entfallen oder das Argument bleibt leer. Mit '-passwd=<Password>' wird das Kennwort übertragen.

Folgende Kommandos können an das Script-Utility übergeben werden:

  • help Hilfe zum Script-Utility oder einem bestimmten Kommando anzeigen
  • version Versionsinformationen des Script-Utility anzeigen
  • status Status-Informationen des Servers anzeigen
  • license Lizenzinformationen zum Server anzeigen
  • receive Log-Dateien beim Datenbank-Server abholen
  • decode Anzeige des Inhalts von binären Log-Dateien
  • backup_on Datenbank in den Backup-Modus schalten
  • backup_off Backup-Modus einer Datenbank ausschalten
  • backup_info Abfrage des Backup-Modus
  • close Schließen der Datenbank vor Ablauf der Schließverzögerung
  • down Abmelden der Benutzer und schließen der Datenbank
  • lock_on Benutzerlogin-Sperre einschalten
  • lock_off Benutzerlogin-Sperre ausschalten
  • lock_info Datenbank-Sperre ermitteln
  • open_info Ermitteln, ob Datenbank offen ist oder nicht
  • clearhsblicense Hot-Standby-Lizenzeintrag aus der Datenbank entfernen
  • area_info Ermittelt den Pfad zu einem Aliasnamen
  • area_copy Kopiert eine Datenbank in ein angegebenes Verzeichnis
  • diag Datenbankdiagnose starten
  • yeet_enable Aktiviert die Synchronisation mit yeet
  • perflog Performance-Daten einer Datenbank aufzeichnen
  • dump Speicherabbild der Systemdaten des Datenbankprozesses erzeugen

Beispiel zur Verwendung des Script-Utility​

Mit dem folgenden Skript kann eine CONZEPT 16-Datenbank im laufenden Betrieb kopiert werden. Die Datenbank wird dazu in den Backup-Modus versetzt und dann kopiert. Nach dem Kopiervorgang wird der Backup-Modus wieder zurückgesetzt.

@echo off
if "%1" == "" goto Usage
if "%2" == "" goto Usage

c16_serv_cmd_win.exe area_copy %1 %2 -time=1:00 -wait=60 -options=yt
if %errorlevel%==2 goto ErrCopy
goto End

:ErrCopy
echo Error copying the database.
goto End

:Usage
echo copydb area dest
echo.
echo  area   - areaname of the database
echo  dest   - name of the destination directory
echo.

:End