Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datensequenzen > :PROCESS... :TERM_PROCESS... :ENDPROCESS

: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

Syntax

Beschreibung/Format

:PROCESS

Beginn der Prozess-Schleife.

Datensequenz-Referenz

Referenz auf die zu verarbeitende Datensequenz.
Format: Script-Variable

Anweisungen

Eine oder mehrere Anweisungen, die bei jedem Schleifendurchlauf ausgeführt werden. Format: Script-Anweisung

:TERM_PROCESS

Anweisung zum Verlassen der Prozess-Schleife.

:ENDPROCESS

Ende der Prozess-Schleife.

:CLOSE_PROCESS

Gibt den Verweis (Handle) nach jeder :PROCESS - :ENDPROCESS Schleife frei.

Anmerkungen

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

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

 


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

Copyright © 2016 Automic Software GmbH