AE DB Archive

Mit dem Dienstprogramm AE DB Archive ("ucybdbar" und "ucybdbarg") können Sie aktuelle Datensätze archivieren, indem Sie sie mit einem Lösch-Flag versehen. Sie können Prognosen erstellen, bevor Sie den Archivierungsprozess starten, Archivkennzeichen zurücksetzen oder Daten für die externe Reportanalyse in Textdateien exportieren. Archivierte Daten sind noch jahrelang verfügbar und können im Archive Browser angezeigt werden.

Wichtig!

  • Das Dienstprogramm AE.DB Archive exportiert und schreibt Dateien im Format UTF-8 statt im Format ASCII. Darüber hinaus werden Codierungsinformationen in die Exportdateien geschrieben, um die Codierung der Daten zu definieren, die in die Dateien geschrieben wurden. Mithilfe dieser Codierungsinformationen können Sie ermitteln, ob der Inhalt einer Datei in Legacy-Codierung oder UTF-8-Codierung vorliegt, sodass er richtig verarbeitet werden kann. Weitere Informationen finden Sie unter Offene Schnittstelle zu Ausgabemanagement-Systemen und Archive Browser.

  • Sie können die relevanten Daten im Batch-Modus mit dem Dienstprogramm ucybdbar archivieren, aber Sie müssen es mindestens einmal über die Benutzeroberfläche starten, um die erforderlichen Einstellungen vorzunehmen. Weitere Informationen finden Sie unter Startparameter – Dienstprogramme.

  • Datenbankfelder, die in Archivdateien geschrieben werden, sind durch Strichpunkte getrennt. Wenn jedoch in den Archivschlüsseln auch Strichpunkte vorkommen, ist die Trennung der Datenbankfelder nicht mehr eindeutig. Deshalb wandelt das Dienstprogramm AE DB Archive die Strichpunkte, die in Archivschlüsseln verwendet werden, in Kommas um.

  • Nachdem der Archivierungsprozess ausgeführt wurde, speichern Sie die Dateien nicht in der AE oder auf den Servern des Dienstprogramms. Speichern Sie sie auf einem zugeordneten Laufwerk, oder komprimieren Sie sie, und verschieben Sie sie. Andernfalls füllen diese Dateien das Dateisystem und verursachen möglicherweise ein Speicherplatzproblem.

Tipps!

  • Dieses Dienstprogramm liest die Werte in der Variablen UC_ARCHIVE_UTILITY und verwendet sie. Manuelle Eingriffe sind nicht erforderlich. Weitere Informationen finden Sie unter UC_UTILITY_ARCHIVE – Konfigurieren der Archivierungsparameter.

  • Wenn Sie Ihre Daten im nächsten Schritt mithilfe des AE-Dienstprogramms DB Reorg neu organisieren, können Sie angeben, dass dieses Dienstprogramm nur Datensätze berücksichtigt, die mit einem Archiv-Flag markiert sind. Verwenden Sie zu diesem Zweck den Parameter no_archive_check= in der INI-Datei des Dienstprogramms. Weitere Informationen finden Sie unter AE DB Reorg.

Diese Seite beinhaltet Folgendes:

Übersicht

Melden Sie sich am Dienstprogramm mit dem Mandanten an, der archiviert werden soll.

Die grafische Benutzeroberfläche des Dienstprogramms ucybdbarg zeigt die folgenden Statusinformationen an:

  • Tabellenspalten
    • Tabelle
      Datenbereich (z. B. Meldungen oder Ausführungdaten), der die Datenbanktabellen anzeigt. Mit einem Doppelklick auf die entsprechende Tabellenzeile können Sie die Einstellungen wie unten beschrieben ändern.
    • Letzte Archivierung
      Datum des letzten Archivierungsprozesses oder Fragezeichen, wenn die Daten noch nicht archiviert wurden.
    • Aktuelle Anzahl
      Anzahl der Datensätze, die archiviert werden können.
    • Archivierungskriterien
      Aktuelle Angabe der Archivierungskriterien einschließlich des Startdatums für den Archivierungsprozess, wie im Menü Einstellungen definiert.
    • Anzahl nach der Archivierung
      Anzahl der Datensätze, die aufgrund der angegebenen Kriterien nicht archiviert werden.

Es stehen drei Optionen zur Verfügung, die Sie entweder direkt per Doppelklick oder über das Menü Datei öffnen können:

  • Archiv-Flags zurücksetzen

    Setzt die Archiv-Flags des Mandanten zurück.

    • Um die Archivierungskennzeichen mehrerer Mandanten zurückzusetzen, siehe AE DB Unload.

  • Prognose

    Erstellt eine Prognose unter Verwendung des aktuellen Datenbestandes (siehe Prognose).

  • Archiv

    Startet den Archivierungsprozess.

    • Eine Statuszeile zeigt den Fortschritt der Archivierung an. Nach dem erfolgreichen Archivierungslauf werden die Datensätze mit einem Archivierungskennzeichen versehen.

