Script-Utility

Script-Utility
Steuerung der Datenbanken von der Kommandozeile

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 (9x, NT, 2000, XP, 2003)
c16_serv_cmd_lnx	Linux Kernel 2.4 / 2.6

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_xxx <Kommando> [<Argumente>]

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

Der Rückgabewert gibt Aufschluss darüber, ob und wie das Kommando durchgeführt wurde. Wird das Script-Utility in einer Script-Datei verwendet, kann dieser Rückgabewert über den Errorlevel ermittelt und ausgewertet werden.

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

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 eines Servers anzeigen.
• license Lizenzinformationen eines Server anzeigen.
• 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.
• lock_on Benutzerlogin-Sperre einschalten.
• lock_off Benutzerlogin-Sperre ausschalten.
• lock_info Datenbank-Sperre ermitteln.
• open_info Ermitteln, ob Datenbank offen ist oder nicht.

help

Syntax:	c16_serv_cmd_win.exe help [<Kommando>]
Funktion:	Ohne Angabe des <Kommando> wird eine Übersicht aller vorhandenen Kommandos angezeigt. Mit Angabe des <Kommando> wird die Befehlszeile und eine Beschreibung des angegebenen Kommandos angezeigt.

version

Syntax:	c16_serv_cmd_win.exe version
Funktion:	Anzeige der Version des Script-Utility.

status

Syntax:	c16_serv_cmd_win.exe status [-server=<Adresse>]
Funktion:	Die Informationen des Servers werden angezeigt. Wird kein Server (IP-Adresse oder Name) angegeben, beziehen sich die Informationen auf den lokalen Server. Release SVC Versionsnummer des Service-Prozesses. Release MGR Versionsnummer des Manager-Prozesses. Status run (Server läuft), down (Server läuft nicht). Init Error Fehlercode, falls beim Starten des Servers ein Fehler auftrat. Mode service (Server läuft als Dienst), detached (Server läuft detached). Areas closed (keine Datenbanken offen), open (Mindestens eine Datenbank ist offen).
Rückgabe:	0 - Server läuft nicht. 1 - Server läuft. 2 - Fehler aufgetreten.

license

Syntax:	c16_serv_cmd_win.exe license [-server=<Adresse>]
Funktion:	Es werden Informationen zur Lizenz des Servers angezeigt. Ist kein Server angegeben (IP-Adresse oder Name), beziehen sich die Informationen auf den lokalen Server. Release MGR Versionsnummer des Manager-Prozesses. License Lizenz-Klartext (z.B. "CE100000MU/H") User Limit Benutzerlimit Edition Edition (z.B. "Enterprise") Options Lizenz-Optionen (z.B. "HSB")
Rückgabe:	1 - Kommando erfolgreich ausgeführt. 2 - Fehler aufgetreten.

decode

Syntax:	c16_serv_cmd_win.exe decode <blog1> [<blog2>] [-start=<date>] [-end=<date>] [-days=<int>] [-records=<int>] [-filterex=<string>]
Funktion:	Anzeige von bis zu zwei binären Log-Dateien, beginnend vom jüngsten Eintrag in chronologischer, absteigender Reihenfolge, mit zeitlicher Eingrenzung und Filterung der Einträge. Falls im Verzeichnis der Log-Datei neben der <Datenbankname>.lgb auch das Archivlog <Datenbankname>.lga liegt, wird das gesamte Log aus Standard-Log und Archiv-Log betrachtet.
Argumente:	<blog1> Vollständiger Dateiname der ersten binären Logdatei. Die Anzeige erfolgt chronologisch absteigend. [<blog2>] Vollständiger Dateiname einer weiteren binären Logdatei. <blog1> und <blog2> werden in eine chronologische Reihenfolge gebracht. [-start=<date>] Anfangswert für die Datumseingrenzung in der Form yyyymmdd. Es werden nur Log-Einträge angezeigt, die nicht älter sind, wie das angegebene Datum. [-end=<date>] Endwert für die Datumseingrenzung in der Form yyyymmdd. Es werden nur Log-Einträge angezeigt, die nicht neuer sind, wie das angegebene Datum. [-days=<int>] Ist dieses Argument angegeben, hat es Vorrang vor "start" und "end". Es werden keine Einträge angezeigt, die älter als <int> Tage sind, ausgehend vom neuesten Eintrag in der Log-Datei. [-records=<int>] Ist dieses Argument angegeben, hat es Vorrang vor "days", "start" und "end". Es werden die letzten <int> Einträge, ausgehend vom neuesten Eintrag im binären Log angezeigt. Der höchstmögliche Wert für diese Option beträgt 500.000. <nobr>[-filterex=<string>]</nobr> Standardmässig werden keine Datensätze ausgefiltert. Durch Angabe dieses Argumentes können Einträge bestimmten Typs und Klasse verborgen werden. Für <string> können folgende Zeichen kombiniert werden: "uhgiwed". Dabei werden dann folgende Einträge nicht angezeigt: u Einträge des Typs User h Einträge des Typs Hot-Standby g Einträge, die weder vom Typ User noch vom Typ Hot-Standby sind i Einträge der Klasse Information w Einträge der Klasse Warnung e Einträge der Klasse Fehler d Einträge der Klasse Debug
Rückgabe:	1 - Kommando erfolgreich ausgeführt. 2 - Fehler aufgetreten.
Beispiele:	Alle Einträge der Manager-Logdatei in einer ASCII-Datei speichern. c16_serv_cmd_win.exe decode c16_serv_mgr.lgb > manager.txt Alle Einträge anzeigen, die zwischen dem 1. März 2006 und dem 3. März 2006 geschrieben wurden. c16_serv_cmd_win.exe decode c16_serv_mgr.lgb -start=20060301 -end=20060303 Wie zuvor, jedoch werden alle Einträge, die nur informativer Natur sind ausgeklammert. c16_serv_cmd_win.exe decode c16_serv_mgr.lgb -start=20060301 -end=20060303 -filterex=i

