![[z/OS]](../images/ngzos.gif)
Schnittstelle für Speicherauszug und Fehlerbereinigung
Mit der Schnittstelle für Speicherauszug und Fehlerbereinigung (BBORLEXT) kann WebSphere Application Server for z/OS in einer Wiederherstellungsumgebung aufgerufen werden, um einen Speicherauszug anzufordern und die Ressourcen zu bereinigen.
Die Schnittstelle führt folgende Aktionen aus:
- Sie speichert die Funktions- und DLL-Namen der fehlerhaften z/OS-Komponente im Arbeitsbereich für Systemdiagnose (SDWA).
- Sie erstellt einen Systemspeicherauszug (SDUMP), sofern dieser für den Zeitpunkt, zu dem der Fehler in der Umgebung aufgetreten ist, relevant ist.
- Sie bereinigt die internen z/OS-Strukturen und -Verbindungen.
Softwarevoraussetzungen: Diese Schnittstelle muss von einem Location Service Daemon, Controller (Region) oder Servant (Region) in WebSphere Application Server for z/OS aufgerufen werden. Es sind keine Beschränkungen bezüglich der Wiederherstellungsumgebung (ESTAE- oder FRR-Routine) für den Aufrufenden vorhanden.
Allgemeine Informationen
Interface | BALR zu BBORLEXT |
Adresse der Routine | (ECVT+'234'x)+'20'x |
Adressmodus | AMODE 31, RMODE any |
Status | Fehlerprogrammstatus zulassen, Taskmodus |
Cross-Memory-Modus | PASN=HASN=SASN (kein Cross Memory) |
Rückkehrcodes | Keine |
Funktion | Bereinigt verschiedene Ressourcen von WebSphere for z/OS und erstellt unter Umständen einen SVC-Speicherauszug für den aktuellen Adressraum. |
Eingaberegister
1 | Enthält die SDWA-Adresse |
14 | Enthält die Rückkehradresse. |
15 | Enthält die Adresse des Eingangspunkts für BBORLEXT. |
Ausgaberegister
Wenn die Steuerung an den Aufrufenden zurückgegeben wird, ist der Inhalt der Register wie folgt:0-1 | Wird vom System als Arbeitsregister verwendet. |
2-14 | Unverändert |
15 | Wird vom System als Arbeitsregister verwendet. |
Anmerkung: Einige Aufrufende setzen voraus, dass der Registerinhalt vor und nach der Ausführung des Service identisch ist. Wenn das System den Inhalt der Register ändert, von denen der Aufrufende abhängig ist, muss der Aufrufende
die Register speichern, bevor er den Service ausführt, und zurückschreiben, nachdem er die Steuerung vom System zurückerhält.
Anmerkung: Es wird kein Speicherauszug für X22-Abend-Codes und für bestimmte Ursachencodes
von den Abend-Codes 0D6, 052, 067, CC3 und DC3 erstellt.
Es sind möglicherweise noch weitere Fehlerbedingungen
vorhanden, für die kein Speicherauszug erstellt wird.
Das folgende Beispiel zeigt, wie diese Routine in Assembler aufgerufen wird:
LA 1,SDWA SDWA@ in Region 1 laden
L 15,(0,16) CVT-Adresse laden
L 15,140(,15) ECVT-Adresse laden
L 15,564(,15) Adresse der z/OS-Struktur laden
L 15,32(,15) Adresse der z/OS-Routine laden
BALR 14,15 z/OS-Routine aufrufen