Properties and resources reset by control functions

When the control functions are utilized by a caller (the GXL1CTL (GXL4CTL) API is invoked), some of the z/OS XML parser properties and resources are reset while others are not. The properties and resources reset and by which control functions are shown in the following table. Properties and resources not reset by a particular control function may need to be explicitly restored by a PAB copy.

Table 1. z/OS XML parser properties and resources reset by control functions
Properties and resources	Control functions that reset
Loaded OSRs, XML fragment contexts, and allowable root names	None
The following control and initialization settings (listed by features) XEC_FEAT_STRIP_COMMENTS, XEC_FEAT_TOKENIZE_WHITESPACE , XEC_FEAT_CDATA_AS_CHARDATA, XEC_FEAT_SOURCE_OFFSETS, XEC_FEAT_FULL_END	XEC_CTL_FIN
Entity resources	XEC_CTL_FIN
The following system level resources: recovery status, JST owns storage, z/OS XML System Services exit routines	None
Parser types (validating and nonvalidating)	None
Fragment mode	XEC_CTL_FIN. XEC_CTL_FEAT, XEC_CTL_LOAD_OSR, XEC_CTL_ENTS_AND_REFS, XEC_CTL_ERROR_HANDLING
Start of the XML document	XEC_CTL_FIN. XEC_CTL_FEAT, XEC_CTL_LOAD_OSR, XEC_CTL_ENTS_AND_REFS, XEC_CTL_ERROR_HANDLING
Error state	XEC_CTL_FIN. XEC_CTL_FEAT, XEC_CTL_LOAD_OSR, XEC_CTL_ENTS_AND_REFS, XEC_CTL_ERROR_HANDLING, XEC_ CTL_QUERY_MIN_OUTBUF (only when RC=8, RSN= XRSN_BUFFER_OUTBUF_SMALL)