ARR recovery routine

z/OS XML provides an ARR recovery routine to assist with problem determination and diagnostics. This recovery routine can be turned on through an initialization option when invoked through the assembler API. For callers of the C/C++ parser API (gxlpParse), when running in Language Environment®, the ARR recovery routine is provided by default in most cases. For C or C++ callers who are running in either SRB mode or under an existing FRR routine, the z/OS® XML ARR will not be provided, as it would not work properly in those environments.

If the z/OS XML parser abends, the z/OS XML ARR routine will get control and will collect dumps and return to the caller with a XRC_FATAL return code. For unauthorized callers, an IEATDUMP will be taken in data set userid.GXLSCXML.DYYMMDD.THHMMSS.DUMP, where DYYMMDD is the date and THHMMSS is the time the dump was taken. The task level ACEE is used to obtain the userid. If there is no task level ACEE, the address space level ACEE is used. If there is no address space level ACEE, a dump is not taken. For authorized callers, an SDUMPX will be taken into a system dump data set.

If the user would like to continue parsing, he must terminate and re-initialize a PIMA following any abend in the z/OS XML parser.