Fenster "Einstellungen"

Sie können Ihre Archivierungsparameter entweder auf der Registerkarte Einstellungen definieren oder auf die jeweilige Tabellenzeile doppelklicken. Die hier definierten Einstellungen gelten nur für jenen Mandanten, mit dem Sie sich am Dienstprogramm angemeldet haben. Sie können festlegen, dass Datensätze, die älter sind als x Tage, archiviert werden sollen. Die angenommene Startzeit für den Archivierungsprozess ist 00:00.

Tipp: Da das AE-Dienstprogramm DB Archive aktuelle Daten archivieren soll, ist es hilfreich, alle Werte auf 0 oder maximal 1 Tag zu setzen.

Registerkarte "Meldungen"

Definieren Sie, was archiviert werden soll:

  • Meldungen archivieren
    Aktivieren Sie dieses Kontrollkästchen, um Mandanten-Meldungen zu archivieren.
  • Gelesen
    Alle gelesenen Nachrichten, die älter als die angegebene Anzahl von Tagen sind, werden archiviert. Das entsprechende Datumskriterium wird daneben angezeigt.
  • Ungelesen
    Alle ungelesenen Nachrichten, die älter als die angegebene Anzahl von Tagen sind, werden archiviert. Zusätzlich wird das Datum angezeigt, das der angegebenen Anzahl von Tagen entspricht.

Registerkarte "Statistiken"

Reports zu den Ausführungsdaten werden ebenfalls archiviert. Die folgenden Felder stehen zur Verfügung:

  • Statistiken archivieren
    Aktivieren Sie dieses Kontrollkästchen, um Ausführungsdaten von Mandanten zu archivieren.
  • Statistiken archivieren, die älter sind als
    Es werden alle Ausführungsdaten archiviert, die älter als die angegebene Anzahl von Tagen sind. Das entsprechende Datumskriterium wird daneben angezeigt.

    • Der angegebene Wert gilt für die Ausführungsdaten und die Reportdaten. Die Daten aller gelöschten Objekte werden ebenfalls archiviert, unabhängig vom definierten Zeitraum.

Registerkarte " Archivieren"

Die folgenden Felder stehen zur Verfügung:

  • Verzeichnis archivieren
    Verzeichnis, in dem die archivierten Daten gespeichert werden. Stellen Sie sicher, dass das angegebene Laufwerk zum Aktivierungszeitpunkt vorhanden ist und genügend Speicherplatz zur Verfügung steht. Weitere Informationen finden Sie unter Struktur des Archivordners.
  • Archivgröße
    Bestimmt die maximale Größe der archivierten Dateien.

    • Bei Bedarf werden die archivierten Daten in mehrere Dateien der angegebenen Archivgröße aufgeteilt.

    Die maximale Größe darf 2.048 MB nicht überschreiten. Andernfalls bricht das Dienstprogramm mit einer entsprechenden Fehlermeldung ab. Der Standardwert ist 650 Megabyte.

  • Datumsformat
    Hier geben Sie das gewünschte Datumsformat an, das für die Ausgabe in den archivierten Dateien verwendet wird.

    • Standardmäßig wird das Format "J.m.t H:M:S" verwendet (z. B. "2021-Mai-23 08:25:10").

    Sie können die folgenden Zeichen für Ihre Definitionen verwenden:

    • d
      Zeigt den Tag des Monats als zweistellige Zahl (01 - 31) an.
    • j
      Zeigt den Tag des Jahres als dreistellige Zahl an (001 - 366).
    • m
      Zeigt den Monat als zweistellige Zahl (01 - 12) an.
    • b
      Zeigt den Monat in abgekürzter Form an (Jan. - Dez.).
    • B
      Zeigt den Monat in voller Form an (Januar - Dezember).
    • y
      Zeigt das Jahr als zweistellige Zahl an (00 - 99).
    • Y
      Zeigt das Jahr als vierstellige Zahl an (0000 - 9999).
    • w
      Zeigt den Wochentag als Zahl an (0 - 6, Sonntag ist 0).
    • A
      Zeigt den Tag in voller Form an (Montag - Sonntag).
    • W
      Zeigt die Woche des Jahres als zweistellige Zahl (00 - 53) an, beginnend mit Montag als erstem Tag der Woche.
    • U
      Zeigt die Woche des Jahres als zweistellige Zahl (00 - 53) an, beginnend mit Sonntag als erstem Tag der Woche.
    • x
      Zeigt das Datum entsprechend dem Datumsformat an, das in der Systemsteuerung eingestellt ist.
    • I
      Zeigt die Stunde in einem 12-Stunden-Format (01 - 12) an.
    • M
      Zeigt die Minute mit einer vorangestellten Null an (00 - 59).
    • S
      Zeigt die Sekunden mit einer vorangestellten Null an (00 - 59).
    • p
      Zeigt die Uhrzeit mit der 12-Stunden-Zeitangabe AM und PM an.
    • X
      Zeigt die Zeit entsprechend dem Zeitformat an, das in der Systemsteuerung eingestellt ist.
    • z
      Zeigt die Zeitzone an. Wurde dies nicht angegeben, wird nichts angezeigt.
    • c
      Zeigt das Datum und die Uhrzeit entsprechend dem in der Systemsteuerung angegebenen Format an.

