LINC Programming Reference Manual - Public Support Login - Unisys

PRINT.FRAME (PF)
PRINT.FRAME (PF)
The PRINT.FRAME; command executes the logic of the specified Report Frame (including
any PRINT.FRAME; commands), and then the Frame is output for printing.
The AS; command option indicates that you are printing this Report as a Shadow Report
with a different title.
The AT; command option directs that printing is to start at the line specified (counting from
the top of the page). If headings have printed beyond this line, printing will commence
from the next available line. If the specified line is less than the current line, the Frame is
printed on the next page. If the line specified by the AT; command option is greater than
GLB.FORMDEPTH, the Frame will be printed on a new page on a line calculated by
subtracting the value of GLB.FORMDEPTH until an acceptable value is found.
For example, suppose a Report requesting printing to start at line 53 is directed to Video.
Since GLB.FORMDEPTH is 48, one page is skipped (48 lines) and output starts at line 5.
At the time of the first PRINT.FRAME; to the print file (or a shadow print file) in ROC and
non-ROC Reports, the current value of GLB.STN is captured. On subsequent
PRINT.FRAME; commands to the same print file, the associated captured GLB.STN value
is compared with the then current GLB.STN. If they are different, a RELEASE; command is
invoked before performing the requested print. Similar logic applies for GLB.DEVICE and
GLB.PRINTHOST in ROC Reports.
Multiple blank pages are not printed if the LINC System is using the Report Output Control
System (ROC) for video output (device type of VD).
Notes:
$ In an MCP based LINC System that does not use ROC, a Frame that contains only
logic may print a blank line when accessed by the PRINT.FRAME; command.
Use an END.NO.PRINT; command to prevent a blank line from being printed.
In ROC Reports, a blank line is not printed in this case.
$ ROC files are created with the usercode of the parent LINC System when the value of
GLB.USER is spaces. ROC text files for UNIX LINC Systems are created with the
usercode of the initiator of the Report when GLB.USER is spaces, with read/write
access for all.
$ System Data items associated with Report or Shadow Report output should not be
used if there is no associated PRINT.FRAME; command, as COBOL syntax errors
would result.
$ The values of GLB.STN, GLB.DEVICE, and GLB.PRINTHOST are only relevant at the
time of the actual printing of the Frame. Their values may change any number of
times between PRINT.FRAME; commands, without affecting the printing of the
Report.
1-196 v