Das Handbuch zu SDF-A V4.1 enthält gegenüber dem Vorgängerhandbuch (SDF-A V4.1E, Ausgabe 2002) folgende Änderungen:
Änderungen in SDF-A V4.1I
Der Auftragsschalter 15 wird nicht mehr auswertet. Daher können keine Syntaxdateien im Format von SDF kleiner V2.0 mehr erstellt werden.
Änderungen in SDF-A V4.1H
ADD-VALUE und MODIFY-VALUE
Neuer Datentyp LONG-INTEGER
SET-GLOBALS
Die sprachabhängigen Texte (Operand MODIFY-LANGUAGE-TEXT) wurden um das neue Datentypattribut CASES-SENSITIVE=*NAMES(...) erweitert, mit folgender Vorbelegungen für den Sprachschlüssel D:
LONG-NAME='Gross-und Kleinschreibung'
ABBREVIATION='Gross-Kleinschr'
Makros
CMDSEL
Neue Funktionalität
drei neue Operanden wurden der Schnittstelle CMDSEL hinzugefügt.
ein Operand wurde erweitert.
Neue Schnittstellenbeschreibung
Operation | Operands |
CMDSEL | TITLEL = <integer 1..240> / <var: int:4> ,MESSAGE@ = NULL / <var: pointer> ,MESSAGEL = NULL / <var: int 0..240> ,MARKL = 1 / <integer 1..75> / <var: int:1> |
OUTPUT = <var: pointer>
Adresse eines Bereiches, in den das Ergebnis der Auswahl geschrieben wird. Es müssen für jeden Auswahl-Satz soviel Bytes wie im MARKL Operanden angegeben reserviert werden, d.h. der Bereich muss eine Länge gleich LINENBR mal Wert von MARKL (n) haben. Der Bereich muss mit NUL oder Blanks initialisiert werden (bzw. eine vorab Auswahl). Wenn der Benutzer den Satz(i) mit einem Text_1..n markiert, werden die Bytes (1*n) bis (i*n + (n-1)) mit diesem Wert geschrieben. Falls vor dem Aufruf einem Teil des Bereiches ein Wert ungleich von NUL bzw. Blank zugewiesen wird, wird die Auswahl-Spalte mit diesem Wert vorbelegt.
TITLEL = <integer 1..240> / <var: int:4>
Länge des Texts, der als Bildschirm-Titel angezeigt wird. Dieser Operand wird nur bearbeitet, wenn dem Operanden TITLE@ eine Adresse ungleich 0 zugewiesen wird. Die Anzahl der Zeilen in der Auswahl-Liste hängt von der Anzahl Zeilen des Titel-Teils ab (eine Zeile weniger pro zusätzlicher Titel-Zeile).
MESSAGE@ = <var: pointer>
Bestimmt die Adresse eines Feldes mit der Meldung, die vor einer Auswahl durch den Benutzer angezeigt wird.
MESSAGEL = <var: int 0..240>
Bestimmt die Länge eines Feldes mit der Meldung, die vor einer Auswahl durch den Benutzer angezeigt wird.
MARKL = 1 / <integer 1..75> / <var: int:1>
Maximale Länge des Auswahlwerts, d.h die Breite der Auswahl Spalte. Die Länge der Auswahl-Zeile bis Bildschirm Breite wird entsprechend abgekürzt.
Zusätzliche Return Codes
(SC2) SC1 | Maincode | Bedeutung |
0C 01 0D 01 0E 01 0F 01 10 01 | 0008 0008 0008 0008 0008 | Fehler im Parameter: TITEMS Fehler im Parameter: TITEMSL Fehler im Parameter: MARKL Fehler im Parameter: MESSAGE@ Fehler im Parameter: MESSAGEL |
Zusätzliche Programmierung Hinweise
| OUTPUT: | der Makro fügt die NULs (0x00) in der angegebenen Auswahl-Spalte aus, d.h. die in der Eingabe-Spalte angegebenen durch NUL getrennten Zeichen werden zusammengefügt und die Restlänge wird auf NUL gesetzt. |
| TITLE and MESSAGE: | der ausgegebene Text kann länger als der im Operanden angegebene Wert sein, da der Makro eine neue Zeile einfügt, sodass Wörter bei zwei Zeilen nicht abgeschnitten werden. Falls der ausgegebene Text länger als 3 Zeilen ist, wird er mit "..." abgekürzt. |
SDF-A V4.1H ist ab BS2000/OSD V10.0 (mit SDF ab V4.8B) ablauffähig.
Bei voller Nutzung des Funktionsumfangs sind die erzeugten Syntaxdateien jedoch erst ab BS2000/OSD V11.0 einsetzbar.