Eine Prognose erstellen

Sie können vor dem Start des eigentlichen Archivierungsprozesses eine Prognose erstellen, um Archivierungen zu simulieren. Die Prognoseergebnisse werden in die Registerkarteellen angezeigt.

Wenn Sie bereits Daten des jeweiligen Mandanten archiviert haben, werden die Schätzwerte (im Format hours:minutes:seconds) aus Informationen früherer Archivierungen berechnet und werden mit jedem Archivierungsprozess noch genauer.

Struktur des Archivordners

Sie können das Basis-Archivverzeichnis und die maximale Größe des Archivs können in den Einstellungen des Dienstprogramms definieren. Die archivierten Dateien können mithilfe des Archive Browser angezeigt werden. Weitere Informationen finden Sie unter Archive Browser.

  • Während der Archivierung wird ein Unterordner mit der vierstelligen Mandantennummer mit Unterordnern für jeden Archievierungslauf angelegt, die wiederum alle archivierten Daten und die zugehörigen Indexdateien enthalten. Der Name des Unterordners besteht aus dem Präfix "UC_ARCHIV_", dem aktuellen Datum im Format JJJJMMTT und einer laufenden Nummer (Beispiel: "0001\UC_ARCHIV_20210520_3").
  • Wenn die Daten die definierte maximale Größe überschreiten, wird der Archivierungsprozess in einem Ordner mit der nächsten fortlaufenden Nummer fortgesetzt. Indexdateien werden auf die gleiche Weise nummeriert.

Struktur der Indexdateien

Indexdateien werden beim Archivieren der Statistiksätze der Tabellen AH und RH erzeugt. Jede Indexzeile verweist auf einen Datensatz im Archiv. Im Folgenden werden die einzelnen Positionen der Datensätze beschrieben:

Index für AH: UC_AH. IDX

  • 1
    Blockcode H2
  • 2
    Mandant
  • 3
    Benutzer
  • 4
    Abteilung
  • 5
    A-Typ
  • 6
    S-Typ
  • 7
    RunID
  • 8
    Hostname
  • 9
    Startzeit/Startdatum
  • 10
    Parent-ACT
  • 11
    Parent-PRC
  • 12
    Archivschlüssel 1
  • 13
    Archivschlüssel 2
  • 14
    Objektname
  • 15
    Byteposition im Archiv
  • 16
    Zeilenposition im Archiv
  • 17
    Archivnummer
  • 18
    Datensatzlänge in Byte

Beispiel:

H2;1;LF;PROG;JPAK;GRP;1302137;;2021-05-23 10:31:42;0;0;;;LF.JP.GROUP;73837;2555;7;148

Index für RH: UC_RH.IDX

  • 1
    Blockcode H3
  • 2
    Mandant
  • 3
    Reporttyp
  • 4
    Objektname
  • 5
    RunID
  • 6
    Zeitpunkt, zu dem der Report erstellt wurde
  • 7
    Zeitpunkt der letzten Aktualisierung des Reports
  • 8
    Byteposition im Archiv
  • 9
    Zeilenposition im Archiv
  • 10
    Archivnummer
  • 11
    Datensatzlänge in Byte

Beispiel:

H3;98;JE01;MM.CHECK.FREE.SPACE;1000020;2020-05-24 12:56:03;2021-05-24 12:56:10;2820;39;12;151

Meldungsarchiv: UC_MELD.TXT

  • 1
    Blockcode M
  • 2
    Mandant
  • 3
    Benutzer
  • 4
    Abteilung
  • 5
    Zeitpunkt, zu dem die Meldung erzeugt wurde
  • 6
    Quelle
  • 7
    Kategorie
  • 8
    Typ
  • 9
    Host
  • 10
    Meldungstext

Beispiel:

M;1;LF;PROG;2021-03-18 09:43:54;Automation Engine;Report;Error;;U0011021 Host 'LFT40' ist nicht aktiv!

Kommentararchiv: UC_ACMT.TXT

  • 1
    Blockcode M
  • 2
    Mandant
  • 3
    Benutzer/Abteilung
  • 4
    Objektname
  • 5
    RunID
  • 6
    Zeitpunkt, zu dem die Meldung erzeugt wurde
  • 7
    Datensatzlänge in Byte
  • 8
    Meldungstext

Beispiel:

M;100;MH/PROG;TESTJOB;454711222;2021-03-15 09:43:54;nnn;Diese Aufgabe wurde nicht von (MH) verändert.

Siehe auch: