FORMAT subcommand (REPORT command)

FORMAT controls the overall width and length of the report and vertical spacing. Keywords and their arguments can be specified in any order.

  • MANUAL and AUTOMATIC are alternatives. The default is MANUAL.
  • LIST and NOLIST are alternatives. The default is NOLIST.

MANUAL. Default settings for manual format. MANUAL displays values for break variables, right-justifies numeric values and their column headings, left-justifies value labels and string values and their column headings, top-aligns and does not underscore column headings, extends column widths to accommodate the variable’s longest value label (but not the longest word in the variable label) up to a width of 20, and generates an error message when a report is too wide for its margins. MANUAL is the default.

AUTOMATIC. Default settings for automatic format. AUTOMATIC displays labels for break variables, centers all data, centers column headings but left-justifies column headings if value labels or string values exceed the width of the longest word in the heading, bottom-aligns and underscores column headings, extends column widths to accommodate the longest word in a variable label or the variable’s longest value label, and shrinks a report that is too wide for its margins.

LIST(n). Individual case listing. The values of all variables named on VARIABLES are displayed for each case. The optional n inserts a blank line after each n cases. By default, no blank lines are inserted. Values for cases are listed using the default formats for the variables.

NOLIST. No case listing. This is the default.

PAGE(n). Page number for the first page of the report. The default is 1.

LENGTH(t,b) . Top and bottom line numbers of the report. You can specify any numbers to define the report page length. By default, the top of the report begins at line 1, and the bottom of the report is the last line of the system page. You can use an asterisk for t or b to indicate a default value. If the specified length does not allow even one complete line of information to be displayed, REPORT extends the length specification and displays a warning.

MARGINS(l,r) . Columns for the left and right margins. The right column cannot exceed 255. By default, the left margin is display column 1 and the right margin is the rightmost display column of the system page. You can use an asterisk for l or r to indicate a default value.

ALIGN. Placement of the report relative to its margins. LEFT, CENTER, or RIGHT can be specified in the parentheses following the keyword. LEFT left-justifies the report. CENTER centers the report between its margins. RIGHT right-justifies the report. The default is LEFT.

COLSPACE(n) . Number of spaces between each column. The default is 4 or the average number of spaces that will fit within report margins, whichever is less. When AUTOMATIC is in effect, REPORT overrides the specified column spacing if necessary to fit the report between its margins.

CHALIGN. Alignment of column headings. Either TOP or BOTTOM can be specified in the parentheses following the keyword. TOP aligns all column headings with the first, or top, line of multiple-line headings. BOTTOM aligns headings with the last, or bottom, line of multiple-line headings. When AUTOMATIC is in effect, the default is BOTTOM; when MANUAL is in effect, the default is TOP.

UNDERSCORE . Underscores for column headings. Either ON or OFF can be specified in the parentheses following the keyword. ON underscores the bottom line of each column heading for the full width of the column. OFF does not underscore column headings. The default is ON when AUTOMATIC is in effect and OFF when MANUAL is in effect.

TSPACE(n). Number of blank lines between the report title and the column heads. The default is 1.

CHDSPACE(n) . Number of blank lines beneath the longest column head. The default is 1.

BRKSPACE(n) . Number of blank lines between the break head and the next line. The next line is a case if LIST is in effect or the first summary line if NOLIST is in effect. BRKSPACE(–1) places the first summary statistic or the first case listing on the same line as the break value. When a summary line is placed on the same line as the break value, the summary title is suppressed. When AUTOMATIC is in effect, the default is −1; when MANUAL is in effect, it is 1.

SUMSPACE(n) . Number of blank lines between the last summary line at the lower break level and the first summary line at the higher break level when they break simultaneously. SUMSPACE also controls spacing between the last listed case and the first summary line if LIST is in effect. The default is 1.

FTSPACE(n) . Minimum number of blank lines between the last listing on the page and the footnote. The default is 1.

MISSING ‘s’ . Missing-value symbol. The symbol can be only one character and represents both system- and user-missing values. The default is a period.

ONEBREAKCOLUMN. Display subgroups defined on multiple BREAK subcommands in a single column. You can specify OFF or ON in parentheses after the keyword. The default is OFF. When ONEBREAKCOLUMN is ON, it applies to all BREAK subcommands. See the topic BREAK subcommand (REPORT command) for more information.

INDENT(n). Indention of break values and summary titles of each successive subgroup defined by one BREAK subcommand in a single break column. INDENT is effective only when ONEBREAKCOLUMN is on. Multiple variables specified on one BREAK subcommand are indented as a block. The default specification is 2. When ONEBREAKCOLUMN is OFF, specification on INDENT is ignored.

CHWRAP. Automatically wrap user-specified column heads. You can specify OFF or ON in parentheses after the keyword. The default is OFF. When CHWRAP is ON, user-specified heads for either break or variable columns are wrapped. If multiple lines are specified for a head, each line is wrapped, if necessary, independent of other lines. To prevent wrapping at blanks, use the underscore character (_) to signify a hard blank in your head specification. The underscore serves as a hard blank only in user-specified heads and only when CHWRAP is ON. The underscore does not appear in the printed heading.

PREVIEW. Display the first page of output only. You can specify OFF or ON either in parentheses or with one blank space separating the specification from the keyword. The default is OFF. When PREVIEW is ON, the program stops processing after the first page for you to quickly check the format of your report.