Die Systemvariable 'sysVar.returnCode' enthält einen externen Rückgabecode, der von Ihrem Programm festgelegt wurde. Ein Hauptprogramm verwendet 'sysVar.returnCode', um einen Rückgabecode an das Betriebssystem zu übergeben; Beispiel: JCL (Jobsteuersprache), CL (Command Language), Stapeldatei oder Befehlsprozessor. Ein aufgerufenes Programm verwendet 'sysVar.returnCode', um einen Rückgabecode an ein Nicht-EGL-Programm zu übergeben.
Rückgabecodes können nicht von einem EGL-Programm an ein anderes EGL-Programm übergeben werden. Ein Wert ungleich null in 'sysVar.returnCode' beispielsweise führt nicht dazu, dass EGL einen onException-Block ausführt.
Der Anfangswert von 'sysVar.returnCode' ist null. Für COBOL-Ausgabe muss der Wert im Bereich von 0 bis einschließlich 512 liegen.
Im folgenden Beispiel wird ein Rückgabecode zur Übergabe an das Betriebssystem festgelegt:
sysVar.returnCode = 6;
| Plattform | Problem |
|---|---|
| Java™-Generierung |
|
| COBOL-Generierung |
|
| CICS für z/OS | 'sysVar.returnCode' ist nur dann nach Beendigung des Programms verfügbar, wenn das Programm über ein anderes Programm in derselben CICS-Region aufgerufen wurde und nicht über einen Befehl EXEC CICS LINK. Der Rückkehrcode ist nur dann von Bedeutung, wenn das CICS-basierte Programm aufgerufen wird (und zwar auch nur dann, wenn das Programm von einem nicht mit EGL generierten Programm aufgerufen wird). |
| IMS/VS | 'sysVar.returnCode' wird nicht von Hauptprogrammen zurück übergeben. |