PUT_PROCESS_LINE

Verwenden Sie die Script-Funktion PUT_PROCESS_LINE, um einer Datensequenz eine Zeile hinzuzufügen. Sie können den Verweis auf die Datensequenz und die hinzuzufügende Zeile angeben. Definieren Sie die als String (Script-Literal oder Script-Variable) oder als Script-Array (Script-Variable) hinzuzufügende Zeile. Mit einem String können Sie ein Trennzeichen definieren, um sie in Spalten aufzuteilen. Die Zeile besteht aus nur einer Spalte, die den gesamten String enthält, falls Sie das Trennzeichen nicht verwenden. Wenn Sie ein Script-Array angeben, wird es automatisch nach seinen Elementen in Spalten aufgeteilt. Leere Array-Elemente am Ende werden ignoriert. Die Datensequenz wird sofort geändert. Vom Rückgabewert wird der erfolgreiche Ablauf angezeigt.

Wichtig!

• Stellen Sie sicher, dass Sie eine Datensequenz angeben, die vorhanden ist und die nicht mit der Anweisung :CLOSE_PROCESS geschlossen wurde. Ansonsten kommt es zu einem Laufzeitfehler. Weitere Informationen finden Sie unter :CLOSE_PROCESS.
• Mit dieser Scirpt-Funktion kann keine neue Datensequenz erstellt werden.

Tipp: Erstellen Sie Datensequenzen mit dem Script-Element CREATE_PROCESS oder PREP_PROCESS*. Weitere Informationen finden Sie unter Script-Elemente für Datensequenzen.

Syntax

PUT_PROCESS_LINE (Data sequence, Line [ , Delimiter ])

Parameter

• PUT_PROCESS_LINE
  Fügt einer bestimmten Datensequenz eine Zeile hinzu
• Data sequence
  Bezieht sich auf die Datensequenz, der eine Zeile hinzugefügt werden soll
  Format: Script-Variable
• Line
  Zeile, die der Datensequenz hinzugefügt werden soll. Sie können auch ein Script-Array angeben.
  Format: Script-Variable oder Script-Literal
• Delimiter
  (Optional) Beliebiges Zeichen, das die angegebene Zeile in Spalten aufteilt.
  Format: Script-Variable oder Script-Literal
  Hinweis: Dieser Parameter funktioniert nicht, falls Sie für den Parameter Line ein Array definiert haben.

Rückgabewert

• 0
  Datensequenz wurde erfolgreich um die angegebene Zeile erweitert.

Beispiele

Im folgendem Beispiel wird eine Datensequenz erstellt, die eine Dateiliste enthält. Anschließend wird ein Dateiname aus einem VARA-Objekt abgerufen und der Datensequenz hinzugefügt.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","C:\AUTOMIC\temp\test*.txt","Y",,)
:SET &LINE# = GET_VAR(VARA.FILELIST)
:SET &RET# = PUT_PROCESS_LINE(&HND#,&LINE#)

Siehe auch: