![[z/OS]](../images/ngzos.gif)
Interface de nettoyage et de vidage des erreurs
L'interface de nettoyage et de vidage des erreurs (BBORLEXT) sert à appeler WebSphere Application Server for z/OS dans un environnement de récupération afin de lui permettre de vider et de nettoyer ses ressources.
L'interface :
- Sauvegardera les noms de la fonction et de la bibliothèque de liaison dynamique du composant z/OS dans la zone de travail SDWA.
- déterminera s'il est cohérent avec l'environnement d'heure d'échec d'émettre un SDUMP.
- Nettoiera les structures et les connexions internes z/OS.
Exigences du programme : Cette interface doit être appelée à partir d'un démon de service de localisation, un contrôleur (région) ou un serviteur (région) de WebSphere Application Server for z/OS. Il n'y a aucune restriction quant à l'environnement de récupération, tel qu'un ESTAE ou une routine FRR, dans lequel doit résider le demandeur.
Informations générales
Interface | BALR à BBORLEXT |
Adresse de la routine | (ECVT+'234'x)+'20'x |
Mode d'adressage | AMODE 31, tout RMODE |
Etat | Autoriser l'état de programme défectueux et le mode tâche |
Mode intermémoire | PASN=HASN=SASN (pas intermémoire) |
Codes retour | Pas de code retour |
Fonction | Nettoie les nombreuses ressources de WebSphere for z/OS et peut émettre un vidage SVC pour l'espace adresse actuel. |
Informations du registre d'entrée
1 | Contient l'adresse de la zone de travail SDWA |
14 | Contient l'adresse de retour |
15 | Contient l'adresse du point d'entrée de BBORLEXT |
Informations du registre de sortie
Lorsque le contrôle revient au demandeur, les contenus des registres sont les suivants :0-1 | Utilisé comme registre des travaux par le système |
2-14 | Inchangé |
15 | Utilisé comme registre des travaux par le système |
Remarque : Certains demandeurs dépendent des contenus du registre qui restent identiques avant et après l'émission d'un service. Si le système modifie les contenus des registres desquels dépend le demandeur, celui-ci doit les sauvegarder avant l'émission du service et les restaurer après le retour du contrôle du système.
Remarque : Il n'y aura pas de vidage pour les interruptions anormales X22 et DC3 ni pour certains codes anomalie à partir de 0D6, 052, 067, CC3.
Il peut également y avoir des conditions d'erreur qui ne créeront aucun vidage.
Voici un exemple d'appel de cette routine dans l'assembleur :
LA 1,SDWA Chargez la zone de travail SDWA@ dans le Reg 1
L 15,(0,16) Chargez l'adresse CVT
L 15,140(,15) Chargez l'adresse ECVT
L 15,564(,15) Chargez l'adresse de structure z/OS
L 15,32(,15) Chargez l'adresse de routine z/OS
BALR 14,15 Appelez la routine z/OS