Job Messenger-Traces aktivieren

Folgende Anleitung erklärt, wie die Trace-Ausgabe der Job Messenger von UNIX und VMS aktiviert wird. Dies kann pro Job, pro Mandant oder für das ganze System erfolgen.

Der Agent schreibt Agent Job Messenger-Traces in den Jobreport (REP), in dem diese Ausgaben am Anfang (start messenger) und am Ende (end messenger) des Reports bereitgestellt werden. Sie enthalten Informationen über den Verbindungsstatus des Messengers. Kommt es zu einem Fehler im Zusammenhang mit dem Messenger-Programm, wird die Trace-Ausgabe automatisch aktiviert.

Die Ausgabe wird folgendermaßen aktiviert:

Verwendung des Parameters TRC= beim Aufruf des Job Messenger-Programms im Trailer- und/oder Header-Include (siehe: Includes (JOBI)). Dieser ist in den Job-Includes für Unix standardmäßig enthalten. Die vordefinierte Script-Variable &UC_MD_JOB_TRC wird diesem Parameter zugewiesen. Somit kann über diese Variable die Trace-Ausgabe aktiviert (1) bzw. deaktiviert (0) werden.

Die Aktivierung des Trace ist in folgendem Umfang möglich:

  • Für alle Jobs eines Automic-System
    Einstellung in den Header/Trailer-Includes im System-Mandanten 0.
    Wichtig! Diese Einstellung ist nicht empfohlen, da sich die Reports aller UNIX- bzw. VMS-Jobs stark vergrößern und auch die Laufzeit verlängert wird.
  • Für alle Jobs eines Mandanten
    Die Header/Trailer-Includes im Mandanten-Ordner <Kein Ordner> erstellen und anpassen.
  • Pro Job (empfohlen)
    Über die Script-Variable auf der Seite Pre-Prozess.

Die Aktivierung der Job Messenger-Trace-Ausgaben ist im Header-Include von Unix-Jobs bereits standardmäßig vorgesehen. Öffnen Sie das Include-Objekt HEADER.UNIX im Systemmandanten. Es enthält die Definition für die Variable &UC_JOB_MD_TRC. Der Wert dieser Variablen wird an den Parameter TRC= weitergegeben, wenn der Job Messenger aufgerufen wird (JCL-Zeile).

Dadurch ist es möglich die Trace-Ausgabe für einen bestimmten Unix-Job zu aktivieren, indem folgende Script-Zeile in die Pre-Prozess-Seite eingefügt wird:

:SET &UC_JOB_MD_TRC = '1'

Siehe auch: