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 WAS
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 |
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.
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.
Example:
- Example 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
Related tasks
Reference topic