Recovery considerations

z/OS XML provides an ARR recovery routine. This recovery routine can be turned on through an initialization option when invoked through the assembler API. For callers of the C/C++ parse API (gxlpParse), when running in Language Environment®, the ARR recovery routine is provided by default in most cases. For more information on the ARR recovery routine, see ARR recovery routine.

Recovery can also be supplied by the caller. Callers who want to clean up z/OS XML parser resources should invoke GXL1TRM (GXL4TRM), the parser termination service, either when the parse completes or if an unexpected error occurs during the parse. The termination service will cause all secondary storage to be freed. It is up to the caller to free the PIMA storage (see Managing memory resources for more information).