![[z/OS]](../images/ngzos.gif)
Interfaz de volcado de errores y limpieza
La interfaz de volcado de errores y limpieza (BBORLEXT) existe para llamar a WebSphere Application Server para z/OS en un entorno de recuperación de modo que pueda solicitar un volcado y limpiar los recursos.
La interfaz realizará las siguientes acciones:
- Guardar los nombres de función y DLL del componente de z/OS anómalo en SDWA.
- Determinar si se va a emitir un SDUMP, si es relevante para el entorno del momento de la anomalía.
- Limpiar las conexiones y estructuras internas de z/OS.
Requisitos del programa: esta interfaz debe llamarse desde dentro de un controlador (región), un sirviente (región) o un daemon de servicio de ubicación de WebSphere Application Server para z/OS. No hay restricciones en cuanto a al entorno de recuperación, como por ejemplo una rutina de STAE o FRR, en el que debe residir el emisor.
Información general
Interfaz | BALR a BBORLEXT |
Dirección de la rutina | (ECVT+'234'x)+'20'x |
Modalidad de direccionamiento | AMODE 31, RMODE cualquiera |
Estado | Permitir estado de programa de problema, modalidad de tareas |
Modalidad entre memorias | PASN=HASN=SASN (no entre memorias) |
Códigos de retorno | No hay códigos de retorno |
Función | Limpieza de varios recursos de WebSphere para z/OS y posiblemente la emisión de un volcado de SVC para el espacio de direcciones actual |
Información de registros de entrada
1 | Contiene la dirección de SDWA |
14 | Contiene la dirección de retorno |
15 | Contiene la dirección de punto de estrada de BBORLEXT |
Información de registros de salida
Cuando el control vuelve a emisor, el contenido de los registros es el siguiente:0-1 | Utilizado por el sistema como un registro de trabajo |
2-14 | Sin modificar |
15 | Utilizado por el sistema como un registro de trabajo |
Nota: Algunos emisores dependen de que el contenido de los
registros permanezcan invariables antes y después de emitir un servicio. Si el sistema cambia el contenido de registros de los que dependen los
usuarios, el emisor debe guardarlos antes de emitir el servicio y
restaurarlos después de que el sistema devuelva el control.
Nota: No se producirá un volcado para las terminaciones
anormales X22 o para ciertos códigos de razón de terminaciones anormales
0D6, 052, 067, CC3 y DC3.
Asimismo, pueden producirse otras condiciones de
error que impedirán la creación de un volcado.
El siguiente ejemplo muestra cómo llamar esta rutina en el ensamblador:
LA 1,SDWA Cargar SDWA@ en Reg 1
L 15,(0,16) Cargar la dirección de CVT
L 15,140(,15) Cargar la dirección de ECVT
L 15,564(,15) Cargar la dirección de la estructura de z/OS
L 15,32(,15) Cargar la dirección de la rutina de z/OS
BALR 14,15 Invocar la rutina de z/OS