--------------------------------------------
lines 6-51 of file: at_cascade/move_table.py
--------------------------------------------

{xrst_begin move_table}
{xrst_spell
  dst
  src
}

Move Table
##########

Prototype
*********
{xrst_literal
    # BEGIN_DEF
    # END_DEF
}

Purpose
*******
Change the name of a table in the database.

connection
**********
Is a dismod_at open connection to the database.

src_name
********
is a ``str`` containing the name of the table before moving it.

dst_name
********
is a ``str`` containing the name of the table after moving it.

Log Table
*********
As row is added to the log table with the
ref:`add_log_entry.message` that says that table *src_name* was moved
to table *dst_name*.

1. *log_id*: is the integer length of the log table before the message
2. *message_type* is text ``at_cascade``
3. *table_name* is null
4. *row_id* is null
5. *seconds* is the integer unit time
6. *message* is the text message

{xrst_end   move_table}