Zum Hauptinhalt springen

Script-Utility - area_info

CONZEPT 16-Server - Script-Utility area_info

area_info - Ermittelt den Pfad zu einem Aliasnamen

Syntax:

c16_serv_cmd_win.exe area_info <area alias> [-ignore_active]

Ermittelt den vollständigen Pfad (ohne Dateierweiterung) und gibt ihn auf die Konsole aus.

Argumente:

  • <area alias>: Symbolischer Name der Datenbank.
  • [-ignore_activate]: Soll der Pfad der Datenbank ermittelt werden, die zur Zeit als Slave-Datenbank (siehe Hot-Standby-Option ) geöffnet ist, muss dieser Schalter mit angegeben werden.

Der Datenbank-Pfad kann anschließend in einer Batch-Verarbeitung dazu verwendet werden, um die Datenbank zu packen o.ä. Bevor dies jedoch geschehen kann, muss der Backup-Modus (siehe backup_on ) eingeschaltet werden.

Rückgabe:

  • 0 - Die Datenbank ist als Slave geöffnet und der Schalter -ignore_active ist nicht angegeben.
  • 1 - Der Pfad wurde auf die Konsole ausgegeben.
  • 2 - Fehler aufgetreten. Die Fehlerbeschreibung wurde auf die Konsole ausgegeben.
info

Da dieses Kommando speziell für den Einsatz in einer Batch-Verarbeitung vorgesehen ist, kann durch die Angabe der Option -quiet=inf erreicht werden, dass nur der Datenbank-Pfad und sonst nichts auf die Konsole geschrieben wird.

Beispiele:

Die Datenbank mit dem Alias "codelibrary" ist auf dem Primärsystem unter "c:\database\examples\codelibrary-1.ca1" und auf dem Sekundärsystem unter "c:\db\codelibrary-2.ca1" gespeichert. Die Datenbank auf dem Primärserver ist im Master-Betrieb, die auf dem Sekundärserver im Slave-Betrieb.

c16_serv_cmd_win.exe area_info codelibrary -quiet=inf

Auf dem Primär-System wird auf der Konsole c:\database\examples\codelibrary-1 ausgegeben. Wird die Anweisung auf dem Sekundärsystem ausgeführt, wird nichts ausgegeben.

c16_serv_cmd_win.exe area_info codelibrary -quiet=inf -ignore_active

Auf dem Primärsystem wird c:\database\examples\codelibrary-1 ausgegeben. Wird die Anweisung auf dem Sekundärsystem ausgeführt, wird c:\db\codelibrary-2 ausgegeben.

Nach einem Rollenwechsel von Primär- und Sekundär-System (Primär-System=Slave-Datenbank, Sekundär-System=Master-Datenbank) führen die gleichen Befehle zu anderen Ausgaben:

c16_serv_cmd_win.exe area_info codelibrary -quiet=inf

Auf dem Primär-System erfolgt keine Ausgabe. Wird die Anweisung auf dem Sekundärsystem ausgeführt, wird c:\db\codelibrary-2 ausgegeben.

c16_serv_cmd_win.exe area_info codelibrary -quiet=inf -ignore_active

Auf dem Primärsystem wird c:\database\examples\codelibrary-1 ausgegeben. Wird die Anweisung auf dem Sekundärsystem ausgeführt, wird c:\db\codelibrary-2 ausgegeben.