@ON (Format 1) - Ausgeben der Zeilen bzw. Zeichenfolgevariablen, die den Suchbegriff enthalten

Dieses Format der @ON-Anweisung bewirkt, dass der EDT den Inhalt jeder Zeile bzw. Zeichenfolgevariablen ausgibt, in der ein Treffer festgestellt wird. Im Dialog erfolgt die Ausgabe nach SYSOUT und im Stapelbetrieb nach SYSLST.

Operation	Operanden	F-Modus, L-Modus
@ON	{lines | svars} [,...] [:cols[:]] PRINT [ALL] [F] [R] [NOT] [PATTERN] search [,int] [S] [N] [E]

lines svars	Einer oder mehrere Zeilenbereiche, in denen gesucht werden soll. Einer oder mehrere Bereiche von Zeichenfolgevariablen, in denen gesucht werden soll.
cols	Zusammenhängender Spaltenbereich, auf den die Suche eingeschränkt werden soll. Enthält die Bereichsangabe nur eine einzelne Spaltenangabe, so wird damit der Bereich von dieser Spalte bis zum Zeilenende spezifiziert. Ist die erste Spaltenangabe bereits größer als die Zeilenlänge, wird die Zeile bzw. Zeichenfolgevariable ignoriert. Wird kein Spaltenbereich angegeben, wird der mit @SEARCH-OPTION eingestellte Spaltenbereich verwendet.
ALL	Der Operand ALL ist nur wirksam bei gleichzeitiger Angabe des Operanden E. In diesem Falle werden alle Treffer einer Zeile optisch hervorgehoben. Ist ALL nicht angegeben, aber E, wird nur der erste Treffer einer Zeile optisch hervorgehoben.
F	Es wird nur die erste Trefferzeile jedes angegebenen Zeilenbereiches ausgegeben. Ist F nicht angegeben, werden alle Trefferzeilen jedes angegebenen Zeilenbereiches ausgegeben. Sind F und E gleichzeitig angegeben, wird der erste Treffer in der ersten Trefferzeile jedes angegebenen Zeilenbereiches optisch hervorgehoben. Bei gleichzeitiger Angabe von F, ALL und E werden alle Treffer in der jeweils ersten Trefferzeile jedes angegebenen Zeilenbereiches optisch hervorgehoben.
R	Die Zeilen werden von rechts nach links durchsucht. Ist R nicht angegeben, werden sie von links nach rechts durchsucht. Wird R angegeben, aber weder ALL noch F, so muss PRINT mindestens mit PR abgekürzt werden.
NOT	Ein Treffer wird erkannt, wenn im angegebenen Spaltenbereich einer Zeile der Suchbegriff nicht enthalten ist (negatives Suchen). Die Operanden ALL und E haben in diesem Falle keine Bedeutung.
PATTERN search	Die im Suchbegriff vorkommenden Musterzeichen werden interpretiert. Suchbegriff, der im Suchbereich aufgefunden werden soll (Details siehe Abschnitt „Suchen mit @ON“). Die Angabe einer leeren Zeichenfolge ist nicht erlaubt.
int	Erst das int-te Auftreten des Suchbegriffes in einer Zeile ist als erster Treffer zu werten. Als Eingaben für int sind alle Werte zwischen 1 und 32768 erlaubt. Der Standardwert für int beträgt 1.
S	Die Leerzeile, die der ersten auszugebenden Zeile vorausgeht, wird unterdrückt. Der Operand wirkt nur, falls die Ausgabe nach SYSLST erfolgt. Ist S nicht angegeben, beginnt die Ausgabe mit einer Leerzeile.
N	Die Trefferzeilen werden ohne zugehörige Zeilennummer ausgegeben. Analog dazu wird die Ausgabe der Namen von Zeichenfolgevariablen (#S00..#S20) unterdrückt, falls in Zeichenfolgevariablen nach Treffern gesucht wird. Ist N nicht angegeben, werden die Zeilennummern und die Namen von Zeichenfolgevariablen mit ausgegeben.
E	In der Ausgabe der Trefferzeilen am Bildschirm werden die Treffer optisch noch hervorgehoben. Sind E und ALL gleichzeitig angegeben, werden alle Treffer in der Trefferzeile hervorgehoben, ansonsten nur der erste Treffer. Ist E nicht angegeben, werden die Treffer bei der Ausgabe optisch nicht hervorgehoben. Dieser Operand wirkt nur, wenn VTCSET ON eingestellt ist, anderenfalls wird er ignoriert. Bei der Ausgabe langer Zeilen wird die Ausgabe möglicherweise durch ein %PLEASE ACKNOWLEDGE vom System unterbrochen. Geschieht das innerhalb einer hervorgehobenen Trefferzeichenfolge, ist der Rest dieser Zeichenfolge, die auf dem nächsten Bildschirm angezeigt wird, nicht mehr hervorgehoben. Würde die auszugebende Zeile durch Einfügen der Bildschirmsteuerzeichen länger als 32768 Zeichen, wird das Einfügen abgebrochen und im Rest der Zeile werden die Trefferzeichenfolgen nicht mehr hervorgehoben. Es wird zu Information die Meldung EDT1248 ausgegeben.

Beispiel

Die erste Zeile, die die Zeichenfolge TREFFER enthält, soll ausgegeben werden.

Alle Zeilen sollen ausgegeben werden, in denen die Zeichenfolge TREFFER vorkommt.
Anschließend soll die erste gefundene Trefferzeichenfolge in die Zeile 100 geschrieben
werden.

Bei mehreren Treffern sind die Inhalte der Zeilennummervariablen #L0 und der Ganzzahlvariablen #I0 und #I1 für den ersten gefundenen Treffer gültig, d.h. TREFFER in Zeile 2.

Alle Zeilen sollen ausgegeben werden, die jenseits der Spalte 2 die Zeichenfolge TREFFER beinhalten.

 Die Zeilen sollen ausgegeben werden, die mindestens dreimal die Zeichenfolge EN enthalten.

Es sollen alle Zeilen ausgegeben werden, die nicht die Zeichenfolge TREFFER enthalten.