----------------------------------------------
PTMDB MODULE - db_get_process_stats() FUNCTION
----------------------------------------------

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

    Where @stats is a returned array of array references:

    @stats = &db_get_process_stats($db_obejct);

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

    Retreives the database server's currently running process list. Returns
    an array of array references, each containing process information.

  ---------
  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.

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

    An array of array references. Each array reference contains process
    information. This information can vary depending on database type. See your
    database documentation for the "SHOW PROCESSLIST" SQL query.
    MySQL, for example, returns process information in the following order:

      Process ID, User, Host, Database, Command, Time, Status, SQL Query

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

    MODULES

      PTMDB