Job-Reports

Wenn Objekte ausgeführt werden, generiert das System verschiedene Arten von Reports, die verfolgen, was während der Ausführung passiert ist. Bei der Ausführung von Job-Objekten können zusätzliche Reports generiert werden. Als Entwickler und Objektdesigner definieren Sie, wann und wo sie auf der plattformspezifischen Seite der Jobdefinition gespeichert werden sollen. Einige Job-Objekte (z. B. SAP-Jobs, z/OS-Jobs und SQL-Jobs) haben zusätzliche Report-Optionen.

Allgemeine Konfigurationsoptionen für alle Job-Typen

Wenn Sie einen Job konfigurieren, legen Sie fest, wo der Job-Report gespeichert werden soll und wann er im Bereich Job-Report auf der plattformspezifischen Seite generiert werden soll.

Speicherort des Reports

Sie haben dafür zwei Möglichkeiten. Sie können eine Option oder beide gleichzeitig auswählen:

Speichere in: Datenbank bedeutet, dass nach der Ausführung des Jobs das auf dem Zielsystem (auf dem Agenten) verfügbare Prozesslog in der Datenbank gespeichert wird.

Wenn ein Auftrag auf einem Agenten ausgeführt wurde, wird der entsprechende Report auf dem Agentencomputer gespeichert. Nachdem diese Daten durch die Automation Engine in die Datenbank geschrieben wurden, wird der Report automatisch vom Agentencomputer gelöscht. Wenn dieser Job-Report aufgrund eines Fehlers nicht gelöscht werden kann, wird der Löschvorgang nicht wiederholt und eine Fehlermeldung ausgegeben.
Speichere in: Datei bedeutet, dass das Prozesslog als Datei in einem Zielsystem (Agent) gespeichert wird.

Wann soll der Report erstellt werden?

Sie haben dafür zwei Möglichkeiten:

Generiere: Immer bedeutet, dass das Prozesslog des Betriebssystems immer geschrieben wird.
Generieren: Nur im Fehlerfall bedeutet, dass das Prozesslog nur dann geschrieben wird, wenn ein Fehler auftritt. Zum Beispiel, wenn der Job abgebrochen wird.

BS2000-Optionen

Für BS2000-Jobs können Sie auch angeben, wann das SysLst-Protokoll generiert und wo es gespeichert werden soll. Details hierzu finden Sie unter BS2000

JMX-Jobs

Für JMX-Jobs ist die zusätzliche Option Agentenlog hinzufügen verfügbar. Aktivieren Sie diese Option, wenn die Agenten-Meldungen über die Ausführung des Jobs ebenfalls in den Report aufgenommen werden sollen.

z/OS-Jobs

Für z/OS-Jobs sind die folgenden zusätzlichen Optionen verfügbar:

Job-Log-Umfang

Zulässige Werte:
- Agent-Voreinstellung
  Der Umfang des Job-Logs hängt von der Konfiguration in der INI-Datei des Agenten ab (Parameter completeJobout=).
- JES-Statistik und Jobausgabe speichern
  Die JES-Statistik und die Jobausgabe werden im Job-Log gespeichert
- Nur JES-Statistik speichern
  JESMSGLG, JESJCL und JESYSMSG werden aufgenommen
Job-Log löschen
- Agent-Voreinstellung
  Ob das Job-Log gelöscht wird, hängt von der Konfiguration in der INI-Datei des Agenten ab (Parameter jobPurge=).
- Nach Lesen löschen
  Das Joblog wird, nachdem es vom Agenten gelesen worden ist, gelöscht
- Nicht löschen
  Das Job-Log bleibt im JES-Spool
Druckfreigabe
- Agent-Voreinstellung
  Ob das Job-Log gelöscht wird, hängt von der Konfiguration in der INI-Datei des Agenten ab (Parameter relMsgClass=).
- Nach Lesen freigeben
  Das Joblog wird, nachdem es vom Agenten gelesen worden ist, gelöscht
- Nicht freigeben
  Das Job-Log bleibt im JES-Spool
Meldungsklassen lesen

Meldungsklassen, die eingelesen und in weiterer Folge umgeleitet werden sollen. Geben Sie eine oder mehrere Meldungsklassen an. Beispiele: "A", "ABC", "X1".

Die Reihenfolge spielt hierbei keine Rolle. Außerdem sind noch folgende Werte erlaubt: *DEFAULT und *ALL.
- DEFAULT
  Die Meldungsklassen, die eingelesen werden sollen, hängen von der Konfiguration in der INI-Datei des Agenten ab (Parameter getMsgClass=).
  
  Wenn Sie diese Einstellung verwenden, muss auch *DEFAULT im Feld Zu Meldungsklassen umleiten spezifiziert werden.
- ALL
  Alle Klassen werden eingelesen.
Zu Meldungsklassen umleiten

Meldungsklassen, in die umgeleitet werden soll.

