The REPHEADER command defines a report header. Report headers print on the first page of a report, after the page title and before the first detail line. See Chapter 3 for more information.
REPH[EADER] [OFF|ON]|
[COL x|
S[KIP] x|
TAB x|
LE[FT]|
CE[NTER]|
R[IGHT]|
BOLD|
FOR[MAT] format_spec|
text|
variable...]where:
- REPH[EADER]
May be abbreviated REPH. Issuing the REPHEADER command with no parameters causes SQL*Plus to display the current report header setting.
- OFF
Turns the report header off, but does not erase its definition. You can turn it back on again with ON.
- ON
Turns on printing of report headers.
- COL x
Causes any header text following this parameter to print at the specified column position.
- S[KIP] x
May be abbreviated to S, and inserts the specified number of line breaks before printing any subsequent footer text.
- TAB x
TAB is similar to COL, but moves you the specified number of columns relative to the current position. Negative numbers move you backwards. TAB has nothing whatsoever to do with tab characters.
- LE[FT]
May be abbreviated LE, and causes subsequent footer text to be printed beginning at the leftmost column of the current footer line.
- CE[NTER]
May be abbreviated CE, and causes subsequent header text to be centered within the current line. The LINESIZE setting controls the line width.
- R[IGHT]
May be abbreviated R, and causes subsequent header text to be printed flush right. The LINESIZE setting controls where SQL*Plus thinks the right end of the line is.
- BOLD
Makes a footer “bold” by printing it three times. Only text following the BOLD command is repeated on each line. There is not a NOBOLD parameter.
- FOR[MAT]
May be abbreviated to FOR, and allows you to control how subsequent numeric data in the header is displayed.
- format_spec
Is a string that specifies the display format to use for subsequent numeric data in the header. The format elements you can use here are the same as for the COLUMN command, and are described in Appendix B. It is possible to specify a character format, such as A20, but that has no effect on subsequent character strings.
- text
Is any text you want to have in the header. To be safe, you should enclose this in quotes, but you don’t have to as long as your title text doesn’t include any keywords like BOLD or TAB that have meaning to REPHEADER. Either single or double quotes may be used. If you need to include a quote as part of your text, use two quote characters back to back.
- variable
May be one of the variables shown in Table 1.1, which is shown under the BTITLE command.