HP 3000 Manuals HP 3000 Manuals
CONFIGURE
Defines the output environment, such as screen and paper sizes, spacing
information, page breaks, and output destination.
Syntax
CON[FIGURE]
[;S[CREEN-]L[ENGTH] = screen-length]
[;S[CREEN-]W[IDTH] = screen-width]
[;P[AGE-]L[ENGTH] = page-length]
[;P[AGE-]W[IDTH] = page-width]
[;LEFT = left-margin]
[;RIGHT = right-margin]
[;TOP = top-margin]
[;BOT[TOM] = bottom-margin]
[;OUT[PUT] = output-dest]
[;S[INGLE-]S[PACE]]
[;D[OUBLE-]S[PACE]]
[;PAGE ]
.
Parameters
screen-length Number of rows on the terminal.
screen-width Number of columns on the terminal.
page-length Number of rows on a page of paper.
page-width Number of columns on a page of paper.
left-margin Number of spaces in the left margin.
right-margin Number of spaces in the right margin.
top-margin Number of blank lines in the top margin.
bottom-margin Number of blank lines in the bottom margin.
output-dest Destination of dictionary output. If file SDOUT is
already redirected, the current output file is
closed and SDOUT is now redirected to output-dest.
If you enter the command in response to a command
prompt, the file is defined as the output file
until you redefine it or for the duration of the
session (whichever comes first). If the file is
declared in a stored report, it is defined as the
output file for the duration of that stored report
only. After the completion of the command, the
output file reverts to the same file as before the
execution of the stored command.
There are three options for this parameter:
TERMINAL The output appears on the screen (or
to the batch job listing if running
in batch mode)
PRINTER The output is sent to the line
printer (dev=LP)
file-name The output is written to the
specified file. If the file does not
exist, a new file by that name is
created. If the file exists, the new
data is appended to the end of the
file. You can also use file equates
and back-referencing to define this
file, that is, *file1.
Because "TERMINAL" and "PRINTER" are reserved
words, they have special meaning in SDMAIN and
define either the terminal or the printer,
respectively, as the output destination.
Accordingly, output cannot be redirected to a file
with either of these names.
SINGLE-SPACE Specifies single spacing of dictionary output
between items. Information about each item is
always single-spaced after the item name. This is
the default spacing option.
DOUBLE-SPACE Specifies double spacing of dictionary output
between items. Information about each item is
always single-spaced after the item name.
PAGE Specifies placement of each item on a new page.
When the end of an item is encountered, the
remainder of the page is filled with blank lines
and the next item is positioned at the top of the
following page. Information about each item is
always single-spaced after the item name.
Description
Because all parameters are optional, if you do not specify any keywords,
all parameters are reset to their default values (the original parameter
values when the program was initially run). If you specify one or more
keywords, then those parameters you do not specify are not affected.
All numeric values must be in the range 0 .. 32767.
When configuring the right and left margins and screen and paper widths,
there must be at least 53 characters per row of printable space between
the margins to allow for the printing of the statically formatted reports
produced by the DISPLAY commands. This allows 32 characters for names,
along with up to 21 characters for the line headers.
If you use the CONFIGURE command inside a START/SAVE reporting command
pair, you may enter values for all keywords. However, if CONFIGURE is
processed by a Nested EXECUTE command, the OUTPUT and PAGE-LENGTH
keywords are ignored and the values for these fields are carried over
from the previous level.
If you redefine the dictionary environment (for example, switch scopes,
open a new dictionary), it is not necessary to reissue the CONFIGURE
command if this information remains the same for the new dictionary
environment.
You can use the page and screen length and top and bottom margin clauses
to manipulate paging of output. For example, if you do not want output
to page on the terminal (stop at the end of each screen), simply set the
screen length to a large value such as 10,000, (the maximum value is
32767). The output then pauses only after that many lines have scrolled
by on the screen (in this case, 10,000) for a given command.
To send the output to a file (with no page spacing) set the top and
bottom margins to 0. In this case, only the final page of each command
is blank filled so that the next command starts on a new page (determined
by page-length).
To eliminate all spacing (including the blank-fill at the end of the
command), set the top and bottom margins to 0 and the page length to 1.
You can use other combinations to provide the desired output spacing.
Open Mode: Any
Scope: Any
Example
The following example sets the paper page width at 102, the right and
left margins at 12 spaces each, specifies double spacing between items,
and sends the output to the printer.
>CONFIGURE PAGE-WIDTH =102;
>>LEFT = 12;
>>RIGHT = 12;
>>DOUBLE-SPACE;
>>OUTPUT = PRINTER.
>
Example
The following example double spaces all output (every line is double
spaced, not just between items as in example 1) and sends the output to
the printer.
>CONFIGURE PAGE-LENGTH = 2;
>>TOP = 1;
>>BOTTOM = 0;
>>OUTPUT = PRINTER.
>