:REGISTER_OUTPUTFILE

Verwenden Sie die Script-Anweisung :REGISTER_OUTPUTFILE auf der Seite Prozess von UNIX- und Windows-Jobs, um eine Datei als externe Jobausgabe zu registrieren. Die angegebene Datei muss sich auf dem Rechner des Agenten befinden, auf dem der Job ausgeführt wird, oder von dort aus erreichbar sein. Es ist sinnvoll, nur Dateien zu definieren, die von diesem Job generiert werden. Nach der Ausführung des Jobs wird die Datei auf der Registerkarte Verzeichnis und im Report-Dialog der Standard-Jobausgabe aufgelistet. Dort können Sie die Datei direkt über die Automic Web Interface öffnen oder speichern. Weitere Informationen finden Sie unter Registrierte Job-Ausgabe.

Hinweis: Auf der Seite Ausgabe können Sie auch externe Dateien als Jobausgabe registrieren. Der Unterschied liegt im Zeitpunkt der Registrierung: Die Dateien der Seite Ausgabe werden gleich zu Beginn der Jobausführung registriert, unabhängig davon, ob der Job die Datei erstellen konnte oder nicht. Wenn Sie diese Script-Anweisung verwenden, wird die angegebene Datei nur registriert, wenn sie aufgerufen wird. Weitere Informationen finden Sie auf der Registrieren von externen Ausgabedateien.

Syntax

: REGISTER_OUTPUTFILE Datei, Benutzer-Login

Parameter

• :REGISTER_OUTPUTFILE
  Registriert eine Datei als externe Jobausgabe.
• Datei
  Vollqualifizierter Pfad und Name der Datei, die als Jobausgabe registriert werden soll. Platzhalterzeichen sind nicht erlaubt. Sie müssen immer den absoluten Pfad angeben.
  Format: Script-Literal
• Benutzer-Login
  Legt fest, ob die Login-Daten des Benutzers verwendet werden sollen.
  Zulässige Werte:
  • Y
  • N
  Format: Script-Literal

Beispiele

Das folgende Beispiel-Script eines Windows-Jobs schreibt die Dateiliste des Verzeichnisses C:\temp in die Datei C:\temp\test.txt. Anschließend wird überprüft ob das Kommando erfolgreich ausgeführt werden konnte. Wenn ja, wird diese Datei als Jobausgabe registriert. Andernfalls bricht der Job ab.

dir C:\temp /S >> C:\temp\test.txt
@set retcode=%errorlevel% !
@if NOT %ERRORLEVEL% == 0 goto :retcode
:REGISTER_OUTPUTFILE "C:\temp\test.txt", "N"

Wenn Sie einen externen Interpreter definieren, müssen Sie das Element register.outputfile in seinen eigenen Mandanten kopieren. Die Automation Engine verwendet dann Ihre Version und überschreibt sie nicht bei der Bereitstellung neuer Initialdaten. Siehe das Perl-Beispiel unten:

:if &$EXT_INTERPRETER# = 'PERL' or 'perl' or 'Perl'
system("&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=O ULOGIN=&uc_register_ulogin OUTFILE=\"&uc_register_ofile\"");
:else
...
:endif