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.
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
Diagnosing problems (using diagnosis tools)
Related reference
Choosing diagnostic information sources
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 3:08:41 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-zos&topic=rtrbbborlext
File name: rtrb_bborlext.html