:CLOSE_PROCESS

Datensequenzen

CREATE_PROCESS

---

:PROCESS... :TERM_PROCESS... :ENDPROCESS

Script-Anweisungen: Definition einer Schleife zur zeilenweisen Bearbeitung einer Datensequenz, wie beispielsweise den Inhalt einer sequentiellen Datei oder das textmäßige Ergebnis eines Kommandos.

Syntax

:PROCESS Data sequence reference
[Statement]
:TERM_PROCESS
:ENDPROCESS
:CLOSE_PROCESS

Anmerkungen

Die Script-Anweisungen :PROCESS und :ENDPROCESS erlauben eine zeilenweise Verarbeitung von Datensequenzen. Diese werden von den folgenden Script-Sprachmitteln bereitgestellt:

• PREP_PROCESS
• PREP_PROCESS_AGENTGROUP
• PREP_PROCESS_COMMENTS
• PREP_PROCESS_FILE
• PREP_PROCESS_FILENAME
• PREP_PROCESS_REPORT
• PREP_PROCESS_VAR

Mit jedem Schleifendurchlauf wird eine neue Zeile der Datensequenz gelesen. Das wird solange wiederholt, bis deren Ende erreicht ist bzw. die Schleife explizit mit :TERM_PROCESS beendet wird.

Der Zeileninhalt kann mit der Script-Funktion GET_PROCESS_LINE ermittelt werden.

Eine leere Datensequenz führt zu keiner Fehlermeldung. Die Bearbeitung, die zwischen :PROCESS und :ENDPROCESS definiert ist, wird in diesem Fall einfach nicht durchlaufen.

Beispiel

Im folgenden Beispiel werden die Verzeichnisse eines Laufwerkes ermittelt und innerhalb der Prozess-Schleife mit der :PRINT-Anweisung in das Aktivierungsprotokoll ausgegeben. Diese enthält eine :TERM_PROCESS Anweisung, um die Schleife zu beenden, wenn der Wert der USER Variable gleich TSOS ist.

:SET &HND# = PREP_PROCESS("PC01","WINCMD","*DIR*","CMD=DIR C:")
:PROCESS &HND#
:   SET &LINE# = GET_PROCESS_LINE(&HND#)
:    IF&USER# = "TSOS" 
:      TERM_PROCESS
:   ENDIF
:   PRINT &LINE#
:ENDPROCESS
:CLOSE_PROCESS &HND#

Siehe auch:

Script-Sprachmittel - Datensequenzen

Beispielsammlung
Endestatus aufgrund des Reportinhaltes setzen
Aufruf eines MBeans

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