sdfrc Kommando-Returncodes setzen

Mit der Funktion sdfrc kann das Benutzerprogramm eigene Werte als „Kommando-Returncode“ für das Programm sichern, die der Kommandoprozessor nach Programmbeendigung an Stelle des offiziellen Kommando-Returncodes zur Verfügung stellt. Dieser Kommando-Returncode wird von anderen Systemfunktionen (z.B. SDF-P) ausgewertet (siehe auch Handbuch „Kommandos“ [4]). Die Funktion sdfrc stützt sich auf den Makro CMDRC (CMDRC Kommando-Returncodes setzen).

Format

---

int sdfrc (char *area);

---

Beschreibung der Parameter

char *area

Zeiger auf eine Zeichenkette, die den Kommando-Returncode enthält, muss auf Halbwortgrenze ausgerichtet sein. Dafür sollte der vordefinierte Struktur-Typ SDF_COMMAND_RC verwendet werden (siehe Beispiel zur Verwendung der C-Funktionen).

Ergebnis

Die Funktion liefert eine Integerzahl als Ergebnis (siehe "Beispiele").