Oracle PL/SQL Tutorial/SQL PLUS Session Environment/Ttitle BTitle

Remarks in Scripts with Ttitle and Btitle

The TTITLE (top title) and BTITLE (bottom title) commands have this syntax:

TTITLE option text OFF/ON

where option refers to the placement of the title:

COLUMN n (start in some column, n)
SKIP m (skip m blank lines)
TAB x (tab x positions)
LEFT/CENTER/RIGHT (default is LEFT)

The same holds for BTITLE.

In addition, page numbers may be added with the extension:

option text format 999 sql.pno

   <source lang="sql">

SQL> SQL> SQL> set pagesize 22 SQL> set linesize 80 SQL> SQL> ttitle left "SQL*Plus report" - > right "Page: " format 99 SQL.PNO - > skip center "OVERVIEW" - > skip center "employees department 30" - > skip 2 SQL> SQL> btitle col 20 "Confidential" tab 8 - > "Created by: " SQL.USER SQL> SQL> SQL> create table employees(

 2    empno      NUMBER(4)
 3  , ename      VARCHAR2(8)
 4  , init       VARCHAR2(5)
 5  , job        VARCHAR2(8)
 6  , mgr        NUMBER(4)
 7  , bdate      DATE
 8  , msal       NUMBER(6,2)
 9  , comm       NUMBER(6,2)
10  , deptno     NUMBER(2) ) ;

Table created. SQL> SQL> SQL> insert into employees values(1,"Jason", "N", "TRAINER", 2, date "1965-12-18", 800 , NULL, 10); 1 row created. SQL> insert into employees values(2,"Jerry", "J", "SALESREP",3, date "1966-11-19", 1600, 300, 10); 1 row created. SQL> insert into employees values(3,"Jord", "T" , "SALESREP",4, date "1967-10-21", 1700, 500, 20); 1 row created. SQL> insert into employees values(4,"Mary", "J", "MANAGER", 5, date "1968-09-22", 1800, NULL, 20); 1 row created. SQL> insert into employees values(5,"Joe", "P", "SALESREP",6, date "1969-08-23", 1900, 1400, 30); 1 row created. SQL> insert into employees values(6,"Black", "R", "MANAGER", 7, date "1970-07-24", 2000, NULL, 30); 1 row created. SQL> insert into employees values(7,"Red", "A", "MANAGER", 8, date "1971-06-25", 2100, NULL, 40); 1 row created. SQL> insert into employees values(8,"White", "S", "TRAINER", 9, date "1972-05-26", 2200, NULL, 40); 1 row created. SQL> insert into employees values(9,"Yellow", "C", "DIRECTOR",10, date "1973-04-27", 2300, NULL, 20); 1 row created. SQL> insert into employees values(10,"Pink", "J", "SALESREP",null,date "1974-03-28", 2400, 0, 30); 1 row created. SQL> SQL> SQL> SQL> select empno, ename, bdate

 2  ,      msal         as salary
 3  ,      comm         as commission
 4  from   employees
 5  where  deptno = 30;

SQL*Plus report Page: 1

                                   OVERVIEW
                            employees department 30
                                          month
EMPNO      last_name       BDATE         salary COMMISSION

-------------------- ---------- --------- ----------

    5 Joe                  23-08-1969  $1900.00       1400
    6 Black                24-07-1970  $2000.00 null
   10 Pink                 28-03-1974  $2400.00          0

                  Confidential        Created by: sqle

3 rows selected. SQL> SQL> btitle off SQL> btitle btitle OFF and is the following 66 characters: col 20 "Confidential" tab 8 "Created by: " SQL.USER SQL> ttitle off SQL> SQL> drop table employees; Table dropped. SQL></source>

TTitle ON and OFF

   <source lang="sql">

SQL> SQL> SET PAGESIZE 66 SQL> COLUMN name FORMAT A30 SQL> COLUMN type FORMAT A15 SQL> COLUMN source_size FORMAT 999999 SQL> COLUMN parsed_size FORMAT 999999 SQL> COLUMN code_size FORMAT 999999 SQL> TTITLE "Size of PL/SQL Objects > &&1 KBytes" Enter value for 1: SQL> SELECT name, type, source_size, parsed_size, code_size

 2    FROM user_object_size
 3   WHERE code_size > &&1 * 1000
 4   ORDER BY code_size DESC
 5  /

old 3: WHERE code_size > &&1 * 1000 new 3: WHERE code_size > * 1000

WHERE code_size >  * 1000
                   *

ERROR at line 3: ORA-00936: missing expression

SQL> SQL> TTITLE OFF SQL> SQL> SQL></source>

Use TTITLE and BTITLE

   <source lang="sql">

SQL> SQL> -- create demo table SQL> create table Employee(

 2    ID                 VARCHAR2(4 BYTE)         NOT NULL,
 3    First_Name         VARCHAR2(10 BYTE),
 4    Last_Name          VARCHAR2(10 BYTE),
 5    Start_Date         DATE,
 6    End_Date           DATE,
 7    Salary             Number(8,2),
 8    City               VARCHAR2(10 BYTE),
 9    Description        VARCHAR2(15 BYTE)
10  )
11  /

Table created. SQL> SQL> -- prepare data SQL> insert into Employee(ID, First_Name, Last_Name, Start_Date, End_Date,

                 Salary,  City,       Description)
 2               values ("01","Jason",    "Martin",  to_date("19960725","YYYYMMDD"), to_date("20060

725","YYYYMMDD"), 1234.56, "Toronto", "Programmer")

 3  /