GET_PROCESS_INFO

Script-Funktion: Ruft Informationen aus einer Datensequenz ab.

Syntax

GET_PROCESS_INFO (Datensequenz, Information [ , Zeile ])

Syntax	Beschreibung/Format
Datensequenz	Verweis auf die Datensequenz, deren Informationen gelesen werden soll. Format: Script-Variable
Information	Die spezifischen Informationen, die abgerufen werden soll Format: AE Name Zulässige Werte: INDEX Aktuelle Position der Verarbeitungsschleife, in der die Datensequenz verwendet wird. Weitere Informationen finden Sie unter :PROCESS... :TERM_PROCESS... :ENDPROCESS. COLUMNS Anzahl der Spalten der angegebenen Zeile . Wenn keine Zeile angegeben ist, wird die aktuelle Zeile (nur bei Verwendung in Verarbeitungsschleifen) oder die erste Zeile verwendet. ROWS Anzahl der Zeilen der Datensequenz
Zeile	Zeile, deren Spalten-Anzahl ermittelt werden soll. Format: Zahl ohne Anführungszeichen, 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 Script-Elements folgende Zeile herangezogen:

• Die Script-Funktion wird in einer Verarbeitungsschleife verwendet: Zeile, auf die derzeit von der Schleife zugegriffen wird.
• Die Script-Funktion befindet sich außerhalb einer Verarbeitungsschleife: Erste Zeile

Ist für Information der Wert INDEX gesetzt, so ist die Funktion 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.

Wichtig! Die angegebene Datensequenz muss vorhanden sein und darf nicht durch eine :CLOSE_PROCESS-Anweisung geschlossen werden. Ansonsten kommt es zu einem Laufzeitfehler. Weitere Informationen finden Sie unter :CLOSE_PROCESS.

Beispiele

Im folgendem Beispiel wird eine Datensequenz erstellt und mit mehreren Einträgen eines VARA-Objektes gefü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# hat &COL# Spalten"
:ENDPROCESS

:CLOSE_PROCESS &HND#

Siehe auch: