FPASCAN
The FPASCAN statement sends an FPASCAN DML to the DBH which defines the start page for the free place search. The start page is specified in the SDF statement SET-FPA-SCAN-PARAMETERS (see section “Defining the search mode for the free place search (SET-FPA-SCAN-PARAMETERS)”).
If SEARCH- MODE=*REUSE is specified in SET-FPA-SCAN-PARAMETERS, free space is searched for from the beginning of the realm (search mode “Second Scan”).
When SEARCH-MODE=*NOREUSE, required storage space is searched for in the contiguous free area at the end of the realm and PLACEMENT OPTIMIZATION is taken into account (search mode “First Scan”). The change in the search for space becomes effective immediately with *REUSE and is initially noted in the case of *NOREUSE and becomes effective when the next checkpoint is reached. These actions are not canceled by a subsequent explicit and internal FINISH WITH CANCEL. WITH CANCEL is then ignored.
The DML returns a status code which is available in the predefined RCODE variable (see section “Predefined variables”).