Script-Statement: Registriert eine Datei als externe Jobausgabe.
Syntax
:REGISTER_OUTPUTFILE File, User 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 Erlaubte Werte: „Y“ oder „N“ Format: Script-Literal |
Dieses Script-Statement kann nur im Tab Script von UNIX- und Windows-Jobs verwendet werden!
Externe Dateien können auch als Jobausgabe registriert werden, indem Sie die Option Seiten „Output“ verwenden. Unterschiedlich ist jedoch der 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-Sprachmittels wird die angegebene Datei erst zum Zeitpunkt des Aufrufes registriert.
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.
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: