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
Data- Sequence Reference	Referenz auf jene Datensequenz, deren Inhalt in eine Datei exportiert werden soll. Format: Script-Variable
File	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-Literal oder Script-Variable
Login	Der Name des Login-Objekts, das für die Anmeldung am Host des angegebenen Agenten verwendet wird. Format: AE-Name, Script-Literal oder Script-Variable
Mode	Verhalten, wenn die angegebene Datei bereits existiert. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: CANCEL (Standard) - Die Script-Verarbeitung wird abgebrochen. OVERWRITE - Datei überschreiben APPEND - bestehende Datei um die neuen Zeilen erweitern.
CodeTable	Name eines CodeTabellen-Objektes, welches für die Kodierung der Datei verwendet werden soll. Format: AE-Name, Script-Literal oder Script-Variable Wird dieser Parameter nicht angegeben, so wird die Standard-CodeTabelle UC_CODE verwendet.
File Attributes	Zusätzliche Dateiattribute für die erzeugte Datei. Format: Script-Variable oder Script-Literal Abhängig von der INI-Datei des Agenten können Sie die Attribute angeben, die auch für Dateiübertragungen verwendet werden können. Mehrere Attribute sind dabei durch Kommata zu trennen.
Row	Spalte(n) der Datensequenz, welche in die Datei geschrieben werden sollen. Format: Script-Literal, Script-Variable, eine Zahl ohne Anführungszeichen Erlaubte Werte: ALL (Standardwert) - Alle Spalten Anzahl der erforderlichen Spalten (z. B.: 2).
Delimiter	Trennzeichen bei der Angabe mehrerer Spalten. Format: Script-Literal, Scrtip-Variable, eine Zahl ohne Anführungszeichen Nur relevant, wenn alle Spalten der Datensequenz exportiert werden.

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

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. Zu diesem Zweck wird der Parameter „Column“ verwendet. Standardmäßig werden alle Spalten exportiert.

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. Im Falle eines Fehlers (Rückgabewert von WRITE_PROCESS > 0) wird eine Fehlermeldung geschrieben und an den zuständigen 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: