WRITE_PROCESS

Verwenden Sie die Script-Funktion WRITE_PROCESS, um den Inhalt einer Datensequenz in eine Datei zu schreiben. WRITE_PROCESS exportiert den Inhalt einer beliebigen Datensequenz in eine Textdatei. Dabei muss ein Verweis auf die entsprechende Datensequenz angegeben werden, die beim Anlegen der Datensequenz in einer Script-Variablen abgelegt wird. Jede Zeile der Datensequenz wird als Zeile in die Datei geschrieben. Es kann festgelegt werden, ob alle oder nur eine bestimmte Spalte der Datensequenz in die Datei geschrieben werden sollen.

Syntax

WRITE_PROCESS (Datensequenz-Referenz, Datei, Agent, Login,[Modus],[Codetabelle], [Datei-Attribute], [Spalte])
WRITE_PROCESS (Datensequenz-Referenz, Datei, Agent, Login,[Modus],[Codetabelle], [Datei-Attribute], [ALL], [Trennzeichen])

Parameter

• WRITE_PROCESS
  Schreibt den Inhalt einer Datensequenz in eine Datei

• Datensequenz-Referenz
  Referenz auf die 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, dessen Host verwendet werden soll, um die Datei zu speichern
  Format: AE-Name, Script-Variable oder Script-Literal

• Login
  Name des Login-Objekts, das für die Anmeldung beim Host des angegebenen Agenten verwendet werden soll
  Format: AE-Name, Script-Literal oder Script-Variable

• Mode
  (Optional) Definiert das weitere Verfahren, wenn die angegebene Datei bereits existiert
  Format: AE-Name, Script-Variable oder Script-Literal
  Erlaubte Werte:

  • CANCEL (Standard)
    Script-Verarbeitung wird abgebrochen
  • OVERWRITE
    Die Datei wird überschrieben
  • APPEND
    Die bestehende Datei um die neuen Zeilen erweitert

• CodeTable
  (Optional) Name eines Codetabellen-Objekts, das für die Codierung der Datei verwendet werden soll. Weitere Informationen finden Sie unter Code-Tabellen (CODE). Wird dieser Parameter nicht angegeben, so wird die Standard-Codetabelle UC_CODE verwendet.
  Format: AE-Name, Script-Literal oder Script-Variable

• Dateiattribute
  (Optional) Zusätzliche Dateiattribute für die generierte Datei. Verwenden Sie Kommas, um Attribute zu trennen, wenn Sie mehrere Attribute definieren. Abhängig von der INI-Datei des Agenten können Sie die Attribute angeben, die auch für FileTransfers verwendet werden können. Weitere Informationen finden Sie unter FileTransfers (JOBF).
  Format: Script-Variable oder Script-Literal

• Spalte
  (Optional) Die Anzahl der Spalten der Datensequenz, die in die Datei geschrieben werden soll.
  Format: Script-Literal, Script-Variable, eine Zahl ohne Anführungszeichen
  Zulässige Werte:

  • ALL (Standardwert)
    Alle Spalten
  • Die Zahl der Spalte, die in die Datei geschrieben werden soll, wie zum Beispiel 2.

• Trennzeichen
  (Optional) Das Zeichen, das verwendet werden soll, wenn Sie mehrere Spalten definieren. Dieser Parameter ist nur relevant, wenn Sie alle Spalten exportieren.
  Format: Script-Literal, Script-Variable, eine Zahl ohne Anführungszeichen

Rückgabewerte

• 0
  Datei wurde erfolgreich exportiert
• 20554
  Der Agent derzeit nicht aktiv

Beispiele

Folgendes Beispiel erstellt eine neue Datensequenz, welche eine Liste mit Dateinamen eines bestimmten Verzeichnisses speichert. Anschließend wird der Inhalt dieser Datensequenz in einer 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: