Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

bs2exit - Programm mit MONJV beenden (BS2000)

&pagelevel(4)&pagelevel

Definition

#include <stdlib.h>

void bs2exit(int status, const char *monjv_rcode);

Beschreibung

bs2exit() beendet das aufrufende 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)  und != EXIT_FAILURE (Wert 9990888) ist.

  • "EXC0732 ABNORMAL PROGRAMM TERMINATION. ERROR CODE NRT0101

Die Zustandsanzeige der Monitor-Jobvariablen (1. - 3. Byte) wird entsprechend dem Argument status wie bei der Funktion exit() auf den Wert "$A " gesetzt, falls status = EXIT_ FAILURE. Bei allen anderen Werten für status steht „$T“ in der Monitor-Jobvariablen.

Zusätzlich lässt sich mit monjv_rcode die Rückkehranzeige von MONJV (4. - 7. Byte) versorgen.
Für monjv_rcode kann ein Zeiger auf eine 4 Byte lange Information (Rückkehranzeige) angegeben werden, die bei Programmbeendigung in MONJV aufgenommen wird.

Inhalt und Auswertung des Arguments status sind identisch mit exit().

Hinweise

Bei der Programmbeendigung mit bs2exit() werden die mit atexit() registrierten Beendigungsroutinen nicht aufgerufen (siehe exit()).

Um Monitor-Jobvariablen versorgen und abfragen zu können, muss das C-Programm mit folgendem Kommando gestartet werden:
/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".

Siehe auch

exit(), _exit().