![[z/OS]](../images/ngzos.gif)
Error Dump and Cleanup interface
The Error Dump and Cleanup (BBORLEXT) interface exists to call WebSphere® Application Server for z/OS® in a recovery environment to allow it to request a dump and to clean up its resources.
The interface will:
- Save the function and DLL names of the failing z/OS component into the SDWA.
- Determine whether or not to issue an SDUMP, if relevant to the time-of-failure environment.
- Clean up z/OS internal structures and connections.
Program requirements: This interface must be called from within a WebSphere Application Server for z/OS location service daemon, controller (region), or servant (region). There are no restrictions against in which recovery environment, such as an ESTAE or FRR routine, the caller must reside.
General information
Interface | BALR to BBORLEXT |
Address of routine | (ECVT+'234'x)+'20'x |
Address mode | AMODE 31, RMODE any |
State | Allow problem program state, task mode |
Cross memory mode | PASN=HASN=SASN (non-cross memory) |
Return codes | No return codes |
Function | Clean-up various WebSphere for z/OS resources and possibly issue an SVC dump for the current address space |
Input register information
1 | Contains the address of the SDWA |
14 | Contains the return address |
15 | Contains the entry point address of BBORLEXT |
Output register information
When control returns to the caller, the contents of the registers are as follows:0-1 | Used as a work register by the system |
2-14 | Unchanged |
15 | Used as a work register by the system |
Note: Some callers depend on register contents remaining
the same before and after issuing a service. If the system changes
the contents of registers on which the caller depends, the caller
must save them before issuing the service and restore them after the
system returns control.
Note: A dump will not occur for X22 abends
or for certain reason codes from 0D6, 052, 067, CC3, and DC3 abends.
There may also be other error conditions that will not create a dump.
Here is an example of how to call this routine in assembler:
LA 1,SDWA Load SDWA@ in Reg 1
L 15,(0,16) Load CVT address
L 15,140(,15) Load ECVT address
L 15,564(,15) Load address of z/OS structure
L 15,32(,15) Load address of z/OS routine
BALR 14,15 Invoke z/OS routine