Use the TTITLE command to define page titles for a report. Chapter 3 discusses TTITLE, and has several examples. Also see the BTITLE command. TTITLE and BTITLE work the same way.
TTI[TLE] [OFF|ON]|
[COL x|
S[KIP] x|
TAB x|
LE[FT]|
CE[NTER]|
R[IGHT]|
BOLD|
FOR[MAT] format_spec|
text|
variable...]where:
- TTI[TLE]
May be abbreviated TTI. Issuing the TTITLE command with no parameters causes SQL*Plus to display the current top title setting.
- OFF
Turns the page title off, but does not erase its definition. You can turn it back on again with ON.
- ON
Turns on printing of page titles. The default title, if you do not specify another, will be the current date, the page number, and all or part of the SELECT statement.
- COL x
Causes any title 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 title 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 title text to be printed beginning at the leftmost column of the current title line.
- CE[NTER]
May be abbreviated CE, and causes subsequent title text to be centered within the current line. The LINESIZE setting controls the line width.
- R[IGHT]
May be abbreviated R, and causes subsequent title text to be printed flush right. The LINESIZE setting controls where SQL*Plus thinks the right end of the line is.
- BOLD
Makes your title “bold” by printing it three times. Only title text following the BOLD command is repeated on each line. There is no NOBOLD parameter.
- FOR[MAT]
May be abbreviated to FOR, and allows you to control how subsequent numeric data in the title is displayed.
- format_spec
Is a string that specifies the display format to use for subsequent numeric data in the title. 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 title. 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 TTITLE. 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 system variables maintained by SQL*Plus. See Table 1.1, in the section on the BTITLE command, for a list of these variables.
When using TTITLE, you should start off with one of the keywords such as LEFT, RIGHT, or CENTER. Otherwise, if the first parameter after the command is just text, SQL*Plus will assume you have used a now obsolete syntax for this command, and you won’t get the results you want.