backup_on

Syntax:	c16_serv_cmd_win.exe backup_on <area alias> -time=<hh:mm> [-wait=<int>] [-server=<Adresse>] [-passwd=<string>]
Funktion:	Setzt eine Datenbank in den Backup-Modus. Damit das Kommando erfolgreich durchgeführt werden kann, muss die Datenbank <area alias> geöffnet sein.
Argumente:	<area alias> Symbolischer Name der Datenbank, die in den Backup-Modus versetzt werden soll. -time=<hh:mm> Dauer des Backup-Modus in Stunden und Minuten. Der Maximalwert beträgt 12 Stunden. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. [-wait=<int>] Zeitspanne in Sekunden, die maximal gewartet wird, bis das Kommando zurückkehrt. Ist die Datenbank bereits vor Verstreichen der angegebenen Zeitspanne im Backup-Modus, wird der Wartezustand abgebrochen. Reicht die Wartezeit nicht aus, wird der Fehlercode 2 zurückgegeben und der Backup-Modus nicht gestartet. Wird keine Wartezeit angegeben, wird maximal 300 Sekunden (5 Minuten) gewartet. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden.
Rückgabe:	1 - Kommando erfolgreich ausgeführt. 2 - Fehler aufgetreten.

backup_off

Syntax:	c16_serv_cmd_win.exe backup_off <area alias> [-wait=<int>] [-server=<Adresse>] [-passwd=<string>]
Funktion:	Setzt den Backup-Modus der Datenbank zurück.
Argumente:	<area alias> Symbolischer Name der Datenbank, für die der Backup-Modus zurückgesetzt werden soll. [-wait=<int>] Zeitspanne in Sekunden, die maximal gewartet wird, bis das Kommando zurückkehrt. Ist die Datenbank bereits vor Verstreichen der angegebenen Zeitspanne nicht mehr im Backup-Modus, wird der Wartezustand abgebrochen. Reicht die Wartezeit nicht aus, wird der Fehlercode 2 zurückgegeben und der Backup-Modus ist noch nicht beendet. Wird keine Wartezeit angegeben, wird maximal 300 Sekunden (5 Minuten) gewartet. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden.
Rückgabe:	1 - Kommando erfolgreich ausgeführt. 2 - Fehler aufgetreten.

backup_info

Syntax:	c16_serv_cmd_win.exe backup_info <area alias> [-server=<Adresse>] [-passwd=<string>]
Funktion:	Ermittelt den Backup-Modus für die Datenbank.
Argumente:	<area alias> Symbolischer Name der Datenbank, für die die Information ermittelt werden soll. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden.
Rückgabe:	0 - Datenbank ist nicht im Backup-Modus. 1 - Datenbank ist im Backup-Modus. 2 - Fehler aufgetreten.

lock_on

