diff --git a/src/interfaces/cli/example1.c b/src/interfaces/cli/example1.c new file mode 100644 index 0000000000000000000000000000000000000000..95dbeabd640e54f3a1cc279cf3554b412cb734d2 --- /dev/null +++ b/src/interfaces/cli/example1.c @@ -0,0 +1,171 @@ +/* -*- C -*- */ +/* The first example illustrates creating a table, adding some data + * to it, and selecting the inserted data. The second example shows + * interactive ad hoc query processing. + * + * Actual applications include more complete error checking following + * calls to SQL/CLI routines. That material is omitted from this + * Appendix for the sake of clarity. + * + * This file is adapted for PostgreSQL + * from the CLI Annex in the SQL98 August 1994 draft standard. + * Thomas G. Lockhart 1999-06-16 + */ + +/* + * B.1 Create table, insert, select + * + * This example function creates a table, inserts data into the table, + * and selects the inserted data. + * + * This example illustrates the execution of SQL statement text + * both using the Prepare() and Execute() method and using the + * ExecDirect() method. The example also illustrates both the case + * where the application uses the automatically-generated descriptors + * and the case where the application allocates a descriptor of its + * own and associates this descriptor with the SQL statement. + * + * Code comments include the equivalent statements in embedded SQL + * to show how embedded SQL operations correspond to SQL/CLI function + * calls. + */ + +#include <sqlcli.h> +#include <string.h> + +#ifndef NULL +#define NULL 0 +#endif + +int print_err(SQLSMALLINT handletype, SQLINTEGER handle); + +int example1(SQLCHAR *server, SQLCHAR *uid, SQLCHAR *authen) +{ + SQLHENV henv; + SQLHDBC hdbc; + SQLHDESC hdesc; + SQLHDESC hdesc1; + SQLHDESC hdesc2; + SQLHSTMT hstmt; + SQLINTEGER id; + SQLSMALLINT idind; + SQLCHAR name[51]; + SQLINTEGER namelen; + SQLSMALLINT nameind; + + /* EXEC SQL CONNECT TO :server USER :uid; */ + + /* allocate an environment handle */ + SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv); + /* allocate a connection handle */ + SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc); + + /* connect to database */ + if (SQLConnect(hdbc, server, SQL_NTS, uid, SQL_NTS, + authen, SQL_NTS) + != SQL_SUCCESS) + return(print_err(SQL_HANDLE_DBC, hdbc)); + + /* allocate a statement handle */ + SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt); + + /* EXEC SQL CREATE TABLE NAMEID (ID integer, NAME varchar(50)); */ + { + SQLCHAR create[] ="CREATE TABLE NAMEID (ID integer," + " NAME varchar(50))"; + + /* execute the CREATE TABLE statement */ + if (SQLExecDirect(hstmt, create, SQL_NTS) != SQL_SUCCESS) + return(print_err(SQL_HANDLE_STMT, hstmt)); + } + + /* EXEC SQL COMMIT WORK; */ + /* commit CREATE TABLE */ + SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT); + /* EXEC SQL INSERT INTO NAMEID VALUES ( :id, :name ); */ + { + SQLCHAR insert[]= "INSERT INTO NAMEID VALUES (?, ?)"; + + /* show the use of SQLPrepare/SQLExecute method */ + /* prepare the INSERT */ + if (SQLPrepare(hstmt, insert, SQL_NTS) != SQL_SUCCESS) + return(print_err(SQL_HANDLE_STMT, hstmt)); + /* application parameter descriptor */ + SQLGetStmtAttr(hstmt, SQL_ATTR_APP_PARAM_ + DESC, &hdesc1, 0L, + (SQLINTEGER *)NULL); + SQLSetDescRec(hdesc1, 1, SQL_INTEGER, 0, 0L, 0, 0, + (SQLPOINTER)&id, (SQLINTEGER *)NULL, (SQLSMALLINT *)NULL); + SQLSetDescRec(hdesc1, 2, SQL_CHAR, 0, 0L, 0, 0, + (SQLPOINTER)name, (SQLINTEGER *)NULL, + (SQLSMALLINT *)NULL); + /* implementation parameter descriptor */ + SQLGetStmtAttr(hstmt, SQL_ATTR_IMP_PARAM_ + DESC, &hdesc2, 0L, + (SQLINTEGER *)NULL); + SQLSetDescRec(hdesc2, 1, SQL_INTEGER, 0, 0L, 0, 0, + (SQLPOINTER)NULL, (SQLINTEGER *)NULL, + (SQLSMALLINT *)NULL); + SQLSetDescRec(hdesc2, 2, SQL_VARCHAR, 0, 50L, 0, 0, + (SQLPOINTER)NULL, (SQLINTEGER *)NULL, + (SQLSMALLINT *)NULL); + + /* assign parameter values and execute the INSERT */ + id=500; + (void)strcpy(name, "Babbage"); + if (SQLExecute(hstmt) != SQL_SUCCESS) + return(print_err(SQL_HANDLE_STMT, hstmt)); + } + /* EXEC SQL COMMIT WORK; */ + SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT); + /* commit inserts */ + + /* EXEC SQL DECLARE c1 CURSOR FOR SELECT ID, NAME FROM NAMEID; */ + /* EXEC SQL OPEN c1; */ + /* The application doesn't specify "declare c1 cursor for" */ + { + SQLCHAR select[]= "select ID, NAME from NAMEID"; + if (SQLExecDirect(hstmt, select, SQL_NTS) != SQL_SUCCESS) + return(print_err(SQL_HANDLE_STMT, hstmt)); + } + + /* EXEC SQL FETCH c1 INTO :id, :name; */ + /* this time, explicitly allocate an application row descriptor */ + SQLAllocHandle(SQL_HANDLE_DESC, hdbc, &hdesc); + SQLSetDescRec(hdesc, 1, SQL_INTEGER, 0, 0L, 0, 0, + (SQLPOINTER)&id, (SQLINTEGER *)NULL, (SQLSMALLINT *)&idind); + + SQLSetDescRec(hdesc, 2, SQL_ + CHAR, 0, (SQLINTEGER)sizeof(name), + 0, 0, (SQLPOINTER)&name, (SQLINTEGER *)&namelen, + (SQLSMALLINT *)&nameind); + /* associate descriptor with statement handle */ + SQLSetStmtAttr(hstmt, SQL_ATTR_APP_ROW_DESC, &hdesc, 0); + /* execute the fetch */ + SQLFetch(hstmt); + + /* EXEC SQL COMMIT WORK; */ + /* commit the transaction */ + SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT); + + /* EXEC SQL CLOSE c1; */ + SQLClose(hstmt); + /* free the statement handle */ + SQLFreeHandle(SQL_HANDLE_STMT, hstmt); + + /* EXEC SQL DISCONNECT; */ + /* disconnect from the database */ + SQLDisconnect(hdbc); + /* free descriptor handle */ + SQLFreeHandle(SQL_HANDLE_DESC, hdesc); + /* free descriptor handle */ + SQLFreeHandle(SQL_HANDLE_DESC, hdesc1); + /* free descriptor handle */ + SQLFreeHandle(SQL_HANDLE_DESC, hdesc2); + /* free connection handle */ + SQLFreeHandle(SQL_HANDLE_DBC, hdbc); + /* free environment handle */ + SQLFreeHandle(SQL_HANDLE_ENV, henv); + + return(0); +} diff --git a/src/interfaces/cli/example2.c b/src/interfaces/cli/example2.c new file mode 100644 index 0000000000000000000000000000000000000000..e882274221349c1e94f00d19f36bcbe94c08f99a --- /dev/null +++ b/src/interfaces/cli/example2.c @@ -0,0 +1,260 @@ +/* -*- C -*- */ +/* The first example illustrates creating a table, adding some data + * to it, and selecting the inserted data. The second example shows + * interactive ad hoc query processing. + * + * Actual applications include more complete error checking following + * calls to SQL/CLI routines. That material is omitted from this + * Appendix for the sake of clarity. + * + * This file is adapted for PostgreSQL + * from the CLI Annex in the SQL98 August 1994 draft standard. + * Thomas G. Lockhart 1999-06-16 + */ + +/* + * B.2 Interactive Query + * + * This sample function uses the concise CLI functions to + * interactively execute a SQL statement supplied as an argument. + * In the case where the user types a SELECT statement, the function + * fetches and displays all rows of the result set. + * + * This example illustrates the use of GetDiagField() to identify + * the type of SQL statement executed and, for SQL statements where + * the row count is defined on all implementations, the use of + * GetDiagField() to obtain the row count. + */ + +/* + * Sample program - uses concise CLI functions to execute + * interactively an ad hoc statement. + */ +#include <sqlcli.h> +#include <string.h> +#include <stdlib.h> + +#define MAXCOLS 100 + +#define max(a,b) (a>b?a:b) + +int print_err(SQLSMALLINT handletype, SQLINTEGER handle); +int build_indicator_message(SQLCHAR *errmsg, + SQLPOINTER *data, + SQLINTEGER collen, + SQLINTEGER *outlen, + SQLSMALLINT colnum); + +SQLINTEGER display_length(SQLSMALLINT coltype, + SQLINTEGER collen, + SQLCHAR *colname); + +example2(SQLCHAR *server, SQLCHAR *uid, SQLCHAR *authen, SQLCHAR *sqlstr) +{ + int i; + SQLHENV henv; + SQLHDBC hdbc; + SQLHSTMT hstmt; + SQLCHAR errmsg[256]; + SQLCHAR colname[32]; + SQLSMALLINT coltype; + SQLSMALLINT colnamelen; + SQLSMALLINT nullable; + SQLINTEGER collen[MAXCOLS]; + SQLSMALLINT scale; + SQLINTEGER outlen[MAXCOLS]; + SQLCHAR *data[MAXCOLS]; + SQLSMALLINT nresultcols; + SQLINTEGER rowcount; + SQLINTEGER stmttype; + SQLRETURN rc; + + /* allocate an environment handle */ + SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv); + + /* allocate a connection handle */ + SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc); + + /* connect to database */ + if (SQLConnect(hdbc, server, SQL_NTS, uid, SQL_NTS, authen, SQL_NTS) + != SQL_SUCCESS ) + return(print_err(SQL_HANDLE_DBC, hdbc)); + + /* allocate a statement handle */ + SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt); + + /* execute the SQL statement */ + if (SQLExecDirect(hstmt, sqlstr, SQL_NTS) != SQL_SUCCESS) + return(print_err(SQL_HANDLE_STMT, hstmt)); + + /* see what kind of statement it was */ + SQLGetDiagField(SQL_HANDLE_STMT, hstmt, 0, + SQL_DIAG_DYNAMIC_FUNCTION_CODE, + (SQLPOINTER)&stmttype, 0, (SQLSMALLINT *)NULL); + + switch (stmttype) { + /* SELECT statement */ + case SQL_SELECT_CURSOR: + /* determine number of result columns */ + SQLNumResultCols(hstmt, &nresultcols); + /* display column names */ + for (i=0; i<nresultcols; i++) { + SQLDescribeCol(hstmt, i+1, colname, sizeof(colname), + &colnamelen, &coltype, &collen[i], &scale, &nullable); + + /* assume there is a display_length function which + computes correct length given the data type */ + collen[i] = display_length(coltype, collen[i], colname); + (void)printf("%*.*s", collen[i], collen[i], colname); + /* allocate memory to bind column */ + data[i] = (SQLCHAR *) malloc(collen[i]); + + /* bind columns to program vars, converting all types to CHAR */ + SQLBindCol(hstmt, i+1, SQL_CHAR, data[i], collen[i], + &outlen[i]); + } + /* display result rows */ + while ((rc=SQLFetch(hstmt))!=SQL_ERROR) { + errmsg[0] = '\0'; + if (rc == SQL_SUCCESS_WITH_INFO) { + for (i=0; i<nresultcols; i++) { + if (outlen[i] == SQL_NULL_DATA || outlen[i] >= collen[i]) + build_indicator_message(errmsg, + (SQLPOINTER *)&data[i], collen[i], + &outlen[i], i); + (void)printf("%*.*s ", outlen[i], outlen[i], + data[i]); + } /* for all columns in this row */ + /* print any truncation messages */ + (void)printf("\n%s", errmsg); + } + } /* while rows to fetch */ + SQLClose(hstmt); + break; + + /* searched DELETE, INSERT or searched UPDATE statement */ + case SQL_DELETE_WHERE: + case SQL_INSERT: + case SQL_UPDATE_WHERE: + /* check rowcount */ + SQLGetDiagField(SQL_HANDLE_STMT, hstmt, 0, + SQL_DIAG_ROW_COUNT, (SQLPOINTER)&rowcount, 0, + (SQLSMALLINT *)NULL); + if (SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT) + == SQL_SUCCESS) { + (void) printf("Operation successful\n"); + } + else { + (void) printf("Operation failed\n"); + } + (void)printf("%ld rows affected\n", rowcount); + break; + + /* other statements */ + case SQL_ALTER_TABLE: + case SQL_CREATE_TABLE: + case SQL_CREATE_VIEW: + case SQL_DROP_TABLE: + case SQL_DROP_VIEW: + case SQL_DYNAMIC_DELETE_CURSOR: + case SQL_DYNAMIC_UPDATE_CURSOR: + case SQL_GRANT: + case SQL_REVOKE: + if (SQLEndTran(SQL_HANDLE_ENV, henv, SQL_COMMIT) + == SQL_SUCCESS) { + (void) printf("Operation successful\n"); + } + else { + (void) printf("Operation failed\n"); + } + break; + + /* implementation-defined statement */ + default: + (void)printf("Statement type=%ld\n", stmttype); + break; + } + + /* free data buffers */ + for (i=0; i<nresultcols; i++) { + (void)free(data[i]); + } + + /* free statement handle */ + SQLFreeHandle(SQL_HANDLE_STMT, hstmt); + /* disconnect from database */ + SQLDisconnect(hdbc); + /* free connection handle */ + SQLFreeHandle(SQL_HANDLE_DBC, hdbc); + /* free environment handle */ + SQLFreeHandle(SQL_HANDLE_ENV, henv); + + return(0); +} + +/*********************************************************** + The following functions are given for completeness, but are + not relevant for understanding the database processing + nature of CLI +***********************************************************/ + +#define MAX_NUM_PRECISION 15 +/*#define max length of char string representation of no. as: + + = max(precision) + leading sign + E + exp sign + max exp length + = 15 + 1 + 1 + 1 + 2 + = 15 + 5 +*/ +#define MAX_NUM_STRING_SIZE (MAX_NUM_PRECISION + 5) + +SQLINTEGER display_length(SQLSMALLINT coltype, SQLINTEGER collen, + SQLCHAR *colname) +{ + switch (coltype) { + + case SQL_VARCHAR: + case SQL_CHAR: + return(max(collen,strlen((char *)colname))); + break; + + case SQL_FLOAT: + case SQL_DOUBLE: + case SQL_NUMERIC: + case SQL_REAL: + case SQL_DECIMAL: + return(max(MAX_NUM_STRING_SIZE,strlen((char *)colname))); + break; + + case SQL_DATETIME: + return(max(SQL_TIMESTAMP_LEN,strlen((char *)colname))); + break; + + case SQL_INTEGER: + return(max(10,strlen((char *)colname))); + break; + + case SQL_SMALLINT: + return(max(5,strlen((char *)colname))); + break; + + default: + (void)printf("Unknown datatype, %d\n", coltype); + return(0); + break; + } +} + +int build_indicator_message(SQLCHAR *errmsg, SQLPOINTER *data, + SQLINTEGER collen, SQLINTEGER *outlen, SQLSMALLINT colnum) +{ + if (*outlen == SQL_NULL_DATA) { + (void)strcpy((char *)data, "NULL"); + *outlen=4; + } + else { + sprintf((char *)errmsg+strlen((char *)errmsg), + "%d chars truncated, col %d\n", *outlen-collen+1, + colnum); + *outlen=255; + } +} diff --git a/src/interfaces/cli/sqlcli.h b/src/interfaces/cli/sqlcli.h new file mode 100644 index 0000000000000000000000000000000000000000..7bfa0fb42f698032c533aeabc5ad85bf3d148563 --- /dev/null +++ b/src/interfaces/cli/sqlcli.h @@ -0,0 +1,535 @@ +/* -*- C -*- */ +/* sqlcli.h Header File for SQL CLI. + * The actual header file must contain at least the information + * specified here, except that the comments may vary. + * + * This file is adapted for PostgreSQL + * from the SQL98 August 1994 draft standard. + * Thomas G. Lockhart 1999-06-16 + */ + +/* API declaration data types */ +typedef unsigned char SQLCHAR; +typedef long SQLINTEGER; +typedef short SQLSMALLINT; +typedef double SQLDOUBLE; +typedef float SQLREAL; +typedef void * SQLPOINTER; +typedef unsigned char SQLDATE; +typedef unsigned char SQLTIME; +typedef unsigned char SQLTIMESTAMP; +typedef unsigned char SQLDECIMAL; +typedef unsigned char SQLNUMERIC; + +/* function return type */ +typedef SQLSMALLINT SQLRETURN; + +/* generic data structures */ +typedef SQLINTEGER SQLHENV; /* environment handle */ +typedef SQLINTEGER SQLHDBC; /* connection handle */ +typedef SQLINTEGER SQLHSTMT; /* statement handle */ +typedef SQLINTEGER SQLHDESC; /* descriptor handle */ + +/* special length/indicator values */ +#define SQL_NULL_DATA -1 +#define SQL_DATA_AT_EXEC -2 + +/* return values from functions */ +#define SQL_SUCCESS 0 +#define SQL_SUCCESS_WITH_INFO 1 +#define SQL_NEED_DATA 99 +#define SQL_NO_DATA 100 +#define SQL_ERROR -1 +#define SQL_INVALID_HANDLE -2 + +/* test for SQL_SUCCESS or SQL_SUCCESS_WITH_INFO */ +#define SQL_SUCCEEDED(rc) (((rc)&(~1))==0) + +/* flags for null-terminated string */ +#define SQL_NTS -3 +#define SQL_NTSL -3L + +/* maximum message length */ +#define SQL_MAX_MESSAGE_LENGTH 255 + +/* maximum identifier length */ +#define SQL_MAX_ID_LENGTH 18 + +/* date/time length constants */ +/* add p+1 for time and timestamp if precision is nonzero +#define SQL_DATE_LEN 10 +#define SQL_TIME_LEN 8 +#define SQL_TIMESTAMP_LEN 19 + +/* handle type identifiers */ +#define SQL_HANDLE_ENV 1 +#define SQL_HANDLE_DBC 2 +#define SQL_HANDLE_STMT 3 +#define SQL_HANDLE_DESC 4 + +/* environment attribute */ +#define SQL_ATTR_OUTPUT_NTS 10001 + +/* connection attribute */ +#define SQL_ATTR_AUTO_IPD 10001 + +/* statement attributes */ +#define SQL_ATTR_APP_ROW_DESC 10010 +#define SQL_ATTR_APP_PARAM_DESC 10011 +#define SQL_ATTR_IMP_ROW_DESC 10012 +#define SQL_ATTR_IMP_PARAM_DESC 10013 + +/* identifiers of fields in the SQL descriptor */ +#define SQL_DESC_COUNT 1 +#define SQL_DESC_TYPE 2 +#define SQL_DESC_LENGTH 3 +#define SQL_DESC_LENGTH_PTR 4 +#define SQL_DESC_PRECISION 5 +#define SQL_DESC_SCALE 6 +#define SQL_DESC_DATETIME_INTERVAL_CODE 7 +#define SQL_DESC_NULLABLE 8 +#define SQL_DESC_INDICATOR_PTR 9 +#define SQL_DESC_DATA_PTR 10 +#define SQL_DESC_NAME 11 +#define SQL_DESC_UNNAMED 12 +#define SQL_DESC_ALLOC_TYPE 99 + +/* identifiers of fields in the diagnostics area */ +#define SQL_DIAG_RETURNCODE 1 +#define SQL_DIAG_NUMBER 2 +#define SQL_DIAG_ROW_COUNT 3 +#define SQL_DIAG_SQLSTATE 4 +#define SQL_DIAG_NATIVE 5 +#define SQL_DIAG_MESSAGE_TEXT 6 +#define SQL_DIAG_DYNAMIC_FUNCTION 7 +#define SQL_DIAG_CLASS_ORIGIN 8 +#define SQL_DIAG_SUBCLASS_ORIGIN 9 +#define SQL_DIAG_CONNECTION_NAME 10 +#define SQL_DIAG_SERVER_NAME 11 +#define SQL_DIAG_DYNAMIC_FUNCTION_CODE 12 + +/* dynamic function codes returned in diagnostics area*/ +#define SQL_DIAG_ALTER_DOMAIN 3 +#define SQL_DIAG_ALTER_TABLE 4 +#define SQL_DIAG_CREATE_ASSERTION 6 +#define SQL_DIAG_CREATE_CHARACTER_SET 8 +#define SQL_DIAG_CREATE_COLLATION 10 +#define SQL_DIAG_CREATE_DOMAIN 23 +#define SQL_DIAG_CREATE_SCHEMA 64 +#define SQL_DIAG_CREATE_TABLE 77 +#define SQL_DIAG_CREATE_TRANSLATION 79 +#define SQL_DIAG_CREATE_VIEW 84 +#define SQL_DIAG_DELETE_WHERE 19 +#define SQL_DIAG_DROP_ASSERTION 24 +#define SQL_DIAG_DROP_CHARACTER_SET 25 +#define SQL_DIAG_DROP_COLLATION 26 +#define SQL_DIAG_DROP_DOMAIN 27 +#define SQL_DIAG_DROP_SCHEMA 31 +#define SQL_DIAG_DROP_TABLE 32 +#define SQL_DIAG_DROP_TRANSLATION 33 +#define SQL_DIAG_DROP_VIEW 36 +#define SQL_DIAG_DYNAMIC_DELETE_CURSOR 54 +#define SQL_DIAG_DYNAMIC_UPDATE_CURSOR 55 +#define SQL_DIAG_GRANT 48 +#define SQL_DIAG_INSERT 50 +#define SQL_DIAG_REVOKE 59 +#define SQL_DIAG_SELECT 41 +#define SQL_DIAG_SELECT_CURSOR 85 +#define SQL_DIAG_SET_CATALOG 66 +#define SQL_DIAG_SET_CONSTRAINT 68 +#define SQL_DIAG_SET_NAMES 72 +#define SQL_DIAG_SET_SCHEMA 74 +#define SQL_DIAG_SET_SESSION_AUTHORIZATION 76 +#define SQL_DIAG_SET_TIME_ZONE 71 +#define SQL_DIAG_SET_TRANSACTION 75 +#define SQL_DIAG_UNKNOWN_STATEMENT 0 +#define SQL_DIAG_UPDATE_WHERE 82 + +/* SQL data type codes */ +#define SQL_CHAR 1 +#define SQL_NUMERIC 2 +#define SQL_DECIMAL 3 +#define SQL_INTEGER 4 +#define SQL_SMALLINT 5 +#define SQL_FLOAT 6 +#define SQL_REAL 7 +#define SQL_DOUBLE 8 +#define SQL_DATETIME 9 +#define SQL_INTERVAL 10 +#define SQL_VARCHAR 12 +#define SQL_BIT 14 +#define SQL_BIT_VARYING 15 + +/* One-parameter shortcuts for datetime data types */ +#define SQL_TYPE_DATE 91 +#define SQL_TYPE_TIME 92 +#define SQL_TYPE_TIMESTAMP 93 + +/* GetTypeInfo request for all data types */ +#define SQL_ALL_TYPES 0 + +/* BindCol() and BindParam() default conversion code */ +#define SQL_DEFAULT 99 + +/* GetData code indicating that the application parameter */ +/* descriptor specifies the data type */ +#define SQL_ARD_TYPE -99 + +/* date/time type subcodes */ +#define SQL_CODE_DATE 1 +#define SQL_CODE_TIME 2 +#define SQL_CODE_TIMESTAMP 3 +#define SQL_CODE_TIME_ZONE 4 +#define SQL_CODE_TIMESTAMP_ZONE 5 + +/* interval qualifier codes */ +#define SQL_DAY 1 +#define SQL_DAY_TO_HOUR 2 +#define SQL_DAY_TO_MINUTE 3 +#define SQL_DAY_TO_SECOND 4 +#define SQL_HOUR 5 +#define SQL_HOUR_TO_MINUTE 6 +#define SQL_HOUR_TO_SECOND 7 +#define SQL_MINUTE 8 +#define SQL_MINUTE_TO_SECOND 9 +#define SQL_MONTH 10 +#define SQL_SECOND 11 +#define SQL_YEAR 12 +#define SQL_YEAR_TO_MONTH 13 + +/* CLI option values */ +#define SQL_FALSE 0 +#define SQL_TRUE 1 + +/* values of NULLABLE field in descriptor */ +#define SQL_NO_NULLS 0 +#define SQL_NULLABLE 1 + +/* Values returned by GetTypeInfo for the SEARCHABLE column */ +#define SQL_PRED_NONE 0 +#define SQL_PRED_CHAR 1 +#define SQL_PRED_BASIC 2 + +/* values of UNNAMED field in descriptor */ +#define SQL_NAMED 0 +#define SQL_UNNAMED 1 + +/* values of ALLOC_TYPE field in descriptor */ +#define SQL_DESC_ALLOC_AUTO 1 +#define SQL_DESC_ALLOC_USER 2 + +/* EndTran() options */ +#define SQL_COMMIT 0 +#define SQL_ROLLBACK 1 + +/* FreeStmt() options */ +#define SQL_CLOSE 0 +#define SQL_DROP 1 +#define SQL_UNBIND 2 +#define SQL_RESET_PARAMS 3 + +/* null handles returned by AllocHandle() */ +#define SQL_NULL_HENV 0 +#define SQL_NULL_HDBC 0 +#define SQL_NULL_HSTMT 0 +#define SQL_NULL_HDESC 0 + +/* GetFunctions values to identify CLI routines */ +#define SQL_API_SQLALLOCCONNECT 1 +#define SQL_API_SQLALLOCENV 2 +#define SQL_API_SQLALLOCHANDLE 1001 +#define SQL_API_SQLALLOCSTMT 3 +#define SQL_API_SQLBINDCOL 4 +#define SQL_API_SQLBINDPARAM 1002 +#define SQL_API_SQLCANCEL 5 +#define SQL_API_SQLCLOSECURSOR 1003 +#define SQL_API_SQLCONNECT 7 +#define SQL_API_SQLCOPYDESC 1004 +#define SQL_API_SQLCOLATTRIBUTE 6 +#define SQL_API_SQLDESCRIBECOL 8 +#define SQL_API_SQLDISCONNECT 9 +#define SQL_API_SQLENDTRAN 1005 +#define SQL_API_SQLERROR 10 +#define SQL_API_SQLEXECDIRECT 11 +#define SQL_API_SQLEXECUTE 12 +#define SQL_API_SQLFETCH 13 +#define SQL_API_SQLFREECONNECT 14 +#define SQL_API_SQLFREEENV 15 +#define SQL_API_SQLFREEHANDLE 1006 +#define SQL_API_SQLFREESTMT 16 +#define SQL_API_SQLFUNCTIONS 44 +#define SQL_API_SQLGETCONNECTATTR 1007 +#define SQL_API_SQLGETCURSORNAME 17 +#define SQL_API_SQLGETDATA 43 +#define SQL_API_SQLGETDESCFIELD 1008 +#define SQL_API_SQLGETDESCREC 1009 +#define SQL_API_SQLGETDIAGFIELD 1010 +#define SQL_API_SQLGETDIAGREC 1011 +#define SQL_API_SQLGETENVATTR 1012 +#define SQL_API_SQLGETINFO 45 +#define SQL_API_SQLGETSTMTATTR 1014 +#define SQL_API_SQLGETTYPEINFO 47 +#define SQL_API_SQLNUMRESULTCOLS 18 +#define SQL_API_SQLPARAMDATA 48 +#define SQL_API_SQLPREPARE 19 +#define SQL_API_SQLPUTDATA 49 +#define SQL_API_SQLRELEASEENV 1015 +#define SQL_API_SQLROWCOUNT 20 +#define SQL_API_SQLSCROLLFETCH 1021 +#define SQL_API_SQLSETCONNECTATTR 1016 +#define SQL_API_SQLSETCURSORNAME 21 +#define SQL_API_SQLSETDESCFIELD 1017 +#define SQL_API_SQLSETDESCREC 1018 +#define SQL_API_SQLSETENVATTR 1019 +#define SQL_API_SQLSETSTMTATTR 1020 + +/* information requested by GetInfo */ +#define SQL_MAX_DRIVER_CONNECTIONS 0 +#define SQL_MAX_RESULT_SETS 1 +#define SQL_DBMS_NAME 17 +#define SQL_DBMS_VER 18 +#define SQL_MAX_COLUMN_NAME_LEN 30 +#define SQL_MAX_CURSOR_NAME_LEN 31 +#define SQL_MAX_TABLE_NAME_LEN 35 + +/* null handle used when allocating HENV */ +#define SQL_NULL_HANDLE 0L + +SQLRETURN SQLAllocConnect(SQLHENV EnvironmentHandle, + SQLHDBC *ConnectionHandle); + +SQLRETURN SQLAllocEnv(SQLHENV *EnvironmentHandle); + +SQLRETURN SQLAllocHandle(SQLSMALLINT HandleType, + SQLINTEGER InputHandle, + SQLINTEGER *OutputHandle); + + +SQLRETURN SQLAllocStmt(SQLHDBC ConnectionHandle, + SQLSTMT *StatementHandle); + +SQLRETURN SQLBindCol(SQLHSTMT StatementHandle, + SQLSMALLINT ColumnNumber, + SQLSMALLINT BufferType, + SQLPOINTER Data, + SQLINTEGER BufferLength, + SQLINTEGER *DataLength); + +SQLRETURN SQLBindParam(SQLHSTMT StatementHandle, + SQLSMALLINT ParamNumber, + SQLSMALLINT BufferType, + SQLSMALLINT ParamType, + SQLINTEGER ParamLength, + SQLSMALLINT Scale, + SQLPOINTER Data, + SQLINTEGER *DataLength); + +SQLRETURN SQLCancel(SQLHSTMT StatementHandle); + +SQLRETURN SQLCloseCursor(SQLHSTMT StatementHandle); + +SQLRETURN SQLColAttribute(SQLHENV StatementHandle, + SQLSMALLINT ColumnNumber, + SQLSMALLINT FieldIdentifier, + SQLCHAR *CharacterAttribute, + SQLINTEGER BufferLength, + SQLINTEGER *AttributetLength, + SQLINTEGER *NumericAttribute); + + +SQLRETURN SQLConnect(SQLHDBC ConnectionHandle, + SQLCHAR *ServerName, + SQLSMALLINT NameLength1, + SQLCHAR *UserName, + SQLSMALLINT NameLength2, + SQLCHAR *Authentication, + SQLSMALLINT NameLength3); + + +SQLRETURN SQLCopyDesc(SQLHDESC SourceDescHandle, + SQLHDESC TargetDescHandle); + +SQLRETURN SQLDescribeCol(SQLHSTMT StatementHandle, + SQLSMALLINT ColumnNumber, + SQLCHAR *ColumnName, + SQLSMALLINT BufferLength, + SQLSMALLINT *ColumnNameLength, + SQLSMALLINT *ColumnType, + SQLINTEGER *ColumnLength, + SQLSMALLINT *ColumnScale, + SQLSMALLINT *Nullable); + +SQLRETURN SQLDisconnect(SQLHDBC ConnectionHandle); + +SQLRETURN SQLEndTran(SQLSMALLINT HandleType, + SQLHENV Handle, + SQLSMALLINT CompletionType); + +SQLRETURN SQLError(SQLHENV EnvironmentHandle, + SQLHDBC ConnectionHandle, + SQLSTMT StatementHandle, + SQLCHAR *Sqlstate, + SQLINTEGER *NativeError, + SQLCHAR *MessageText, + SQLINTEGER BufferLength, + SQLINTEGER *TextLength); + +SQLRETURN SQLExecDirect(SQLHSTMT StatementHandle, + SQLCHAR *StatementText, + SQLSMALLINT StringLength); + + +SQLRETURN SQLExecute(SQLHSTMT StatementHandle); + +SQLRETURN SQLFetch(SQLHSTMT StatementHandle); + +SQLRETURN SQLFreeConnect(SQLHDBC ConnectionHandle); + +SQLRETURN SQLFreeEnv(SQLHENV EnvironmentHandle); + +SQLRETURN SQLFreeHandle(SQLSMALLINT HandleType, + SQLINTEGER Handle); + +SQLRETURN SQLFreeStmt(SQLHSTMT StatementHandle); + +SQLRETURN SQLGetConnectAttr(SQLHDBC ConnectionHandle, + SQLINTEGER Attribute, + SQLPOINTER Value, + SQLINTEGER BufferLength, + SQLINTEGER *StringLength); + + +SQLRETURN SQLGetCursorName(SQLHSTMT StatementHandle, + SQLCHAR *CursorName, + SQLSMALLINT BufferLength, + SQLSMALLINT *NameLength); + +SQLRETURN SQLGetData(SQLHSTMT StatementHandle, + SQLSMALLINT ColumnNumber, + SQLSMALLINT TargetType, + SQLPOINTER TargetValue, + SQLINTEGER BufferLength, + SQLINTEGER *IndicatorValue); + +SQLRETURN SQLGetFunctions(SQLHDBC ConnectionHandle, + SQLSMALLINT FunctionId, + SQLSMALLINT *Supported); + +SQLRETURN SQLGetInfo(SQLHDBC ConnectionHandle, + SQLSMALLINT InfoType, + SQLPOINTER InfoValue, + SQLSMALLINT BufferLength, + SQLSMALLINT *StringLength); + +SQLRETURN SQLGetTypeInfo(SQLHSTMT StatementHandle, + SQLSMALLINT DataType); + +SQLRETURN SQLGetDescField(SQLHDESC DescriptorHandle, + SQLSMALLINT RecordNumber, + SQLSMALLINT FieldIdentifier, + SQLPOINTER Value, + SQLINTEGER BufferLength, + SQLINTEGER *StringLength); + +SQLRETURN SQLGetDescRec(SQLHDESC DescriptorHandle, + SQLSMALLINT RecordNumber, + SQLCHAR *Name, + SQLSMALLINT BufferLength, + SQLSMALLINT *StringLength, + SQLSMALLINT *Type, + SQLSMALLINT *SubType, + SQLINTEGER *Length, + SQLSMALLINT *Precision, + SQLSMALLINT *Scale, + SQLSMALLINT *Nullable); + +SQLRETURN SQLGetDiagField(SQLSMALLINT HandleType, + SQLINTEGER Handle, + SQLSMALLINT RecordNumber, + SQLSMALLINT DiagIdentifier, + SQLPOINTER DiagInfo, + SQLSMALLINT BufferLength, + SQLSMALLINT *StringLength); + + +SQLRETURN SQLGetDiagRec(SQLSMALLINT HandleType, + SQLINTEGER Handle, + SQLSMALLINT RecordNumber, + SQLCHAR *Sqlstate, + SQLINTEGER *NativeError, + SQLCHAR *MessageText, + SQLSMALLINT BufferLength, + SQLSMALLINT *StringLength); + +SQLRETURN SQLGetEnvAttr(SQLHENV EnvironmentHandle, + SQLINTEGER Attribute, + SQLPOINTER Value, + SQLINTEGER BufferLength, + SQLINTEGER *StringLength); + +SQLRETURN SQLGetStmtAttr(SQLHSTMT StatementHandle, + SQLINTEGER Attribute, + SQLPOINTER Value, + SQLINTEGER BufferLength, + SQLINTEGER *StringLength); + +SQLRETURN SQLLanguages(SQLHSTMT StatementHandle); + +SQLRETURN SQLNumResultCols(SQLHSTMT StatementHandle, + SQLINTEGER *ColumnCount); + +SQLRETURN SQLParamData(SQLHSTMT StatementHandle, + SQLPOINTER *Value); + +SQLRETURN SQLPrepare(SQLHSTMT StatementHandle, + SQLCHAR *StatementText, + SQLSMALLINT StringLength); + + +SQLRETURN SQLPutData(SQLHSTMT StatementHandle, + SQLPOINTER Data, + SQLINTEGER StringLength); + +SQLRETURN SQLReleaseEnv(SQLHENV EnvironmentHandle); + +SQLRETURN SQLRowCount(SQLHSTMT StatementHandle, + SQLINTEGER *RowCount); + +SQLRETURN SQLScrollFetch(SQLHSTMT StatementHandle, + SQLINTEGER FetchOrientation, + SQLINTEGER FetchOffset); + +SQLRETURN SQLSetConnectAttr(SQLHDBC ConnectionHandle, + SQLINTEGER AttributeCursorName, + SQLPOINTER Value, + SQLINTEGER StringLength); + +SQLRETURN SQLSetCursorName(SQLHSTMT StatementHandle, + SQLCHAR *CursorName, + SQLSMALLINT NameLength); + +SQLRETURN SQLSetDescField(SQLHDESC DescriptorHandle, + SQLSMALLINT RecordNumber, + SQLSMALLINT FieldIdentifier, + SQLPOINTER Value, SQLINTEGER BufferLength); + +SQLRETURN SQLSetDescRec(SQLHDESC DescriptorHandle, + SQLSMALLINT RecordNumber, + SQLSMALLINT Type, + SQLSMALLINT SubType, + SQLINTEGER Length, + SQLSMALLINT Precision, + SQLSMALLINT Scale, + SQLPOINTER Data, + SQLINTEGER *StringLength, + SQLSMALLINT *Indicator); + +SQLRETURN SQLSetEnvAttr(SQLHENV EnvironmentHandle, + SQLINTEGER Attribute, + SQLPOINTER Value, + SQLINTEGER StringLength); + +SQLRETURN SQLSetStmtAttr(SQLHSTMT StatementHandle, + SQLINTEGER Attribute, + SQLPOINTER Value, + SQLINTEGER StringLength);