Z-VARX

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Eine Liste aller Variablen ausgeben, die in einem Dokumenttext vorkommen. Sie können nur Txt- und Cnf-Dokumente verarbeiten.

Sie können dieses Programm iterativ aufrufen. Der Work-Parameter enthält die Position im Text, an der das Subprogramm beim letzten Aufruf aufgehört hat.

Der Parameter Doppelte-unterdruecken bewirkt Folgendes (der Wert muss alphanumerisch sein):

  • Wenn Sie keinen Wert oder einen anderen Wert als 1 oder 2 angeben: Nach jedem iterativen Aufruf überprüft dieses Subprogramm den gesamten Text, damit keine doppelten Variablen ausgegeben werden. Daher kann die Reihenfolge der ausgegebenen Variablen von ihrer Reihenfolge im Dokumenttext abweichen. Ein zu langer Text mit vielen doppelten Variablen kann zu häufigen Adabas-Aufrufen führen.

  • Wenn Sie den Wert 1 angeben: Die Variablen werden nicht doppelt in der Variablenliste ausgegeben. Wenn der Textteil, der gerade verarbeitet wird, zum Beispiel zwei Mal &HALLO enthält, wird nur ein HALLO ausgegeben. Wenn Sie dieses Subprogramm jedoch iterativ aufrufen und &HALLO erneut im Text vorkommt, wird es in der neuen Variablenliste ausgegeben.

  • Wenn Sie den Wert 2 angeben: Der Text wird von diesem Subprogramm nicht überprüft. Jede Variable wird ausgegeben. Daher kann &HALLO in einer Variablenliste mehrfach ausgegeben werden.

Con-form-Systemvariablen werden nicht ausgegeben.

Anmerkung:
Im Dokumenttext müssen die Zeichen hinter dem Variablenzeichen (Vorgabe: &) alphanumerisch sein (der Unterstrich (_) kann auch benutzt werden), sonst wird die Variable nicht in der Variablenliste ausgegeben. Daher werden auch Con-form-Systemvariablen (z.B. &$PN) nicht ausgegeben.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem das Dokument abgelegt ist.
Passwort A8 E   Das Passwort des o.g. Büros.
Dokumentname A32 E*   Der Name des Dokuments, das die Variablen enthält. Entweder Dokumentname oder ISN, nicht beides.
ISN P10 E*   Die ISN des Dokuments, das die Variablen enthält. Entweder ISN oder Dokumentname, nicht beides.
Variablenzeichen A1 O   Das Zeichen, das im Dokumenttext vor einer Variablen steht. Vorgabe: &.
Keine-Systemvariablen L O   Wenn wahr, werden die Con-nect-Systemvariablen nicht ausgegeben. Vorgabe: falsch.
Doppelte-unterdruecken A1 O   Siehe die Beschreibung oben.
Anzahl N2 O   Die maximale Anzahl von Elementen, die mit jedem Aufruf ausgegeben werden. Wenn Sie keinen Wert definieren oder einen Wert, der größer ist als 20, wird der Vorgabewert 20 benutzt.
Variablenliste A32/1:20   X Die Liste mit den Variablen.
Work-Parameter A18     Für den internen Gebrauch. Siehe Work-Parameter.

Return-Codes

00 Erfolg
02 Ungültiger Büroname
03 Falsches Passwort
04 ISN wurde nicht gefunden
08 Geben Sie entweder ISN oder Name ein - nicht beides
09 ISN zeigt nicht auf das richtige Objekt
51 Ungültiger Name
53 Das gewünschte Objekt existiert nicht
77 Ende des Dokuments
78 Dies ist kein Textdokument

Subprogramme

Z-120
Z-122
Z-123
Z-143
Z-1200&0