:REGISTER_OUTPUTFILE

Script-Anweisung: Registriert eine Datei als externe Jobausgabe.

Syntax

: REGISTER_OUTPUTFILE Datei, Benutzer-Login

Syntax	Beschreibung/Format
File	Voll qualifizierter Pfad und Name der Datei, die als Jobausgabe registriert werden soll. Platzhalterzeichen sind nicht erlaubt. Es ist immer der absolute Pfad anzugeben! Format: Script-Literal
User Login	Benutzer-Login verwenden Zulässige Werte: "Y" oder "N" Format: Script-Literal

Achtung! Diese Script-Anweisung kann nur auf der Seite Prozess von UNIX- und Windows-Jobs verwendet werden.

Hinweis: Auf der Seite Ausgabe können auch externe Dateien als Jobausgabe registriert werden. Der Unterschied liegt im Zeitpunkt der Registrierung: Die Dateien der Seite Ausgabe werden gleich zu Beginn der Job-Durchführung registriert, unabhängig davon, ob der Job die Datei anlegen konnte oder nicht. Bei Verwendung des Script-Elements wird die angegebene Datei erst zum Zeitpunkt des Aufrufes registriert. Weitere Informationen finden Sie auf der Seiten "Ausgabe".

Die angegebene Datei muss sich auf dem Rechner des Agenten, auf dem der Job ausgeführt wird, befinden oder von dort erreichbar sein. Es ist sinnvoll, nur Dateien anzugeben, die vom Job erzeugt werden.

Nach der Ausführung des Auftrags wird die Datei im Tab Verzeichnis und im Report-Dialog der Standard-Jobausgabe aufgelistet. Dort kann die Datei direkt über das Automic Web Interface geöffnet oder gespeichert werden. Weitere Informationen finden Sie unter Registrierte Job-Ausgabe.

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 Ihre Version und überschreibt sie nicht bei der Lieferung neuer Initialdaten. Ein Perl-Beispiel ist unten dargestellt:

: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

Siehe auch: