BREAK.ON |
![]() ![]() ![]() |
The BREAK.ON field qualifier keyword causes the query processor to display the named field, generating a breakpoint whenever the field value changes.
Format
BREAK.ON { "options" } field
where
The BREAK.ON keyword appears before the field name and causes the query processor to generate a breakpoint whenever the field value changes. The field is also printed as part of the report. 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 text will be used in place of the default two asterisks when a breakpoint occurs. This text may also contain control codes enclosed in single quotes. The available control codes are:
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.ON appears after the field rather than before.
Examples
The command
LIST SALES BY REGION BREAK.ON REGION SALESMAN TOTAL ORDER.VALUE
might produce a display such as that below.
LIST SALES BY REGION BREAK.ON REGION SALESMAN TOTAL ORDER.VALUE Page 1 SALES..... REGION SALESMAN ORDER VALUE 19887 North Roberts 279.40 19859 North Sharp 384.43 19858 North Sharp 845.50 19845 North Harris 234.53 ** ----------- North 1743.86
19866 South Abbott 465.31 19886 South Abbott 397.23 19830 South Smith 324.39 ** ----------- South 1186.93
=========== 2930.79
7 records listed.
For this same data, the command
LIST SALES BY REGION BREAK.ON "Total'O'" REGION SALESMAN TOTAL ORDER.VALUE
would produce
LIST SALES BY REGION BREAK.ON "Total"O"" REGION SALESMAN TOTAL ORDER.V Page 1 SALES..... REGION SALESMAN ORDER VALUE 19887 North Roberts 279.40 19859 Sharp 384.43 19858 Sharp 845.50 19845 Harris 234.53 Total ----------- North 1743.86
19866 Abbott 465.31 19886 Abbott 397.23 19830 Smith 324.39 Total ----------- South 1186.93
=========== 2930.79
7 records listed.
See also: |