mco_close_all_instances

Close all database instances.

Prototype

    MCO_RET mco_close_all_instances(void);

Arguments

void
No arguments.

Description

This function destroys all database instances. It is used to clean up possible previous database instances after an application crash.

Return Codes

MCO_S_OK
All database instances closed successfully.
MCO_ERR_DB
An internal error occurred closing one or more instances.
MCO_E_OPENED_SESSIONS
There are open connections to the database. (Call mco_db_disconnect() for all open sessions first.)

Example


    Application snippet:

    const char *dbname = "SimpleDb";

    int main(int argc, char* argv[])
    {
        mco_db_h db;
        MCO_RET rc;
        mco_device_t dev;
        mco_db_params_t db_params;
        ...

        if ((rc = mco_runtime_start()) != MCO_S_OK)
            exit(-1);

        /* Clean up any previously opened database instances. */
        rc = mco_close_all_instances();

        if (MCO_S_OK != rc)
        {
            rc = mco_db_open_dev(dbname, simpledb_get_dictionary(), &dev, 1, &db_params);

            ...
        }
    }

Files

Header file:
mco.h
Source file:
mcodb.c
Library:
libmcolib.a