Nach der Übertragung in der Automation Engine kann das Job-Log zusätzlich in die angegebenen Meldungsklassen (beispielsweise für ein Output Management System) umgeleitet werden.

Geben Sie entweder eine Meldungsklasse an, oder so viele Meldungsklassen, wie Sie im Feld Meldungsklassen lesen angegeben haben. Die Reihenfolge spielt dabei eine wichtige Rolle.

Beispiel:

Folgende Meldungsklassen werden "ABC" eingelesen und nach "DEF" umgeleitet. Die Klasse "A" wird zur Klasse "D" umgeleitet, "B" zu "E" und "C" zu "F".

Ein weiteres Beispiel:

Folgende Meldungsklassen werden gelesen: "ABC" und umgeleitet: "D". Die Klassen "A", "B" und "C" werden zu "D" umgeleitet.

Anstelle von konkreten Meldungsklassen sind auch folgende Werte erlaubt:
- DEFAULT
  Die Meldungsklassen, die eingelesen werden sollen, hängen von der Konfiguration in der INI-Datei des Agenten ab (Parameter routeMsgClass=).
  
  Diese Einstellung muss eingetragen sein, wenn *DEFAULT ebenfalls im Feld Meldungsklassen lesen eingetragen wurde
- NO
  Es erfolgt keine Umleitung

OS400-Jobs

Für OS400-Jobs sind die folgenden zusätzlichen Optionen verfügbar:

Aus Spool speichern: Job-Log (QPJOBLOG)

Nur der Spoolinhalt aus QPJOBLOG wird in der Automation Engine-Datenbank gespeichert und/oder ist als Member im Zielsystem verfügbar.
Aus Spool speichern: Vollständig (*ALL)
Der gesamte Spool-Inhalt des Jobs wird in der Automation Engine-Datenbank gespeichert und/oder ist als Member im Zielsystems verfügbar.

See: Agenten - Interaktion zwischen AE und OS/400

SAP-Jobs

Für SAP-Jobs sind die folgenden zusätzlichen Optionen verfügbar:

Speichere in
Hinzufügen

Dies sind optionale Reports, die aus dem SAP-System bezogen werden. Sie stehen für den SAP-Job zur Verfügung, nicht aber für dessen Child-Jobs.
- Agentenlog
- Anwendungslogs (nur SAP ABAP-Jobs)
- Spoolverzeichnis (nur SAP ABAP-Jobs)
- Steplisten (nur SAP ABAP-Jobs)
- Statistik
Diese Reports können sehr lang und komplex sein. In einer Standardinstallation erhält Mandant 0 vordefinierte Style Sheet-Objekte, die den erforderlichen Code enthalten, um sie zu formatieren und ein benutzerfreundliches Layout zu erstellen.

Weitere Informationen finden Sie unter Style Sheet (XSL) und UC_REPORT_STYLESHEETS - Stylesheets für XML-Reports.

SQL-Jobs

Für SQL-Jobs sind die folgenden zusätzlichen Optionen verfügbar:

Agenten-Log hinzufügen Aktivieren Sie dieses Kontrollkästchen, wenn die Agenten-Meldungen über die Ausführung des Jobs ebenfalls in die Aufgabe aufgenommen werden sollen.

Windows-Jobs

Die Standardausgabe (STDOUT) von Windows-Jobs wird in den Job-Report geschrieben. Wenn Sie ein Programm verwenden, das nicht auf dieses Standard-Ausgabeziel schreiben kann, haben Sie zwei Optionen:

Seite Externe Ausgabedateien: Geben Sie einen beliebigen Pfad an, auf den das Programm den Report schreiben soll. Weitere Informationen finden Sie unter Seiten "Ausgabe"
Option Scriptbasierter Report auf der Windows-Seite des Jobs: Diese Option ist nützlich für Programme, deren Ausgaben in Dateien bereitgestellt werden. Wenn Sie sie aktivieren, enthalten die Job-Reports die Programmausgaben. Sie können die Standardausgabedatei dem von Ihnen verwendeten Programm zuweisen.

Bei jeder Jobausführung wird eine eigene Datei für den Job-Report angelegt. Um die entsprechenden Reportdateinamen abzurufen, können Sie das Attribut FILENAME_SYSOUT verwenden. Dateinamen enthalten die Ausführungsnummern des jeweiligen Jobs (RunID). Um den Pfad für den Job-Report festzulegen, verwenden Sie die Variable UC_EX_PATH_JOBREPOR, wie in der Liste Liste der Agentenvariablen beschrieben. Zum Lesen verwenden Sie die Script-Funktion GET_VAR. Sie können diese Informationen dann dem Programm zuweisen, das Sie verwenden möchten.

Beispiel:

:SET &job_report_path# = GET_VAR(UC_EX_PATH_JOBREPORT)
:SET &job_report_filename# = GET_ATT(FILENAME_SYSOUT)

isqlw -S PC1\SQL2000 -d TEST_DB -U sa -i c:\temp\test.sql -o &job_report_path#&job_report_filename#

Siehe auch: