bs2exit - Programmbeendigung mit MONJV

Definition	#include <stdlib.h> void bs2exit(int status, const char *monjv_rcode); bs2exit beendet das Programm. Vorher werden alle vom Programm geöffneten Dateien geschlossen und folgende Meldungen auf stderr ausgegeben: „CCM0998 used CPU-time t seconds“, falls in der RUNTIME-Option CPU-TIME=YES gesetzt ist, „CCM0999 exit FAILURE“, falls status = EXIT_FAILURE (Wert 9990888) ist, „CCM0999 exit status“, falls status != EXIT_SUCCESS (Wert 0)  bzw. EXIT_FAILURE (Wert 9990888) ist. "EXC0732 ABNORMAL PROGRAMM TERMINATION. ERROR CODE NRT0101“ Die Zustandsanzeige der Monitor-Jobvariablen (1. - 3. Byte) wird wie bei der Funktion exit auf den Wert "$T " oder "$A " gesetzt, entsprechend dem ersten Parameter status. Zusätzlich lässt sich mit dem Parameter monjv_rcode die Rückkehranzeige der MONJV (4. - 7. Byte) versorgen.
Parameter	int status siehe Funkfion exit. const char *monjv_rcode: In diesem Parameter kann ein Zeiger auf eine 4 Byte lange Information (Rückkehrcode- Anzeige) angegeben werden, die bei Programmbeendigung in die MONJV aufgenommen wird.
Hinweis	Bei der Programmbeendigung mit bs2exit werden die mit atexit registrierten Beendigungsroutinen nicht aufgerufen (vgl. exit). Um Monitor-Jobvariablen versorgen und abfragen zu können, müssen Sie das C-Programm mit folgendem Kommando starten: /START-PROG programm,MONJV=monjvname               Der Inhalt der Jobvariablen lässt sich dann z.B. mit folgendem Kommando abfragen: /SHOW-JV JV-NAME(monjvname) Weitere Informationen zur Ablaufüberwachung mit MONJV finden Sie im Handbuch „Jobvariablen“.
Beispiel	Programmbeendigung mit Setzen der Rückkehranzeige #include <stdio.h> int main(void) { ... if(fehler) bs2exit(-1, "ABCD"); }
Siehe auch	exit, _exit