GET_PROCESS_INFO

Script-Funktion: Informationen einer Datensequenz ermitteln.

Syntax

GET_PROCESS_INFO (Data sequence, Information [ , Row ])

Syntax	Beschreibung/Format
Data sequence	Verweis auf die Datensequenz, deren Informationen gelesen werden soll. Format: Script-Variable
Information	Angabe, welche Information ermittelt wird Format: AE Name Erlaubte Werte: INDEX - Aktuelle Position der Prozess-Schleife, in der die Datensequenz verwendet wird. 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
Row	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

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 der Verweis 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 Sprachmittel wird innerhalb einer Prozess-Schleife verwendet: Zeile, auf welche die Schleife aktuell zugreift.
• Sprachmittel 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. Ansonsten kommt es zu einem Laufzeitfehler.

Beispiele

Im folgendem 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 Aktivierungsreport 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: