%IN Betätigung einer DUE-Taste, vorgegebener Eingabestring
*ON %IN= { t-bez | such } CONTINUE | SKIP .label
t-bez Tastenbezeichnung: K1, K3, ... , K23 / F1, ... , F20 / DUE1 / DUE2
Diese Variante der %IN-Bedingung ist erfüllt, nachdem der Benutzer die bezeichnete Datenübertragungstaste betätigt hat. DUE1 steht hierbei für ENTER und DUE2 für Shift ENTER. Es wird der prozedurgesteuerte Modus aufgenommen (CONTINUE) bzw. ein Sprung zu dem angegebenen Label ausgeführt (SKIP .label).
Die *ON %IN Anweisung kann nicht verwendet werden, um bestimmte DUE-Tasten in *RDMASK abzufragen. Um die Datenübertragungstaste der letzten RDMASK Maske abzufragen ist nach *RDMASK die CFS-interne Variable &RDMASKIN auszuwerten. Dazu ist die folgende Anweisung anzugeben: *IF &RDMASKIN = t-bez SKIP .label
Beispiel: *IF &RDMASKIN = K1 SKIP .ENDE
such einfaches oder mehrfaches Suchargument der Form
'string| L'string' | A'string' | X'string'
Es ist zu beachten, daß bei Angabe des Suchstrings in der Form 'string' Kleinbuchstaben in string in die entsprechenden Großbuchstaben umgewandelt werden.
Bei Angabe von L'string' bleibt string in der angegebenen Groß-/Kleinschreibung unverändert. Es wird keine Umsetzung in Großbuchstaben durchgeführt.
Bei Angabe von A'string' (Any) ist die Schreibweise von string in Klein- oder Großbuchstaben für das Suchergebnis ohne Bedeutung. Sowohl der Suchstring, als auch der zu durchsuchende Text werden vor dem Vergleich in Großbuchstaben umgewandelt.
Mehrere Suchargumente können durch die Operatoren + (Und) / , (Oder) / * (Wildcard) verknüpft werden.
Die %IN-Bedingung ist erfüllt, wenn der Suchstring bzw. einer der Suchstrings in der vom Benutzer getätigten Eingabe enthalten ist. Es wird der prozedurgesteuerte Modus aufgenommen (CONTINUE) bzw. ein Sprung zu dem angegebenen Label in der Prozedur ausgeführt. Außerdem wird ein Pointer %PTR auf das Ende des gefundenen Suchstrings in der Eingabenachricht gesetzt. Der Pointer kann dazu benutzt werden, einen Teilstring der Eingabenachricht an eine Prozedurvariable zuzuweisen. Weitere Informationen hierzu siehe Seite 19-.
Eine ausführliche Beschreibung der Suchbedingung finden Sie auf den Seiten 8- und 8-.
*ON %IN Die zuletzt definierte *ON %IN-Bedingung wird wieder aktiviert.
Ein Beispiel für die ON %IN-Anweisung finden Sie auf Seite 19-.