Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datensequenzen > GET_PROCESS_INFO

GET_PROCESS_INFO

Scriptfunktion: Informationen einer Datensequenz ermitteln.

Syntax

GET_PROCESS_INFO(Data sequence reference, Information, [Line ])

Syntax	Beschreibung/Format
Datensequenz-Referenz	Referenz auf die Datensequenz, deren Informationen gelesen werden sollen. Format: Script-Variable
Information	Angabe, welche Informationen ermittelt werden. Format: AE-Name Erlaubte Werte: INDEX - Aktuelle Position in der Datensequenz ermitteln. Nur sinnvoll innerhalb von Prozess-Schleifen. COLUMNS - Anzahl der Spalten der angegebenen Zeile. Wird keine Zeile angegeben, so wird die Spaltenanzahl der aktuellen (bei Prozess-Schleifen) bzw. der ersten Zeile ermittelt. ROWS - Anzahl der Zeilen der Datensequenz.
Zeile	Zeile, deren Spalten-Anzahl ermittelt werden soll. Format: Zahl ohne Hochkommata, Script-Literal oder Script-Variable Dieser Parameter kann nur angegeben werden, wenn die Anzahl der Spalten ausgelesen wird (Information = COLUMNS).

Syntax

Beschreibung/Format

Datensequenz-Referenz

Referenz auf die Datensequenz, deren Informationen gelesen werden sollen.
Format: Script-Variable

Information

Angabe, welche Informationen ermittelt werden.
Format: AE-Name

Erlaubte Werte:

INDEX - Aktuelle Position in der Datensequenz ermitteln. Nur sinnvoll innerhalb von Prozess-Schleifen.
COLUMNS - Anzahl der Spalten der angegebenen Zeile. Wird keine Zeile angegeben, so wird die Spaltenanzahl der aktuellen (bei Prozess-Schleifen) bzw. der ersten Zeile ermittelt.
ROWS - Anzahl der Zeilen der Datensequenz.

Zeile

Zeile, deren Spalten-Anzahl ermittelt werden soll.
Format: Zahl ohne Hochkommata, Script-Literal oder Script-Variable

Dieser Parameter kann nur angegeben werden, wenn die Anzahl der Spalten ausgelesen wird (Information = COLUMNS).

Rückgabewert
Entsprechende Information der Datensequenz

Kommentare

Mit der Script-Funktion haben Sie die Möglichkeit, allgemeine Informationen (wie z.B. die Zeilen- oder Spalten-Anzahl) von Datensequenzen zu ermitteln. Anzugeben ist dabei die Referenz auf die Datensequenz und die zu bestimmende Information.

Soll die Spaltenanzahl ausgelesen werden, so können Sie zusätzlich die Nummer der Zeile spezifizieren, die dafür verwendet werden soll. Erfolgt keine Angabe, so wird abhängig von der Verwendung des Sprachmittels folgende Zeile herangezogen:

Das Script-Funktion wird innerhalb einer Prozess-Schleife verwendet: Zeile, auf welche die Schleife aktuell zugreift.
Die Script-Funktion befindet sich außerhalb einer Prozess-Schleife: Erste Zeile

Ist für Information der Wert INDEX gesetzt, so ist das Sprachmittel innerhalb einer Prozess-Schleife zu verwenden. Ermittelt wird in diesem Fall die Zeile der Datensequenz, die aktuell von der Schleife bearbeitet wird.

Das Auslesen der Zeilenanzahl von Datensequenz unterliegt keiner besonderen Abhängigkeiten.

Achten Sie darauf, dass die angegebene Datensequenz existiert und nicht bereits mit dem Sprachmittel :CLOSE_PROCESS geschlossen wurde. Ist dies nicht der Fall, kommt es zu einem Laufzeitfehler.

Beispiele

Im folgenden Beispiel wird eine Datensequenz erstellt und mit mehreren Einträgen eines Variablen-Objektes befüllt. Anschließend wird die Anzahl der Spalten pro Zeile bestimmt und im Aktivierungsprotokoll ausgegeben.

:SET &HND# = PREP_PROCESS_VAR(VARA.SQL,"*WIN*")
:SET &LNR# = GET_PROCESS_INFO(&HND#, ROWS)

:PROCESS &HND#
:SET &IND# = GET_PROCESS_INFO(&HND#,INDEX)
:SET &COL# = GET_PROCESS_INFO(&HND#,COLUMNS,&IND#)
:PRINT "Line &IND# / &LNR# has &COL# columns"
:ENDPROCESS

:CLOSE_PROCESS &HND#

Siehe auch:

Script-Sprachmittel	Beschreibung
:CLOSE_PROCESS	Verwirft eine Datensequenz innerhalb eines Scripts.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	Definition einer Schleife zur zeilenweisen Bearbeitung einer Datensequenz, wie beispielsweise den Inhalt einer sequentiellen Datei oder das textmäßige Ergebnis eines Kommandos.
GET_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.
PUT_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.

Script-Sprachmittel - Datensequenzen

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