Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datensequenzen > WRITE_PROCESS

WRITE_PROCESS

Script-Funktion: Schreibt den Inhalt einer Datensequenz in eine Datei.

Syntax

WRITE_PROCESS(Data-Sequence Reference, File, Agent, Login,[Mode],[CodeTable], [File Attributes], [Column])
WRITE_PROCESS(Data-Sequence Reference, File, Agent, Login,[Mode],[CodeTable], [File Attributes],[ALL], [Delimiter])

Syntax	Beschreibung/Format
Datensequenz-Referenz	Referenz auf jene Datensequenz, deren Inhalt in eine Datei exportiert werden soll. Format: Script-Variable
Datei	Pfad und Name der Datei. Format: Script-Variable oder Script-Literal
Agent	Name des Agenten, auf dessen Host die Datei gespeichert wird. Format: AE-Name, Script-Variable oder Script-Variable
Login	Name des Login-Objektes, welches für die Anmeldung am Host des angegebenen Agenten verwendet wird. Format: AE-Name, Script-Variable oder Script-Variable
Modus	Verhalten, wenn die angegebene Datei bereits existiert. Format: AE-Name, Script-Variable oder Script-Variable Erlaubte Werte: CANCEL (Standardwert)- Script-Durchführung abbrechen OVERWRITE - Datei überschreiben APPEND - bestehende Datei um die neuen Zeilen erweitern
CodeTabelle	Name eines CodeTabellen-Objektes, welches für die Kodierung der Datei verwendet werden soll. Format: AE-Name, Script-Variable oder Script-Variable Wird dieser Parameter nicht angegeben, so wird die Standard-CodeTabelle UC_CODE verwendet.
Datei-Attribute	Zusätzliche Dateiattribute für die erzeugte Datei Format: Script-Variable oder Script-Literal Abhängig von der Plattform des Agenten können Sie jene Attribute angeben, welche auch für FileTransfers spezifiziert werden können. Mehrere Attribute sind dabei durch Kommata zu trennen.
Spalte	Spalte(n) der Datensequenz, welche in die Datei geschrieben werden sollen. Format: Script-Literal, Script-Variable, Zahl ohne Hochkommata Erlaubte Werte: ALL (Standardwert) - Alle Spalten Nummer der entsprechenden Spalte (z.B. 2)
Trennzeichen	Trennzeichen bei der Angabe mehrerer Spalten Format: Script-Literal, Script-Variable, Zahl ohne Hochkommata Nur relevant, wenn alle Spalten der Datensequenz exportiert werden.

Rückgabewerte
0 - Datei erfolgreich exportiert. 20554 - Agent derzeit nicht aktiv.

Kommentare

Das Sprachmittel exportiert den Inhalt einer beliebigen Datensequenz in eine Text-Datei. Anzugeben ist dabei die Referenz auf die entsprechende Datensequenz, welche beim Anlegen der Datensequenz in einer Script-Variable abgelegt wird.

Jede Zeile der Datensequenz wird als Zeile in die Datei geschrieben.

Es können entweder alle oder nur eine bestimmte Spalte der Datensequenz in die Datei geschrieben. Dies ist mit dem Parameter Spalte festzulegen, wobei standardmäßig alle Spalten exportiert werden.

Der Parameter Delimiter ist nur relevant, wenn alle Spalten exportiert werden. Er legt das Zeichen fest, gemäß welchem die Datensequenz-Zeilen in Spalten aufgetrennt werden.

Beispiele

Folgendes Beispiel erstellt eine neue Datensequenz, welche eine Liste mit Dateinamen eines bestimmten Verzeichnisses speichert. Anschließend wird der Inhalt dieser Datensequenz in eine Datei auf einem anderen Host abgelegt. Kommt es dabei zu einem Fehler (Rückgabewert von WRITE_PROCESS > 0), so wird eine Fehlermeldung erstellt und an den betreffenden AE-Benutzer gesendet.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","c:\AUTOMIC\server\bin\*.exe",,,,"COL=DELIMITER","DELIMITER=*\*")
:SET &RET# = WRITE_PROCESS(&HND#,"C:\temp\export.txt",WIN02, LOGIN.GLOBAL,OVERWRITE)

:IF &RET# > 0
: SET &ERRNR# = SYS_LAST_ERR_NR()
: SET &ERRINS# = SYS_LAST_ERR_INS()
: SET &MESSAGE# = GET_MSG_TXT(&ERRNR#,&ERRINS#)
: SEND_MSG &$USER#, &$DEPARTMENT#, &MESSAGE#
:ENDIF

Siehe auch:

Script-Sprachmittel	Beschreibung
CREATE_PROCESS	Erstellt ein neue Datensequenz.
GET_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.
LOAD_PROCESS	Lädt eine gespeicherte Datensequenz.
PREP_PROCESS	Führt mit Hilfe von speziellen Job-Objekten (Ereignis-Jobs), Kommandos auf einem Rechner aus, und gibt die Konsolen-Ausgabe als interne Auflistung (Datensequenz) zurück, die zur Weiterverarbeitung genutzt werden kann.

Script-Sprachmittel - Datensequenzen

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

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support