The LINAGE clause specifies the depth of a logical page in terms of number of lines. Optionally, it also specifies the line number at which the footing area begins, as well as the top and bottom margins of the logical page. (The logical page and the physical page cannot be the same size.)
All integers must be unsigned. All data-names must be described as unsigned integer data items.
___________________________________________________________________ |) A A | |) LINES AT TOP integer-10 (top margin) | | |) V | | |___________________________________________________________|_______| | A | | | | | | | | logical | | page body page depth | | | | | | | | | | | | | | WITH FOOTING integer-9 ____________________|_____________|_______| | A | | | | footing area | | | | V V | | | LINAGE integer-8 ________________________________________|_______| |) A | | |) LINES AT BOTTOM integer-11 (bottom|margin) | | |) V V | |___________________________________________________________________|
Figure 5. LINAGE Clause Phrases
The logical page size specified in the LINAGE clause is the sum of all values specified in each phrase except the FOOTING phrase. If the LINES AT TOP and/or the LINES AT BOTTOM phrase is omitted, the assumed value for top and bottom margins is zero. Each logical page immediately follows the preceding logical page, with no additional spacing provided.
If the FOOTING phrase is omitted, its assumed value is equal to that of the page body (integer-8 or data-name-5).
At the time an OPEN OUTPUT statement is executed, the values of integer-8, integer-9, integer-10, and integer-11, if specified, are used to determine the page body, first footing line, top margin, and bottom margin of the logical page for this file. See Figure 5 above. These values are then used for all logical pages printed for this file during a given execution of the program.
At the time an OPEN statement with the OUTPUT phrase is executed for the file, data-name-5, data-name-6, data-name-7, and data-name-8 determine the page body, first footing line, top margin, and bottom margin for the first logical page only.
At the time a WRITE statement with the ADVANCING PAGE phrase is executed or a page overflow condition occurs, the values of data-name-5, data-name-6, data-name-7, and data-name-8 if specified, are used to determine the page body, first footing line, top margin, and bottom margin for the next logical page.
If an external file connector is associated with this file description entry, all file description entries in the run unit that are associated with this file connector must have:
Adobe, the Adobe logo, Acrobat, the Acrobat logo, and Acrobat Reader are registered trademarks of Adobe Systems incorporated.