GET_PROCESS_INFO

Verwenden Sie die Script-Funktion GET_PROCESS_INFO, um allgemeine Informationen wie die Anzahl von Spalten oder Zeilen von Datensequenzen abzurufen. Dazu müssen Sie die abzurufende Datenfolge und die zu lesenden Informationen angeben.

Wichtig! Die angegebene Datensequenz muss vorhanden sein. Stellen Sie sicher, dass sie noch nicht mit einer :CLOSE_PROCESS-Anweisung geschlossen wurde. Ansonsten kommt es zu einem Laufzeitfehler. Weitere Informationen finden Sie unter :CLOSE_PROCESS.

Syntax

GET_PROCESS_INFO (Data sequence, Information [, Line])

Parameter

  • GET_PROCESS_INFO
    Ruft Informationen aus einer Datensequenz ab

  • Datensequenz
    Definiert die Datensequenz, deren Informationen gelesen werden sollen
    Format: Script-Variable

  • Information
    Definiert den Typ der abzurufenden Informationen
    Format: AE Name
    Zulässige Werte:

    • COLUMNS
      Ruft die Spaltenanzahl der definierten Zeile ab. Verwenden Sie diesen Schlüssel mit dem Parameter LINE, um die Nummer der Zeile zu definieren, die für diesen Zweck verwendet werden soll. Wenn Sie keine Zeile angeben, gilt Folgendes:
      • Die Script-Funktion wird innerhalb einer Prozessschleife verwendet: Die von der Schleife aktuell verwendete Zeile wird angewendet.
      • Die Script-Funktion wird außerhalb der Prozessschleife verwendet: Die erste Zeile wird abgerufen.
    • ROWS
      Ruft die Anzahl der Zeilen ab, über welche die Datensequenz verfügt
  • Zeile
    (Optional) Definiert die Zeile, deren Spaltenanzahl abgerufen werden soll
    Format: Eine Nummer ohne Anführungszeichen, Script-Literal oder Script-Variable
    Hinweis: Sie können diesen Parameter nur verwenden, wenn Sie die Anzahl von Spalten abrufen (Information = COLUMNS).

Rückgabewert

Diese Script-Funktion gibt die Informationen aus der Datensequenz zurück.


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:

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine Datensequenz erstellen, die mit den Einträgen eines VARA-Objekts gefüllt ist. 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:

seealso

Script-Elemente für Datensequenzen