--------------------------------------------
PTMDB MODULE - db_create_database() FUNCTION
--------------------------------------------

  ------------
  USAGE FORMAT
  ------------

    Where $rv is the SQL query's return value:

    $rv = &db_create_database($db_object, $db_name);

  -----------
  DESCRIPTION
  -----------

    Creates a new database on the server.
    Returns the CREATE DATABASE query's return value.
    Returns 1 of successful.
    Requires the appropriate database permissions.

  ---------
  ARGUMENTS
  ---------

    $db_object

      REQUIRED

      A database handler object. This object stores connection information and
      is returned from a db_connect() function call. This object is of the same
      type as is returned by a DBI->connect function call.

    $db_name

      REQUIRED

      The name of the database to create.

  -------
  RETURNS
  -------

    1 if successful.
    Nothing if not successful.

  --------
  SEE ALSO
  --------

    MODULES

      PTMDB

    FUNCTIONS

      PTMDB - db_drop_database()