Writing data back to the disk file

The SAVE function is used to write (save) modified window pages back to the disk file.

A file area for which the SAVE function is to be executed is specified, and all modified window pages of this area are written back to the disk file. In the process, the file length can be logically extended or reduced. (The file can be physically extended only by using the MAP function, see the “Introductory Guide to DMS” [1]). The new file length is returned by the SAVE function in a field (DIVPSIZE) of the parameter list.

List of the most important macro operands for writing back to the disk file

Operand	Operand values	Meaning
FCT	*SAVE	Writes data back to the disk file
OFFSET SPAN		The OFFSET and SPAN operands define the file area for which the SAVE function is to be executed (i.e. the beginning of the area and its length in 4KB blocks. The file length can be logically extended or reduced. The new file length is returned by SAVE. Physical extensions of the file length are only possible with MAP; see extending of a file physically as described in the “Introductory Guide to DMS” [1].