%H - Hardcopy Output

%H  

destination
#destination
=[destination]
-

These terminal commands are used to produce hardcopy output from Natural reports on a printer or special destination, such as the source area.

By default, a %H command is effective for the current logical output (that is, the current window without message line, function-key lines and statistics line/infoline).

You have the following options:

Command Function
%H

This command activates the hardcopy output. The hardcopy output is deactivated when either an INPUT statement with modifiable fields is executed, or the end of the program is reached. All pages, which are processed when the hardcopy output is active, will be forwarded to the printing destination. These pages are not displayed on the screen.

If %H is entered in an input field, only the current page will be printed.

For the definition of the output destination, a window is displayed listing all available printers and special destinations (e.g. SOURCE). From this list, you select the destination on which the hardcopy is to be printed.

%Hdestination Same as %H, but the printing destination is specified with destination. The destination can be 1 to 8 characters long.
%H!

With SET CONTROL 'H!', the current page (that is, the page which was output before the SET CONTROL statement was executed) is printed. With %H!, the page which is currently displayed on the screen, is printed.

For the definition of the output destination, a window is displayed listing all available printers and special destinations (e.g. SOURCE). From this list, you select the destination on which the hardcopy is to be printed.

%H!destination Same as %H!, but the printing destination is specified with destination. The destination can be 1 to 8 characters long.
%H=

This command activates/deactivates (toggle switch) the logging of all following pages. Logging means that all pages, which are displayed on the screen are forwarded to the printing destination as well. This feature may be used, for example, to log a sequence of output for administrative, debugging or educational purposes.

For the definition of the output destination, a window is displayed listing all available printers and special destinations (e.g. SOURCE). From this list you select the destination on which the hardcopy is to be printed.

%H=destination Same as %H=, but the printing destination is specified with destination. The destination can be 1 to 8 characters long.
%H#destination

Same as %Hdestination.

%H- Deactivates the hardcopy output immediately.

Note:
When a SET CONTROL 'H-' statement is executed, data which were already written to the page buffer but have not been output yet, will not be routed to the printer. To also print these data, you have to code an EJECT statement before the SET CONTROL 'H-' statement.

Note:
The EJECT statement does not affect the %H command. The %H command always causes Natural to advance pages.