SET
---

Sets a session level variable to control certain aspects
of POLAR*Plus behavior as follows:

  SET AUTO[COMMIT] {ON | OFF | IMMEDIATE | statement_count}
    Note that POLAR*Plus always autocommits ddl statements.
    IMMEDIATE has the same effect as ON.  statement_count
    cause POLAR*Plus to issue a commit after N successful
    SQL statements.

  SET COLSEP column_separator
    Column separator is the text that will appear between columns.
    It defaults to a single space.

  SET ECHO {ON | OFF}
    Determines whether SQL & POLAR*Plus script statements 
    are shown to the screen as they are executed.  The
    default is OFF.

  SET FEED[BACK] {ON | OFF | row_threshold}
    Controls the display of interactive information after 
    a SQL statement is run.  row_threshold must be an integer.
    Setting row_threshold equal 0 is same as OFF.  Setting 
    ON is same as setting row_threshold equal 1.  

  SET FLU[SH] {ON | OFF}
    Setting Flush to ON creates makes the output buffer accesible
    to external programs even if it is still being appended too.
    However, it adds quit a bit of overhead to the process.

  SET HEA[DING] {ON | OFF}
    Determines if column headings are displayed for SELECT statements.

  SET HEADS[EP]
    Sets the new heading seperator character used by the 
    COLUMN HEADING command.  The default is '|'.

  SET LIN[ESIZE] width_of_line
    Specify the width of a line in characters (defaults to 132).

  SET NEWP[AGE] lines_per_page
    Controls how many blank lines are printed after a page break.
    The default is 1.  Use SET NEWAPGE 0 to print a formfeed at the
    start of each new page.

  SET NULL "null string"
    The string that is displayed when showing a null value for
    a column value being displayed in the output buffer.

  SET PAGES[IZE] 
    Set the number of printed lines that fit on a page

  SET SQLC[ASE] {MIX[ED] | UP[PER] | LO[WER]}
     Controls whether SQL statements transmitted to the server are
     converted to upper or lower case.

  SET PAU[SE] {ON | OFF}
    If set to ON, the message "Hit ENTER to continue" will be 
    displayed before each page break and the output will pause 
    accordingly.

  SET SPACE number_of_spaces
    Similar to COLSEP, but less flexible, this command sets the number
    of spaces to display between columns.

  SET SQLP[ROMPT] "prompt"
    The interactive prompt defaults to "SQL> ".

  SET TERM[OUT] {ON | OFF}
    Determines whether the output from a command is displayed 
    to the terminal    

  SET TIMI[NG] {ON | OFF}
    Controls whether elapsed time is displayed for each SQL
    statement after it is executed.

  SET VER[IFY] { ON | OFF }
    Determines whether the old & new values of a SQL statement are 
    displayed when a substitution variable is encountered.