RES Modifikation der Eingaben (KEY)
Diese Variante des RES-Kommandos ist nur in Prozeduren erlaubt. Es können mehrere aufeinanderfolgende RES KEY-Anweisungen angegeben werden. Diese werden in einer Tabelle gesammelt und bewirken bei dem nächsten Kommando RES datei... in den entsprechenden Sätzen die gewünschten dynamischen Modifikationen der Eingabe. Nach Beendigung des Kommandos RES datei wird die KEY-Tabelle gelöscht.
RES KEY=isam-key,:col: [len1] '&var' | 'str' [len2]
isam-key 8 Byte langer ISAM-Schlüssel des Satzes in der als nächstes auszuführenden RES-Datei, in der eine vorgegebene Eingabe modifiziert werden soll. Bei ISAM-Schlüsseln, die mit dem Binärzeichen X'FA' enden (in CFS durch ein Schmierzeichen dargestellt), ist an der Stelle 8 der Buchstaben 'X' anzugeben.
:col: Spalte.
Die erste Spalte der zu modifizierenden Eingabe. Die erste Stelle nach dem ISAM-Schlüssel entspricht der Spalte :9: (Vgl. hierzu die Spaltenangabe mit SCALE-Kommando im CFS-Display).
len1 Länge der Ersetzung. Im Standardfell ist dies die Länge des nachfolgenden Strings bzw. des Inhalts der nachfolgend angegebenen Variablen.
Ist len1 kürzer als der Variableninhalt, so wird die Modifikation auf die angegebene Länge beschränkt (Kürzung).
Ist len1 länger als der Variableninhalt, so wird dieser rechts mit Leerzeichen aufgefüllt und die Modifikation in dieser Länge ausgeführt.
'&var' | 'str' Der einzusetzende String kann als fester Wert oder als Inhalt einer CFS-Variablen angegeben werden.
len2 Falls len2 nicht angegeben ist, überschreibt der angegebene Inhalt den ursprünglichen Inhalt an dieser Spalte.
Die Angabe von len2 bewirkt eine Längenänderung im Eingabesatz. Der ursprüngliche Text in der Länge len2 wird ausgefügt und anstelle dessen der gewünschte String in der neuen Länge eingefügt.
Beispiel:
RES KEY=15432200,:32:8'&INPUT'
RES KEY=1543220X,:39:8'&INPUT'20
RES CFS.LOG
In der Datei CFS.LOG wird das Eingabefeld im Satz mit dem ISAM-Schlüssel 15432200 ab der Spalte 32 in der Länge 8 mit dem Inhalt der CFS-Variablen &INPUT überschrieben.
Im nächsten Satz mit dem Schlüssel 1543220X'FA' (dieser Satz ist nur im Step-Modus des RES-Kommandos von Bedeutung) wird der Inhalt ab der Spalte 39 in der Länge 20 gelöscht und stattdessen der Inhalt der Variablen &INPUT in der Länge 8 eingefügt.
Nach Ausführung des Kommandos RES CFS.LOG sind die dynamischen Eingabemodifikationen für evtl. weitere RES-Kommandos nicht mehr aktiv.