<snip> As this function can never return partial pages, it will always be zero upon
first use. </snip> To be picky, the "As" phrase of this is not quite true. IARV64 does not, but could return a partial page, such as a partial 2G page for a smaller request when the conditions were right (but the implementation does not do that). The conclusion is, similarly, not quite true. It does happen always to be zero. A different (likely felt to be insecure) implementation that did not clear pages upon new usage when those pages had been used, but are no longer in use, would not guarantee "always be zero". In any case, that's why we agree that it would be nice to document. Peter Relson z/OS Core Technology Design