Objekte bearbeiten

Objekte bearbeiten

CREATE_OBJECT

---

:REGISTER_OUTPUTFILE

Script-Anweisung: Registriert eine Datei als externen Job-Output

Syntax

:REGISTER_OUTPUTFILE File, User Login

Automic empfiehlt ausdrücklich, die Include-Objekte REGISTER.OUTPUTFILE.WINDOWS und *.UNIX aus dem Ordner REGISTER des Systemmandanten in diesen Ordner jedes anderen Mandanten im AE-System zu kopieren, bevor Sie diese Ihren Bedürfnissen entsprechend anpassen.
Erklärung: Nach der Lieferung von neuen Initialdaten durch Automic werden diese Include-Objekte im Systemmandaten mit den Default-Daten überschrieben.

Kommentare 

Diese Script-Anweisung kann nur in der Registerkarte Script von UNIX und Windows-Jobs verwendet werden!

Das Registrieren von externen als Job-Output ist auch über die Registerkarte Output möglich. Unterschiedlich ist jedoch der Zeitpunkt der Registrierung: Die Dateien der Registerkarte Output werden gleich zu Beginn der Job-Durchführung registriert, unabhängig davon ob der Job die Datei anlegen konnte oder nicht. Bei Verwendung des 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. Sinnvoll ist es nur Dateien anzugeben, die durch den Job erzeugt werden.

Nach der Jobdurchführung wird die Datei zusätzlich zum Standard-Job-Output im Report-Dialog in der Registerkarte "Verzeichnis"aufgelistet. Dort kann die Datei direkt über das UserInterface geöffnet oder gespeichert werden.

Beispiel

In folgendem Beispiel-Script eines Windows-Jobs wird die Dateiliste des Verzeichnisses C:\temp in die Datei C:\temp\test.txt geschrieben. Anschließend wird überprüft ob das Kommando erfolgreich ausgeführt werden konnte. Ist dies der Fall so wird diese Datei als Job-Output 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"

In diesem Beispiel wird eine externe Output-Datei registriert, wenn Sie Perl in einem externen Interpreter-Script in der Script-Registerkarte eines Jobobjekts verwenden:

:  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

Siehe auch:

Script-Sprachmittel - Script-Aufbau und -Prozessierung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung