src/iodbc/hdbc.h

/*
 *  hdbc.h
 *
 *  $Id$
 *
 *  Data source connect object management functions
 *
 *  The iODBC driver manager.
 *
 *  Copyright (C) 1995 by Ke Jin <kejin@empress.com>
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Library General Public
 *  License as published by the Free Software Foundation; either
 *  version 2 of the License, or (at your option) any later version.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Library General Public License for more details.
 *
 *  You should have received a copy of the GNU Library General Public
 *  License along with this library; if not, write to the Free
 *  Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
#ifndef	_HDBC_H
#define	_HDBC_H

typedef struct DBC
  {
    int type;			/* must be 1st field */
    struct DBC FAR *
     next;

    HENV genv;			/* back point to global env object */

    HDBC dhdbc;			/* driver's private dbc */
    HENV henv;			/* back point to instant env object */
    HSTMT hstmt;		/* list of statement object handle(s) */
    HERR herr;

    int state;

    /* options */
    UDWORD access_mode;
    UDWORD autocommit;

    UDWORD login_timeout;
    UDWORD odbc_cursors;
    UDWORD packet_size;
    UDWORD quiet_mode;
    UDWORD txn_isolation;
    SWORD cb_commit;
    SWORD cb_rollback;

    char FAR *
     current_qualifier;

    int trace;			/* trace flag */
    char FAR *
     tfile;
    void FAR *
     tstm;			/* trace stream */
  }
DBC_t;

/*
 * Note:
 *  - ODBC applications can see address of driver manager's
 *    connection object, i.e connection handle -- a void pointer,
 *    but not detail of it. ODBC applications can neither see
 *    detail driver's connection object nor its address.
 *
 *  - ODBC driver manager knows its own connection objects and
 *    exposes their address to an ODBC application. Driver manager
 *    also knows address of driver's connection objects and keeps
 *    it via dhdbc field in driver manager's connection object.
 *
 *  - ODBC driver exposes address of its own connection object to
 *    driver manager without detail.
 *
 *  - Applications can get driver's connection object handle by
 *    SQLGetInfo() with fInfoType equals to SQL_DRIVER_HDBC.
 */

enum
  {
    en_dbc_allocated,
    en_dbc_needdata,
    en_dbc_connected,
    en_dbc_hstmt
  };
#endif
Commit	Line	Data
	1	/*
	2	* hdbc.h
	3	*
	4	* $Id$
	5	*
	6	* Data source connect object management functions
	7	*
	8	* The iODBC driver manager.
	9	*
	10	* Copyright (C) 1995 by Ke Jin <kejin@empress.com>
	11	*
	12	* This library is free software; you can redistribute it and/or
	13	* modify it under the terms of the GNU Library General Public
	14	* License as published by the Free Software Foundation; either
	15	* version 2 of the License, or (at your option) any later version.
	16	*
	17	* This library is distributed in the hope that it will be useful,
	18	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	19	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	20	* Library General Public License for more details.
	21	*
	22	* You should have received a copy of the GNU Library General Public
	23	* License along with this library; if not, write to the Free
	24	* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
	25	*/
	26	#ifndef _HDBC_H
	27	#define _HDBC_H
	28
	29	typedef struct DBC
	30	{
	31	int type; /* must be 1st field */
	32	struct DBC FAR *
	33	next;
	34
	35	HENV genv; /* back point to global env object */
	36
	37	HDBC dhdbc; /* driver's private dbc */
	38	HENV henv; /* back point to instant env object */
	39	HSTMT hstmt; /* list of statement object handle(s) */
	40	HERR herr;
	41
	42	int state;
	43
	44	/* options */
	45	UDWORD access_mode;
	46	UDWORD autocommit;
	47
	48	UDWORD login_timeout;
	49	UDWORD odbc_cursors;
	50	UDWORD packet_size;
	51	UDWORD quiet_mode;
	52	UDWORD txn_isolation;
	53	SWORD cb_commit;
	54	SWORD cb_rollback;
	55
	56	char FAR *
	57	current_qualifier;
	58
	59	int trace; /* trace flag */
	60	char FAR *
	61	tfile;
	62	void FAR *
	63	tstm; /* trace stream */
	64	}
	65	DBC_t;
	66
	67	/*
	68	* Note:
	69	* - ODBC applications can see address of driver manager's
	70	* connection object, i.e connection handle -- a void pointer,
	71	* but not detail of it. ODBC applications can neither see
	72	* detail driver's connection object nor its address.
	73	*
	74	* - ODBC driver manager knows its own connection objects and
	75	* exposes their address to an ODBC application. Driver manager
	76	* also knows address of driver's connection objects and keeps
	77	* it via dhdbc field in driver manager's connection object.
	78	*
	79	* - ODBC driver exposes address of its own connection object to
	80	* driver manager without detail.
	81	*
	82	* - Applications can get driver's connection object handle by
	83	* SQLGetInfo() with fInfoType equals to SQL_DRIVER_HDBC.
	84	*/
	85
	86	enum
	87	{
	88	en_dbc_allocated,
	89	en_dbc_needdata,
	90	en_dbc_connected,
	91	en_dbc_hstmt
	92	};
	93	#endif