Syntax:	c16_serv_cmd_win.exe lock_on <area alias> [-wait=<int>] [-server=<Adresse>] [-passwd=<string>]
Funktion:	Setzen der Login-Sperre für eine Datenbank, um das neue Einloggen von Benutzern zu verhindern. Die Login-Sperre bleibt bestehen, bis sie mit der Anweisung lock_off aufgehoben oder der CONZEPT 16-Server neu gestartet wird.
Argumente:	<area alias> Symbolischer Name der Datenbank, die gesperrt werden soll. [-wait=<int>] Zeitspanne in Sekunden, die maximal gewartet wird, bis das Kommando zurückkehrt. Ist die Datenbank bereits vor Verstreichen der angegebenen Zeitspanne gesperrt, wird der Wartezustand abgebrochen. Reicht die Wartezeit nicht aus, wird der Fehlercode 2 zurückgegeben und die Datenbanksperre ist noch nicht eingerichtet. Wird keine Wartezeit angegeben, wird maximal 300 Sekunden (5 Minuten) gewartet. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden.
Rückgabe:	1 - Kommando erfolgreich ausgeführt. 2 - Fehler aufgetreten.

lock_off

Syntax:	c16_serv_cmd_win.exe lock_off <area alias> [-wait=<int>] [-server=<Adresse>] [-passwd=<string>]
Funktion:	Setzt die Login-Sperre für eine Datenbank zurück.
Argumente:	<area alias> Symbolischer Name der Datenbank, die entsperrt werden soll. [-wait=<int>] Zeitspanne in Sekunden, die maximal gewartet wird, bis das Kommando zurückkehrt. Ist die Datenbank bereits vor Verstreichen der angegebenen Zeitspanne entsperrt, wird der Wartezustand abgebrochen. Reicht die Wartezeit nicht aus, wird der Fehlercode 2 zurückgegeben und die Datenbanksperre ist noch nicht entfernt. Wird keine Wartezeit angegeben, wird maximal 300 Sekunden (5 Minuten) gewartet. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden.
Rückgabe:	1 - Kommando erfolgreich ausgeführt. 2 - Fehler aufgetreten.

lock_info

Syntax:	c16_serv_cmd_win.exe lock_info <area alias> [-server=<Adresse>] [-passwd=<string>]
Funktion:	Ermittelt, ob eine Datenbank zur Zeit gesperrt ist.
Argumente:	<area alias> Symbolischer Name der Datenbank. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden.
Rückgabe:	0 - Datenbank ist nicht gesperrt. 1 - Datenbank ist gesperrt. 2 - Fehler aufgetreten.

open_info

Syntax:	c16_serv_cmd_win.exe open_info <area alias> [-server=<Adresse>] [-passwd=<string>] [-mode=slave]
Funktion:	Ermittelt, ob eine Datenbank zur Zeit geöffnet ist.
Argumente:	<area alias> Symbolischer Name der Datenbank. <nobr>[-server=<Adresse>]</nobr> IP-Adresse oder Name des Servers auf dem der CONZEPT 16 Server installiert ist. Wird die Angabe weggelassen, wird der lokale Server angesprochen. <nobr>[-passwd=<string>]</nobr> Passwort für den Server. Das Kennwort kann verschlüsselt oder unverschlüsselt angegeben werden. <nobr>[-mode=slave]</nobr> Ist diese Option angegeben, wird geprüft, ob die Datenbank als Hot-Standby-Slave geöffnet ist.
Rückgabe:	0 - Datenbank ist geschlossen bzw. nicht als Slave-Datenbank geöffnet. 1 - Datenbank ist offen bzw. als Slave-Datenbank geöffnet. 2 - Fehler aufgetreten.

Beispiel zur Verwendung des Script-Utilities

Mit dem folgenden Skript kann ArcFlow im laufenden Betrieb in den Backup-Modus gesetzt oder der Backup-Modus zurückgesetzt werden.

Die Werte in den spitzen Klammern (<...>) müssen durch die entsprechenden Daten der Datenbanken ausgetauscht werden.

@echo off
REM 
REM Datenbankinformationen setzen
REM 
REM Datenbanknamen ohne Leerzeichen fuer Befehle
SET serv=<Serveradresse>
SET area_cmd=<Alias der Applikationsdatenbank>
SET prev_cmd=<Alias der Vorschaudatenbank>
SET bin1_cmd=<Alias der BLOb-Datenbank>

REM 
REM weitere Datenbanken hinzufuegen
REM SET bin2_cmd=<Alias der BLOb-Datenbank>

REM Datenbanknamen mit Leerzeichen fuer Ausgabe
SET area_out=<Alias der Applikationsdatenbank> 
SET prev_out=<Alias der Vorschaudatenbank>     
SET bin1_out=<Alias der BLOb-Datenbank>        

REM 
REM weitere Datenbanken hinzufuegen
REM SET bin3_out=<Alias der BLOb-Datenbank>

REM Backupzeit setzen
if "%1" == "" goto SetTime
SET time=%1
goto CheckBackup

:SetTime
SET time=<Standardzeit>

