Syntax
RELEASE [ AS report_name ]Parameters
Release can be abbreviated as REL.
AS report_name
Indicates the report is an outputstream with a different name, outputstream to Release specified by the qualifier. If this option is not present the default outputstream is released.
Description
The Release logic command sends to the printer all Print method calls previously invoked in a report or outputstream.
An automatic release is invoked when the value of the Glb.Stn built-in segment attribute is changed.
For ROC applications, an automatic release is also invoked when the values of the Glb.Device and Glb.PrintHost built-in segment attributes are changed.
Note: The Release logic command is for use in Reports only. The use of this command in Ispecs and Messengers is invalid or is ignored.
ROC Reports
When a Release logic statementis executed, the current report file is closed, and any subsequent output begins with a new page. The Glb.PageCount built-in segment attribute is set to zero after a release.
Depending on whether the report is performing other updates, the report output might not be available to ROC until a CriticalPoint logic statement, Sleep logic statement, or end-of-report occurs.
When the Release logic command is used with the OnChange logic command, the footer frame is not sent to the printer in the current ROC file.
Reports Not Using ROC (MCP environment only)
Glb.PageCount is not set to zero after a release.
An automatic page throw occurs at the start of Report output to a TP or LP device, following a Release command.
The Release command cannot be used in Video Reports.
Example
Determine Actual Event.Invoicing
Frame03.Print()
End
Release
Glb.PageCount := Glb.Zeros
Advance NewPage
Frame05.Print()