Chapter Contents
Previous
Next
The REPORT Procedure

RBREAK Statement

Produces a default summary at the beginning or end of a report or at the beginning and end of each BY group.

Featured in: Selecting Variables for a Report and Calculating Percentages

RBREAK location </ option(s)>;

To do this Use this option
Specify the color of the break lines in the REPORT window COLOR=
Double overline each value DOL
Double underline each value DUL
Overline each value OL
Start a new page after the last break line of a break located at the beginning of the report PAGE
Write a blank line for the last break line of a break located at the beginning of the report SKIP
Specify a style element (for the Output Delivery System) for default summary lines, customized summary lines, or both STYLE=
Include a summary line as one of the break lines SUMMARIZE
Underline each value UL

Required Arguments

location
controls the placement of the break lines and is either of the following:

AFTER
places the break lines at the end of the report.

BEFORE
places the break lines at the beginning of the report.

Options

COLOR=color
specifies the color of the break lines in the REPORT window. You can use the following colors:

BLACK MAGENTA
BLUE ORANGE
BROWN PINK
CYAN RED
GRAY WHITE
GREEN YELLOW

Default: The color of Foreground in the SASCOLOR window. (For more information, see the online Help for the SASCOLOR window.)
Restriction: This option has no effect on the HTML or Printer output.

Note:   Not all operating environments and devices support all colors, and in some operating environments and devices, one color may map to another color. For example, if the DEFINITION window displays the word BROWN in yellow characters, selecting BROWN results in a yellow item.  [cautionend]

DOL
(for double overlining) uses the thirteenth formatting character to overline each value

Default: equals sign (=)
Restriction: This option has no effect on the HTML or Printer output.
Interaction: If you specify both the OL and DOL options, PROC REPORT honors only OL.
See also: the discussion of FORMCHAR= .
Featured in: Selecting Variables for a Report

DUL
(for double underlining) uses the thirteenth formatting character to underline each value

Default: equals sign (=)
Restriction: This option has no effect on the HTML or Printer output.
Interaction: If you specify both the UL and DUL options, PROC REPORT honors only UL.
See also: the discussion of FORMCHAR= .

OL
(for overlining) uses the second formatting character to overline each value

Default: hyphen (-)
Restriction: This option has no effect on the HTML or Printer output.
Interaction: If you specify both the OL and DOL options, PROC REPORT honors only OL.
See also: the discussion of FORMCHAR= .
Featured in: Calculating Percentages

PAGE
starts a new page after the last break line of a break located at the beginning of the report.

SKIP
writes a blank line after the last break line of a break located at the beginning of the report.
Restriction: This option has no effect on the HTML or Printer output.

STYLE=<style-element-name><[style-attribute-specification(s)]>
specifies the style element to use for default summary lines that are created with the RBREAK statement. You can alter the default style element of the summary lines or specify another style element entirely.

Note:   You can use braces ({ and }) instead of square brackets ([ and ]).  [cautionend]

style-element-name
is the name of a style element that is part of a style definition that is registered with the Output Delivery System. SAS Institute provides some style definitions. Users can create their own style definitions and style elements with PROC TEMPLATE.
Default: If you do not specify a style element, PROC REPORT uses DataEmphasis.
See also: For information about Institute-supplied style definitions, see What Style Definitions Are Shipped with the Software? .

For information about PROC TEMPLATE and the Output Delivery System, see The Complete Guide to the SAS Output Delivery System.

style-attribute-specification
describes one or more style attributes to change. Each style-attribute-specification has this general form:
style-attribute-name=style-attribute-value

You can set these style attributes:

ASIS= FONT_WIDTH=
BACKGROUND= HREFTARGET=
BACKGROUNDIMAGE= HTMLCLASS=
BORDERCOLOR= JUST=
BORDERCOLORDARK= NOBREAKSPACE=
BORDERCOLORLIGHT= POSTHTML=
BORDERWIDTH= POSTIMAGE=
CELLHEIGHT= POSTTEXT=
CELLWIDTH= PREHTML=
FLYOVER= PREIMAGE=
FONT= PRETEXT=
FONT_FACE= PROTECTSPECIALCHARS=
FONT_SIZE= TAGATTR=
FONT_STYLE= URL=
FONT_WEIGHT= VJUST=

For information about style attributes, see What Style Attributes Can Base Procedures Specify? .

Restriction: This option affects only the HTML and Printer output.

SUMMARIZE
includes a summary line as one of the break lines. A summary line at the beginning or end of a report contains values for

The following table shows how PROC REPORT calculates the value for each kind of report item in a summary line created by the RBREAK statement:

If the report item is ... Then its value is ...
a statistic the value of the statistic over all observations in the set
an analysis variable the value of the statistic specified as the usage option in the DEFINE statement. PROC REPORT calculates the value of the statistic over all observations in the set. The default usage is SUM.
a computed variable the results of the calculations based on the code in the corresponding compute block (see COMPUTE Statement ).

Featured in: Selecting Variables for a Report and Calculating Percentages

UL
(for underlining) uses the second formatting character to underline each value

Default: hyphen (-)
Restriction: This option has no effect on the HTML or Printer output.
Interaction: If you specify both the UL and DUL options, PROC REPORT honors only UL.
See also: the discussion of FORMCHAR= .

Order of Break Lines
When a default summary contains more than one break line, the order in which the break lines appear is

  1. overlining or double overlining (OL or DOL)

  2. summary line (SUMMARIZE)

  3. underlining or double underlining (UL or DUL)

  4. skipped line (SKIP)

  5. page break (PAGE).

Note:   If you define a customized summary for the break, customized break lines appear after underlining or double underlining. For more information about customized break lines, see COMPUTE Statement and LINE Statement .  [cautionend]


Chapter Contents
Previous
Next
Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.