BREAK.SUP |
![]() ![]() ![]() |
The BREAK.SUP field qualifier keyword causes the query processor to generate a breakpoint whenever the field value changes. The field is not displayed in the report.
Format
BREAK.SUP { "options" } field
where
The BREAK.SUP keyword appears before the field name and causes the query processor to generate a breakpoint whenever the field value changes. Queries using breakpoints should also sort on the breakpoint field(s).
The action taken at the breakpoint depends on the optional options component and whether any field value accumulations (AVERAGE, CALC, MAX, MIN, PERCENTAGE or TOTAL) are in use.
A breakpoint with no options and no field accumulations prints a line with two asterisks in the column for the field causing the breakpoint followed by a blank line. If field accumulations are present, subtotals are also printed for each accumulated column. A line of hyphens may appear above the subtotals depending on the use of the U breakpoint control code.
The options item is as for BREAK.ON though the text will never appear and only some control options are of use with BREAK.SUP. The useful control codes are:
D Omit the subtotal line if there is only one line of detail for this breakpoint. L Emit a blank line in place of the breakpoint. Any text in the options string will be ignored. P Start a new page.
Combinations of control codes may be used together.
Pick Syntax
If the PICK.BREAKPOINT mode of the OPTION command is in effect, the options element of the BREAK.SUP appears after the field rather than before.
Examples
The command
LIST SALES BY REGION BREAK.SUP REGION SALESMAN TOTAL ORDER.VALUE
might produce a display such as that below.
LIST SALES BY REGION BREAK.SUP REGION SALESMAN TOTAL ORDER.VALUE Page 1 SALES..... SALESMAN ORDER VALUE 19887 Roberts 279.40 19859 Sharp 384.43 19858 Sharp 845.50 19845 Harris 234.53 ----------- 1743.86
19866 Abbott 465.31 19886 Abbott 397.23 19830 Smith 324.39 ----------- 1186.93
=========== 2930.79
7 records listed.
For this same data, the command
LIST SALES BY REGION BREAK.SUP "'B'" REGION SALESMAN TOTAL ORDER.VALUE HEADING "SALES FOR REGION: 'B'"
would produce
SALES FOR REGION: North SALES..... SALESMAN ORDER VALUE 19887 Roberts 279.40 19859 Sharp 384.43 19858 Sharp 845.50 19845 Harris 234.53 ----------- 1743.86 <<page>> SALES FOR REGION: South SALES..... SALESMAN ORDER VALUE 19866 Abbott 465.31 19886 Abbott 397.23 19830 Smith 324.39 ----------- 1186.93
=========== 2930.79
7 records listed.
See also: |