REM 
REM Backup-Modus zuruecksetzen, falls gesetzt
REM 
:CheckBackup
c16_serv_cmd_win.exe backup_info %area_cmd% -server=%serv% -quiet
if %errorlevel%==0 goto SetBackup
c16_serv_cmd_win.exe backup_off %area_cmd% -server=%serv% -wait=60 -quiet
if %errorlevel%==2 goto ErrBackupOff
echo Datenbank %area_out%: Der Backup-Modus ist aus

:BackupOffPrev
c16_serv_cmd_win.exe backup_info %prev_cmd% -server=%serv% -quiet
if %errorlevel%==0 goto BackupOffBin1
c16_serv_cmd_win.exe backup_off %prev_cmd% -server=%serv% -wait=60 -quiet
if %errorlevel%==2 goto ErrBackupOff
echo Datenbank %prev_out%: Der Backup-Modus ist aus

:BackupOffBin1
c16_serv_cmd_win.exe backup_info %bin1_cmd% -server=%serv% -quiet
if %errorlevel%==0 goto BackupOffBin2
c16_serv_cmd_win.exe backup_off %bin1_cmd% -server=%serv% -wait=60 -quiet
if %errorlevel%==2 goto ErrBackupOff
echo Datenbank %bin1_out%: Der Backup-Modus ist aus

:BackupOffBin2
REM 
REM weitere Datenbanken hinzufuegen
REM c16_serv_cmd_win.exe backup_info %bin2_cmd% -server=%serv% -quiet
REM if %errorlevel%==0 goto BackupOffBin3
REM c16_serv_cmd_win.exe backup_off %bin2_cmd% -server=%serv% -wait=60 -quiet
REM if %errorlevel%==2 goto ErrBackupOff
REM echo Datenbank %bin2_out%: Der Backup-Modus ist aus
REM 
REM :BackupOffBin3
goto End</p>

<p>REM 
REM Backup-Modus setzen
REM 
:SetBackup
c16_serv_cmd_win.exe open_info %area_cmd% -server=%serv% -quiet
if %errorlevel%==0 goto BackupOnPrev
c16_serv_cmd_win.exe backup_on %area_cmd% -server=%serv% -wait=60 -time=%time% -quiet
if %errorlevel%==2 goto ErrBackupOn
echo Datenbank %area_out%: Der Backup-Modus ist an

:BackupOnPrev
c16_serv_cmd_win.exe open_info %prev_cmd% -server=%serv% -quiet
if %errorlevel%==0 goto BackupOnBin1
c16_serv_cmd_win.exe backup_on %prev_cmd% -server=%serv% -wait=60 -time=%time% -quiet
if %errorlevel%==2 goto ErrBackupOn
echo Datenbank %prev_out%: Der Backup-Modus ist an

:BackupOnBin1
c16_serv_cmd_win.exe open_info %bin1_cmd% -server=%serv% -quiet
if %errorlevel%==0 goto BackupOnBin2
c16_serv_cmd_win.exe backup_on %bin1_cmd% -server=%serv% -wait=60 -time=%time% -quiet
if %errorlevel%==2 goto ErrBackupOn
echo Datenbank %bin1_out%: Der Backup-Modus ist an

:BackupOnBin2
REM 
REM weitere Datenbanken hinzufuegen
REM c16_serv_cmd_win.exe open_info %bin2_cmd% -server=%serv% -quiet
REM if %errorlevel%==0 goto BackupOnBin3
REM c16_serv_cmd_win.exe backup_on %bin2_cmd% -server=%serv% -wait=60 -time=%time% -quiet
REM if %errorlevel%==2 goto ErrBackupOn
REM echo Datenbank %bin2_out%: Der Backup-Modus ist an
REM 
REM :BackupOnBin3
goto End


REM 
REM Fehler aufgetreten
REM 
:ErrBackupOff
echo Der Backup-Modus der Datenbank %area_cmd%, %previews_cmd% oder %bin1_cmd% konnte nicht zurueckgesetzt werden.
REM 
REM weitere Datenbanken hinzufuegen
REM echo Der Backup-Modus der Datenbank %area_cmd%, %previews_cmd%, %bin1_cmd% oder %bin2_cmd% konnte nicht zurueckgesetzt werden.
goto End

:ErrBackupOn
echo Der Backup-Modus der Datenbank %area_cmd%, %prev_cmd% oder %bin1_cmd% konnte nicht gesetzt werden.
REM 
REM weitere Datenbanken hinzufuegen
echo Der Backup-Modus der Datenbank %area_cmd%, %prev_cmd%, %bin1_cmd% oder %bin2_cmd% konnte nicht gesetzt werden.
goto End

:End