File: prguid29.htm

package info (click to toggle)
solid-doc 2.2-1
links: PTS
area: non-free
in suites: potato, slink
size: 3,436 kB
ctags: 11,371
sloc: makefile: 58; sh: 2
file content (1016 lines) | stat: -rw-r--r-- 28,819 bytes
parent folder | download | duplicates (2)
<HTML>
<HEAD>
<TITLE>prguide.htm</TITLE>
<LINK REL="ToC" HREF="httoc.htm">
<LINK REL="Index" HREF="htindex.htm">
<LINK REL="Next" HREF="prguid30.htm">
<LINK REL="Previous" HREF="prguid28.htm"></HEAD>
<BODY BGCOLOR="#FFFFFF">
<P ALIGN=CENTER>
<A HREF="prguid28.htm" TARGET="_self"><IMG SRC="graprev.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Previous Page"></A>
<A HREF="httoc.htm" TARGET="_self"><IMG SRC="gratoc.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="TOC"></A>
<A HREF="htindex.htm" TARGET="_self"><IMG SRC="graindex.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Index"></A>
<A HREF="prguid30.htm" TARGET="_self"><IMG SRC="granext.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Next Page"></A>
<HR ALIGN=CENTER>
<P>
<UL>
<LI>
<A HREF="#E9E19" >Appendix E Comparison Between Embedded SQL and ODBC</A>
<UL>
<LI>
<A HREF="#E10E123" >ODBC to Embedded SQL</A>
<LI>
<A HREF="#E10E124" >Embedded SQL to ODBC</A>
<UL>
<LI>
<A HREF="#E11E505" >Declarative Statements</A>
<LI>
<A HREF="#E11E506" >Data Definition Statements</A>
<LI>
<A HREF="#E11E507" >Data Manipulation Statements</A>
<LI>
<A HREF="#E11E508" >Dynamic SQL Statements</A>
<LI>
<A HREF="#E11E509" >Transaction Control Statements</A>
<LI>
<A HREF="#E11E510" >Association Management Statements</A>
<LI>
<A HREF="#E11E511" >Diagnostic Statement</A></UL></UL></UL>
<HR ALIGN=CENTER>
<A NAME="E9E19"></A>
<H1>
<FONT FACE="Arial"><B>APPENDIX E COMPARISON BETWEEN EMBEDDED SQL AND ODBC</B><A NAME="I2"></A></FONT></H1>
<BR>
<BLOCKQUOTE>
<P>This appendix compares ODBC and embedded SQL.
</BLOCKQUOTE>
<A NAME="E10E123"></A>
<H2>
<FONT FACE="Arial"><B>ODBC to Embedded SQL</B><A NAME="I3"></A><A NAME="I4"></A><A NAME="I5"></A><A NAME="I6"></A></FONT></H2>
<BLOCKQUOTE>
<P>The following table compares core ODBC functions to embedded SQL statements. This comparison is based on the X/Open and SQL Access Group SQL CAE specification (1992).<A NAME="I7"></A><A NAME="I8"></A><A NAME="I9"></A>
</BLOCKQUOTE>
<BLOCKQUOTE>
<P>ODBC uses a parameter marker in place of a host variable, wherever a host variable would occur in embedded SQL.<A NAME="I10"></A>
</BLOCKQUOTE>
<BLOCKQUOTE>
<P>The SQL language is based on the X/Open and SQL Access Group SQL CAE specification (1992).
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>ODBC Function</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3333"></A>
<P>Statement
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3333"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLAllocEnv</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3334"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3334"></A>
<P>Driver Manager and driver memory allocation.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLAllocConnect</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3335"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3335"></A>
<P>Driver Manager and driver memory allocation.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLConnect</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3336"></A>
<P>CONNECT
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3336"></A>
<P>Association management.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLAllocStmt</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3337"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3337"></A>
<P>Driver Manager and driver memory allocation.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLPrepare</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3338"></A>
<P>PREPARE
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3338"></A>
<P>The prepared SQL string can contain any of the valid preparable functions as defined by the X/Open specification, including ALTER, CREATE, <I>cursor-specification</I>, searched DELETE, dynamic SQL positioned DELETE, DROP, GRANT, INSERT, REVOKE, searched UPDATE, or dynamic SQL positioned UPDATE. </TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLBindParameter</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3339"></A>
<P>SET DESCRIPTOR
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3339"></A>
<P>Dynamic SQL ALLOCATE DESCRIPTOR and dynamic SQL SET DESCRIPTOR. ALLOCATE DESCRIPTOR would normally be issued on the first call to <B>SQLBindParameter</B> for an <I>hstmt</I>. Alternatively, ALLOCATE DESCRIPTOR can be called during <B>SQLAllocStmt</B>, although this call would be unneeded by SQL statements containing no embedded parameters. The descriptor name is generated by the driver.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLSetCursorName</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3340"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3340"></A>
<P>The specified cursor name is used in the DECLARE CURSOR statement generated by <B>SQLExecute</B> or <B>SQLExecDirect</B>.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLGetCursorName</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3341"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3341"></A>
<P>Driver cursor name management.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLExecute</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3342"></A>
<P>EXECUTE or DECLARE CURSOR and OPEN CURSOR
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3342"></A>
<P>Dynamic SQL EXECUTE. If the SQL statement requires a cursor, then a dynamic SQL DECLARE CURSOR statement and a dynamic SQL OPEN are issued at this time.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLExecDirect</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3343"></A>
<P>EXECUTE IMMEDIATE or DECLARE CURSOR and OPEN CURSOR
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3343"></A>
<P>The ODBC function call provides for support for a <I>cursor specification</I> and statements allowed in an EXECUTE IMMEDIATE dynamic SQL statement. In the case of a <I>cursor </I><I>specification</I>, the call corresponds to static SQL DECLARE CURSOR and OPEN statements.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLNumResultCols</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3344"></A>
<P>GET DESCRIPTOR
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3344"></A>
<P>COUNT form of dynamic SQL GET DESCRIPTOR.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLColAttributes</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3345"></A>
<P>GET DESCRIPTOR
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3345"></A>
<P>COUNT form of dynamic SQL GET DESCRIPTOR or VALUE form of dynamic SQL GET DESCRIPTOR with <I>field-name</I> in {NAME, TYPE, LENGTH, PRECISION, SCALE, NULLABLE}.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLDescribeCol</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3346"></A>
<P>GET DESCRIPTOR
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3346"></A>
<P>VALUE form of dynamic SQL GET DESCRIPTOR with <I>field-name</I> in {NAME, TYPE, LENGTH, PRECISION, SCALE, NULLABLE}.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLBindCol</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3347"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3347"></A>
<P>This function establishes output buffers that correspond in usage to host variables for static SQL FETCH, and to an SQL DESCRIPTOR for dynamic SQL FETCH <I>cursor</I> USING SQL DESCRIPTOR <I>descriptor</I>.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLFetch</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3348"></A>
<P>FETCH
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3348"></A>
<P>Static or dynamic SQL FETCH. If the call is a dynamic SQL FETCH, then the VALUE form of GET DESCRIPTOR is used, with <I>field-name</I> in {DATA, INDICATOR}. DATA and INDICATOR values are placed in output buffers specified in <B>SQLBindCol</B>.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLRowCount</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3349"></A>
<P>GET DIAGNOSTICS
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3349"></A>
<P>Requested field ROW_COUNT.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLFreeStmt</B> (SQL_CLOSE option)
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3350"></A>
<P>CLOSE
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3350"></A>
<P>Dynamic SQL CLOSE.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLFreeStmt</B> (SQL_DROP option)
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3351"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3351"></A>
<P>Driver Manager and driver memory deallocation.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLTransact</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3352"></A>
<P>COMMIT WORK or COMMIT ROLLBACK 
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3352"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLDisconnect</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3353"></A>
<P>DISCONNECT
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3353"></A>
<P>Association management.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLFreeConnect</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3354"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3354"></A>
<P>Driver Manager and driver memory deallocation.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLFreeEnv</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3355"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3355"></A>
<P>Driver Manager and driver memory deallocation.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLCancel</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3356"></A>
<P>none
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3356"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=140 VALIGN=top >
<BLOCKQUOTE>
<P><B>SQLError</B>
</BLOCKQUOTE></TD>
<TD WIDTH=153 VALIGN=top >
<A NAME="E7E3357"></A>
<P>GET DIAGNOSTICS
</TD><TD WIDTH=166 VALIGN=top >
<A NAME="E7E3357"></A>
<P>GET DIAGNOSTICS retrieves information from the SQL diagnostics area that pertains to the most recently executed SQL statement. This information can be retrieved following execution and preceding the deallocation of the statement.</TD></TR></TABLE>
<A NAME="E10E124"></A>
<H2>
<FONT FACE="Arial"><B>Embedded SQL to ODBC</B><A NAME="I11"></A><A NAME="I12"></A><A NAME="I13"></A><A NAME="I14"></A><A NAME="I15"></A></FONT></H2>
<BLOCKQUOTE>
<P>The following tables list the relationship between the X/Open Embedded SQL language and corresponding ODBC functions. The section number shown in the first column of each table refers to the section of the X/Open and SQL Access Group SQL CAE specification (1992).
</BLOCKQUOTE>
<A NAME="E11E505"></A>
<H3>
<FONT FACE="Arial">Declarative Statements<A NAME="I16"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists declarative statements.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3358"></A>
<P>SQL Statement
</TD><TD WIDTH=124 VALIGN=top >
<A NAME="E7E3358"></A>
<P>ODBC Function
</TD><TD WIDTH=129 VALIGN=top >
<A NAME="E7E3358"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>4.3.1
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3359"></A>
<P>Static SQL DECLARE CURSOR
</TD><TD WIDTH=124 VALIGN=top >
<A NAME="E7E3359"></A>
<P>none
</TD><TD WIDTH=129 VALIGN=top >
<A NAME="E7E3359"></A>
<P>Issued implicitly by the driver if a <I>cursor </I><I>specification</I> is passed to <B>SQLExecDirect</B>.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>4.3.2
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3360"></A>
<P>Dynamic SQL DECLARE CURSOR
</TD><TD WIDTH=124 VALIGN=top >
<A NAME="E7E3360"></A>
<P>none
</TD><TD WIDTH=129 VALIGN=top >
<A NAME="E7E3360"></A>
<P>Cursor is generated automatically by the driver. To set a name for the cursor, use <B>SQLSetCursorName</B>. To retrieve a cursor name, use <B>SQLGetCursorName</B>.</TD></TR></TABLE>
<A NAME="E11E506"></A>
<H3>
<FONT FACE="Arial">Data Definition Statements<A NAME="I17"></A><A NAME="I18"></A><A NAME="I19"></A><A NAME="I20"></A><A NAME="I21"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists data definition statements.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3361"></A>
<P>SQL Statement
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3361"></A>
<P>ODBC Function
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3361"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.1.2
<BR>5.1.3
<BR>5.1.4
<BR>5.1.5
<BR>5.1.6
<BR>5.1.7
<BR>5.1.8
<BR>5.1.9
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3362"></A>
<P>ALTER TABLE
<BR>CREATE INDEX
<BR>CREATE TABLE
<BR>CREATE VIEW
<BR>DROP INDEX
<BR>DROP TABLE
<BR>DROP VIEW
<BR>GRANT
<BR>REVOKE
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3363"></A>
<P><B>SQLPrepare</B>,
<BR><B>SQLExecute</B>,
<BR>or <B>SQLExecDirect</B>
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3364"></A>
<P>None.</TD></TR></TABLE>
<A NAME="E11E507"></A>
<H3>
<FONT FACE="Arial">Data Manipulation Statements<A NAME="I22"></A><A NAME="I23"></A><A NAME="I24"></A><A NAME="I25"></A><A NAME="I26"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists data manipulation statements.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3365"></A>
<P>SQL Statement
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3365"></A>
<P>ODBC Function
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3365"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.1
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3366"></A>
<P>CLOSE
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3366"></A>
<P><B>SQLFreeStmt</B> (SQL_CLOSE option)
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3366"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.2
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3367"></A>
<P>Positioned DELETE
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3367"></A>
<P><B>SQLExecDirect</B>(...,
<BR>&quot;DELETE FROM <I>table-name</I> WHERE CURRENT OF <I>cursor-name</I>&quot;)
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3368"></A>
<P>Driver-generated <I>cursor-name</I> can be obtained by calling <B>SQLGetCursorName</B>.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.3
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3369"></A>
<P>Searched DELETE
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3369"></A>
<P><B>SQLExecDirect</B>(..., &quot;DELETE FROM <I>table-name</I> WHERE <I>search-condition</I>&quot;)
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3369"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.4
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3370"></A>
<P>FETCH
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3370"></A>
<P><B>SQLFetch</B>
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3370"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.5
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3371"></A>
<P>INSERT
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3371"></A>
<P><B>SQLExecDirect</B> (...,&quot;INSERT INTO <I>table-name</I> ...&quot;)
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3371"></A>
<P>Can also be invoked by <B>SQLPrepare</B> and <B>SQLExecute</B>.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.6
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3372"></A>
<P>OPEN
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3372"></A>
<P>none
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3372"></A>
<P>Cursor is OPENed implicitly by <B>SQLExecute</B> or <B>SQLExecDirect</B> when a SELECT statement is specified.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.7
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3373"></A>
<P>SELECT ...INTO
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3373"></A>
<P>none
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3373"></A>
<P>Not supported.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.8
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3374"></A>
<P>Positioned UPDATE
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3374"></A>
<P><B>SQLExecDirect</B>(...,
<BR>&quot;UPDATE <I>table-name</I> SET <I>column-identifier</I> = <I>expression</I> ...WHERE CURRENT OF <I>cursor-name</I>&quot;)
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3375"></A>
<P>Driver-generated <I>cursor-name</I> can be obtained by calling <B>SQLGetCursorName</B>.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.2.9
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3376"></A>
<P>Searched UPDATE
</TD><TD WIDTH=123 VALIGN=top >
<A NAME="E7E3376"></A>
<P><B>SQLExecDirect</B>(..., &quot;UPDATE <I>table-name</I> SET <I>column-identifier</I> = <I>expression</I> ...WHERE <I>search-condition</I>&quot;)
</TD><TD WIDTH=130 VALIGN=top >
<A NAME="E7E3376"></A>
<P>None.</TD></TR></TABLE>
<A NAME="E11E508"></A>
<H3>
<FONT FACE="Arial">Dynamic SQL Statements<A NAME="I27"></A><A NAME="I28"></A><A NAME="I29"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists dynamic SQL statements.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3377"></A>
<P>SQL Statement
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3377"></A>
<P>ODBC Function
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3377"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3 
<BR>(see 5.2.1)
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3378"></A>
<P>Dynamic SQL <B>CLOSE</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3378"></A>
<P><B>SQLFreeStmt </B>(SQL_CLOSE option)
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3378"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3(see5.2.2)
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3379"></A>
<P>Dynamic SQL Positioned DELETE 
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3379"></A>
<P><B>SQLExecDirect</B>(...,
<BR>&quot;DELETE FROM <I>table-name</I> WHERE CURRENT OF <I>cursor-name</I>&quot;)
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3380"></A>
<P>Can also be invoked by <B>SQLPrepare</B> and <B>SQLExecute</B>.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3(see5.2.8)
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3381"></A>
<P>Dynamic SQL Positioned UPDATE 
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3381"></A>
<P><B>SQLExecDirect</B>(...,
<BR>&quot;UPDATE <I>table-name</I> SET <I>column-identifier</I> = <I>expression</I> ...WHERE<B> </B>CURRENT<B> </B>OF<B> </B><I>cursor-name</I>&quot;)
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3382"></A>
<P>Can also be invoked by <B>SQLPrepare</B> and <B>SQLExecute</B>.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.3
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3383"></A>
<P>ALLOCATE DESCRIPTOR
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3383"></A>
<P>None
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3383"></A>
<P>Descriptor information is implicitly allocated and attached to the <I>hstmt</I> by the driver. Allocation occurs at either the first call to <B>SQLBindParameter</B> or at <B>SQLExecute</B> or <B>SQLExecDirect</B> time.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.4
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3384"></A>
<P>DEALLOCATE DESCRIPTOR
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3384"></A>
<P><B>SQLFreeStmt</B> (SQL_DROP option)
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3384"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.5
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3385"></A>
<P>DESCRIBE
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3385"></A>
<P>none
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3385"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.6
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3386"></A>
<P>EXECUTE
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3386"></A>
<P><B>SQLExecute</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3386"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.7
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3387"></A>
<P>EXECUTE IMMEDIATE
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3387"></A>
<P><B>SQLExecDirect</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3387"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.8
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3388"></A>
<P>Dynamic SQL FETCH
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3388"></A>
<P><B>SQLFetch</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3388"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.9
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3389"></A>
<P>GET DESCRIPTOR
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3389"></A>
<P><B>SQLNumResultCols</B>
<BLOCKQUOTE>
<P><B>SQLDescribeCol</B>
<BR><B>SQLColAttributes</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3390"></A>
<P>COUNT FORM.
<BLOCKQUOTE>
<P>VALUE form with <I>field-name</I> in {NAME, TYPE, LENGTH, PRECISION, SCALE, NULLABLE}.</TD>
</TR>
</BLOCKQUOTE>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.10
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3391"></A>
<P>Dynamic SQL OPEN
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3391"></A>
<P><B>SQLExecute</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3391"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.11
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3392"></A>
<P>PREPARE
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3392"></A>
<P><B>SQLPrepare</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3392"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.3.12
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3393"></A>
<P>SET DESCRIPTOR
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3393"></A>
<P><B>SQLBindParameter</B>
</TD><TD WIDTH=126 VALIGN=top >
<A NAME="E7E3393"></A>
<P><B>SQLBindParameter</B> is associated with only one <I>hstmt</I> where a descriptor is applied to any number of statements with USING SQL DESCRIPTOR.</TD></TR></TABLE>
<A NAME="E11E509"></A>
<H3>
<FONT FACE="Arial">Transaction Control Statements<A NAME="I30"></A><A NAME="I31"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists transaction control statements.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3394"></A>
<P>SQL Statement
</TD><TD WIDTH=156 VALIGN=top >
<A NAME="E7E3394"></A>
<P>ODBC Function
</TD><TD WIDTH=97 VALIGN=top >
<A NAME="E7E3394"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.4.1
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3395"></A>
<P>COMMIT WORK
</TD><TD WIDTH=156 VALIGN=top >
<A NAME="E7E3395"></A>
<P><B>SQLTransact</B> (SQL_COMMIT option)
</TD><TD WIDTH=97 VALIGN=top >
<A NAME="E7E3395"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.4.2
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3396"></A>
<P>ROLLBACK WORK
</TD><TD WIDTH=156 VALIGN=top >
<A NAME="E7E3396"></A>
<P><B>SQLTransact</B> (SQL_ROLLBACK option)
</TD><TD WIDTH=97 VALIGN=top >
<A NAME="E7E3396"></A>
<P>None.</TD></TR></TABLE>
<A NAME="E11E510"></A>
<H3>
<FONT FACE="Arial">Association Management Statements<A NAME="I32"></A><A NAME="I33"></A><A NAME="I34"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists association management statements.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3397"></A>
<P>SQL Statement
</TD><TD WIDTH=120 VALIGN=top >
<A NAME="E7E3397"></A>
<P>ODBC Function
</TD><TD WIDTH=133 VALIGN=top >
<A NAME="E7E3397"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.5.1
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3398"></A>
<P>CONNECT
</TD><TD WIDTH=120 VALIGN=top >
<A NAME="E7E3398"></A>
<P><B>SQLConnect</B>
</TD><TD WIDTH=133 VALIGN=top >
<A NAME="E7E3398"></A>
<P>None.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.5.2
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3399"></A>
<P>DISCONNECT
</TD><TD WIDTH=120 VALIGN=top >
<A NAME="E7E3399"></A>
<P><B>SQLDisconnect</B>
</TD><TD WIDTH=133 VALIGN=top >
<A NAME="E7E3399"></A>
<P>ODBC does not support DISCONNECT ALL.</TD>
</TR>
<TR>
<TD WIDTH=80 VALIGN=top >
<BLOCKQUOTE>
<P>5.5.3
</BLOCKQUOTE></TD>
<TD WIDTH=126 VALIGN=top >
<A NAME="E7E3400"></A>
<P>SET CONNECTION
</TD><TD WIDTH=120 VALIGN=top >
<A NAME="E7E3400"></A>
<P>None
</TD><TD WIDTH=133 VALIGN=top >
<A NAME="E7E3400"></A>
<P>The SQL Access Group (SAG) Call Level Interface allows for multiple simultaneous connections to be established, but only one connection to be active at one time. SAG-compliant drivers track which connection is active, and automatically switch to a different connection if a different connection handle is specified. However, the active connection must be in a state that allows the connection context to be switched, in other words, there must not be a transaction in progress on the current connection.
<BLOCKQUOTE>
<P>Drivers that are not SAG-compliant are not required to support this behavior. That is, drivers that are not SAG-compliant are not required to return an error if the driver and its associated data source can simultaneously support multiple active connections.</TD></TR></BLOCKQUOTE></TABLE>
<A NAME="E11E511"></A>
<H3>
<FONT FACE="Arial">Diagnostic Statement<A NAME="I35"></A><A NAME="I36"></A></FONT></H3>
<BLOCKQUOTE>
<P>The following table lists the GET DIAGNOSTIC statement.
</BLOCKQUOTE>
<TABLE WIDTH=800 >
<TR>
<TD WIDTH=73 VALIGN=top >
<BLOCKQUOTE>
<P><B>Section</B>
</BLOCKQUOTE></TD>
<TD WIDTH=128 VALIGN=top >
<A NAME="E7E3401"></A>
<P>SQL Statement
</TD><TD WIDTH=111 VALIGN=top >
<A NAME="E7E3401"></A>
<P>ODBC Function
</TD><TD WIDTH=146 VALIGN=top >
<A NAME="E7E3401"></A>
<P>Comments</TD>
</TR>
<TR>
<TD WIDTH=73 VALIGN=top >
<BLOCKQUOTE>
<P>5.6.1
</BLOCKQUOTE></TD>
<TD WIDTH=128 VALIGN=top >
<A NAME="E7E3402"></A>
<P>GET DIAGNOSTICS
</TD><TD WIDTH=111 VALIGN=top >
<A NAME="E7E3402"></A>
<P><B>SQLError</B> 
<BR><B>SQLRowCount</B>
</TD><TD WIDTH=146 VALIGN=top >
<A NAME="E7E3403"></A>
<P>For <B>SQLError</B>, the following fields from the diagnostics area are available: RETURNED_SQLSTATE, MESSAGE_TEXT, and MESSAGE_LENGTH. For <B>SQLRowCount</B>, the ROW_COUNT field is available.</TD></TR></TABLE>
<P ALIGN=CENTER>
<A HREF="prguid28.htm" TARGET="_self"><IMG SRC="graprev.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Previous Page"></A>
<A HREF="httoc.htm" TARGET="_self"><IMG SRC="gratoc.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="TOC"></A>
<A HREF="htindex.htm" TARGET="_self"><IMG SRC="graindex.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Index"></A>
<A HREF="prguid30.htm" TARGET="_self"><IMG SRC="granext.gif" WIDTH = 32 HEIGHT = 32 BORDER = 0 ALT="Next Page"></A>

<center><p><font SIZE=-2>Copyright &copy; 1992-1997 Solid Information Technology Ltd All rights reserved.</font></p></center>
</BODY></HTML>