dbIsOpen
==============================================

Purpose
----------------

Reports whether a specified database connection is open.

Format
----------------
.. function:: ret = dbIsOpen(db_id)

    :param db_id: database connection index number.
    :type db_id: scalar

    :return ret: 1 if the connection is open or 0 if it is closed.

    :rtype ret: scalar