Glb.FormDepth

Glb.FormDepth is a read-writable built-in segment attribute that is set to the number of printable lines of report output on a page.

The Glb.FormDepth value is used to determine when to advance to top-of-form (and print footings and headings). For reports that use ROC, when Glb.FormDepth is zero, no automatic advance to top-of-form occurs, and no headings are printed.

 Caution

Glb.FormDepth should not be set to a value greater than the page size, or errors may occur.

Note: In the Windows Runtime application, you can override the default FormDepth value using the Admin Tool.

Once output from a report has been produced, the Glb.FormDepth value remains until the next Release logic statement (or end-of-job), when the most recent change to its value is effected.

The default values are set when the report is initiated. If the Glb.Device built-in segment attribute is changed, Glb.FormDepth might also need to be changed. Default values for each device type are listed in the following table.

Device Type

Default Form Depth: Windows

Default Form Depth: MCP

LP

60 lines

60 lines

RP

-

60 lines

TP

66 lines

66 lines

VD (not IBM 3270)

48 lines

48 lines

VD (IBM 3270)

-

22 lines

spaces

60 lines

60 lines

For DEPCON reports, there is an issue with auto-pagination when using Glb.FormDepth. The following recommendations should be followed to avoid any problems:

The FormDepth built-in outputstream attribute is used for outputstreams similarly to how Glb.FormDepth is used for reports.

Properties

Length = 4

Primitive = Number