Administratorhandbuch > Dienstprogramme > AE DB Archive > Offene Schnittstelle zu Output-Managementsystemen

Offene Schnittstelle zu Output-Managementsystemen

Die AE bietet die Möglichkeit Informationen zu Aufgabendurchführungen in eine Datei zu exportieren. Ihnen stehen dadurch beispielsweise Objektname, Status und Rückgabewert zur Verfügung. Auch der Report der Durchführung ist als Textdatei verfügbar. Durch die Strukturierung dieser Daten wird die Überleitung für ein Output-Managementsystem einfach und bequem möglich.

Sie können auf die Durchführungs-Informationen und Reports von Jobs sowie FileTransfers zugreifen.

Die Reportdaten können entweder mit dem Dienstprogramm AE DB Archive oder direkt durch einen Zugriff auf die Datenbank-Tabelle "XRO" aufbereitet werden. Letztere Möglichkeit unterstützt Ihre selbst geschriebenen Programme.

Diese spezielle Form der Reportaufbereitung ist standardmäßig nicht in Betrieb und muss daher pro Mandant aktiviert werden. Verwenden Sie dazu in der Variablen UC_CLIENT_SETTINGS den Key XRO_REPORTS.

Für jede Durchführung eines Jobs oder FileTransfers wird ein Eintrag in geschrieben, der unter anderem den Objektnamen, den Durchführungszeitpunkt und einen Verweis auf den Report enthält. Mit dem Dienstprogramm AE DB Archive können Sie die Daten aufbereiten.

Vergessen Sie nicht die XRO-Einträge regelmäßig aus der Tabelle zu entfernen, um ein übermäßiges Wachsen der Datenbank zu verhindern. Der Punkt "Tabelleneinträge entfernen" beschreibt wie dies zu bewerkstelligen ist.

Reports auflisten

Starten Sie AE DB Archive im Batchmodus mit der folgenden Syntax, um eine CSV-Datei zu erhalten, die alle noch nicht archivierten Aufgabendurchführungen auflistet:

UCYBDBAR -B -Xlist -SMandant/-DMandant [-OPfad und Dateiname] [-YStatus]

Geben Sie keinen Pfad an, so wird eine Datei namens "uc_XROlist.csv" im Ordner des Dienstprogrammes angelegt.

Der Inhalt der Datei entspricht exakt dem Inhalt der Datenbank-Tabelle "XRO", deren Aufbau am Ende dieses Dokumentes beschrieben ist.

Das Dienstprogramm bricht den Vorgang ab, wenn bereits eine gleichnamige Datei existiert.

Soll die Ergebnisdatei nicht alle Tabelleneinträge enthalten, ist es möglich den Startparameter -Y anzuwenden. Dabei werden nur jene Zeilen selektiert, die den angegebenen Status (Spalte "XRO_CusStatus") besitzen. Diesen Wert, der eine Zahl ist, können Sie selbst vorgeben und beim Entladen des Reports setzen.

AE DB Archive legt eine leere Datei an, wenn keine Reportdaten vorhanden sind.

Reports entladen

Rufen Sie AE DB Archive im Batchmodus mit der folgenden Syntax auf, um einen Report in eine Textdatei zu exportieren:

UCYBDBAR -B -Xunload -SMandant/-DMandant -RRunID der Aufgabe[-TYReporttyp] [-OPfad und Dateiname] [-YStatus]

Geben Sie den RunID der Aufgabe und den Reporttyp an, um einen bestimmten Report zu entladen. Wenn Sie nur die RunID übergeben, erhalten Sie alle Reports dieser Durchführung.

Geben Sie keinen Pfad an, so wird eine Datei namens "uc_XROreport.txt" im Ordner des Dienstprogrammes angelegt. Die Textdatei enthält den Inhalt des Reports.

Das Dienstprogramm bricht den Vorgang ab, wenn bereits eine gleichnamige Datei existiert.

Mit dem Startparameter -Y können Sie für den Report einen Status setzen. Geben Sie zu diesem Zweck eine Zahl Ihrer Wahl an, der in der Spalte XRO_CusStatus eingetragen wird. Die Reportliste kann über diesen Wert gefiltert werden.

Durch das Entladen eines Reports werden dessen Einträge in der Tabelle "XRO" nicht gelöscht. Dies geschieht im nächsten Arbeitsschritt.

Tabelleneinträge entfernen

Es gibt zwei Methoden, um die Tabelleneinträge zu reorganisieren:

  1. Starten Sie AE-DB-Archive mit folgender Syntax, um die Reports als archiviert zu kennzeichnen und damit deren Einträge aus der Datenbank-Tabelle "XRO" zu entfernen:

    UCYBDBAR -B Xmark -S
    Mandant/-DMandant -RRunID der Aufgabe [-TYReporttyp]
  2. Verwenden Sie das Dienstprogramm AE DB Reorg. Wenn Sie die Reports reorganisieren, wird die Tabelle XRO automatisch miteinbezogen.

Aufbau der Datenbank-Tabelle XRO

Die exportierte CSV-Datei enthält den Inhalt und die Struktur der Datenbank-Tabelle "XRO". Beide besitzen daher folgende Spalten:

Spaltenname

Beschreibung

XRO_Client

Mandant

XRO_AH_Idnr

Laufende Nummer (RunID) der Aufgabendurchführung

XRO_RType

Reporttyp

XRO_System

Name des Automation Engine Systems

XRO_OType

Objekttyp (JOBS, JOBF)

XRO_Object

Name des Objektes

XRO_HostDst

Name des Agenten am Zielhost

XRO_LoginDst

Benutzername unter dem das Objekt durchgeführt wird

XRO_HostScr

Name des Agenten am Quellhost (nur bei FileTransfers)

XRO_LoginSrc

Benutzername für den Quellhost (nur bei FileTransfers)

XRO_TimeStamp1

Startzeit der Durchführung

XRO_TimeStamp4

Endezeit der Durchführung

XRO_RetCode

Rückgabewert der Aufgabe

XRO_Status

Status der Aufgabe

XRO_RRetCode

Rückgabewert der Reportübertragung

"0" - Report wurde erfolgreich übertragen.
"4" - Report ist unvollständig.
"8" - Die Übertragung des Reports schlug fehl.

XRO_ReportSize

Größe des Reports in Bytes

Beachten Sie, dass bei FileTransfers in dieser Spalte immer "0" vermerkt ist.

XRO_UserTime

Verbrauchte Benutzerzeit

XRO_KernelTime

Verbrauchte Kernelzeit

XRO_CpuTime

Verbrauchte CPU-Zeit

XRO_Archive1

Erster Archivbegriff des Objektes

XRO_Archive2

Zweiter Archivbegriff des Objektes

XRO_CusStatus

Benutzerdefinierte Zahl für die Verwendung von Filter

 

Siehe auch:

Allgemeines zu Reports
Startparameter

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH