Die Funktion sdfsta gibt Informationen über aktivierte Syntaxdateien und über die Festlegungen aus, die für die Eingabe und Verarbeitung von Kommandos und Anweisungen gelten. Die Beschreibung des Übergabebereiches der Informationen finden Sie beim Makro CMDSTA (CMDSTA Informationen über aktivierte Syntaxdateien ausgeben).
Da die Funktion einen optionalen Parameter hat, gibt es 2 verschiedene Formate.
Bei Aufruf von Format 1 wird immer die Kurzform ausgegeben:
aktivierte Syntaxdateien, jedoch ohne Subsystem-Syntaxdateien, sowie die aktuellen Optionen für die Eingabe und die Verarbeitung von Kommandos und Anweisungen. Für area sollte der vordefinierte Struktur-Typ SDF_STATUS_SHORT verwendet werden (siehe auch Beispiel (Beispiel zur Verwendung der C-Funktionen).
Bei Aufruf von Format 2 wird die Langform ausgegeben:
aktivierte Syntaxdateien (einschließlich der Subsystem-Syntaxdateien) sowie die aktuellen Optionen für die Eingabe und die Verarbeitung von Kommandos und Anweisungen. Die Menge der ausgegebenen Informationen über Subsystem-Syntaxdateien hängt davon ab, wieviel Platz im dem Übergabebereich zur Verfügung steht. Passten nicht alle Subsystem-Informationen in den Übergabebereich, so wird ein entsprechender Fehlercode übergeben.
Format 1
int sdfsta (char *area);
Format 2
int sdfstal (char *area, int lng);
Beschreibung der Parameter
char *area | Zeiger auf einen Übergabebereich, in dem die Informationen von |
int lng | Länge des Übergabebereiches für FORM=LONG (siehe Makro |
Ergebnis
Die Funktion liefert eine Integerzahl als Ergebnis (siehe "Beispiele").