UniBasic Commands Reference - Rocket Software
UniBasic Commands Reference - Rocket Software UniBasic Commands Reference - Rocket Software
SQLBindCol Syntax status = SQLBindCol (statement.env, col#, data.type, column) Note: This function is case-sensitive. If you want it to be case-insensitive, you must compile your programs using the BASIC command with the -i option. Description Use this function to tell UniData BCI where to return the results of an SQLFetch call. SQLBindCol defines the name of the variable (column) to contain column results retrieved by SQLFetch, and specifies the data conversion (data.type) on the fetched data. SQLBindCol has no effect until SQLFetch is used. Normally you call SQLBindCol once for each column of data in the result set. When SQLFetch is issued, data is moved from the result set at the data source and put into the variables specified in the SQLBindCol call, overwriting existing variable contents. Data is converted from the SQL data type at the data source to the UniBasic data type requested by the SQLBindCol call, if possible. If data cannot be converted to data.type, an error occurs. Values are returned only for bound columns. Unbound columns are ignored and are not accessible. For example, if a SELECT command returns three columns, but SQLBindCol was called for only two columns, data from the third column is not accessible to your program. If you bind more variables than there are columns in the result set, an error is returned. If you bind no columns and an SQLFetch is issued, the cursor advances to the next row of results. You need not use SQLBindCol with SQL statements that do not produce result sets. 1-786 UniBasic Commands Reference
Parameters The following table describes each parameter of the syntax. Parameter Description statement.env SQL statement environment of the executed SQL statement. col# Column number of result data, starting at 1. This value must be from 1 to the number of columns returned in an operation. data.type BASIC data type into which to convert the incoming data. Possible values are the following: SQL.B.CHAR – Character string data. SQL.B.BINARY – Bit string (raw) data. SQL.B.NUMBER – Numeric data (integer or double). SQL.B.DEFAULT – SQL data type determines the BASIC data type. SQL.B.INTDATE – UniData date in internal format. SQL.B.INTTIME – UniData time in internal format. column Variable that will contain column results obtained with SQLFetch. SQLBindCol Parameters Return Values The following table describes the return values of the SQLBindCol function. Return Value Description 0 SQL.SUCCESS −1 SQL.ERROR −2 SQL.INVALID.HANDLE SQLBindCol Return Values SQLBindCol 1-787
- Page 778 and 779: setSocketOptions Syntax setSocketOp
- Page 780 and 781: showSecurityContext Syntax showSecu
- Page 782 and 783: SIGNATURE Syntax SIGNATURE(algorith
- Page 784 and 785: Return Code Status 1-742 UniBasic C
- Page 786 and 787: SLEEP Syntax SLEEP [hh:mm[:ss]] [se
- Page 788 and 789: SMUL Syntax SMUL(x, y) Description
- Page 790 and 791: Return Codes The return code indica
- Page 792 and 793: The following table describes each
- Page 794 and 795: SOAPGetDefault Syntax SOAPGetDefaul
- Page 796 and 797: SOAPGetFault Syntax SOAPGetFault(re
- Page 798 and 799: SOAPGetResponseHeader Syntax SOAPGe
- Page 800 and 801: SOAPRequestWrite Syntax SOAPRequest
- Page 802 and 803: SOAPSetDefault Syntax SOAPSetDefaul
- Page 804 and 805: Along with SOAPSetDefault, the Call
- Page 806 and 807: Return Codes The return code indica
- Page 808 and 809: Return Codes The return code indica
- Page 810 and 811: Return Codes The return code indica
- Page 812 and 813: You can also use the UniBasic STATU
- Page 814 and 815: Return Codes The return code indica
- Page 816 and 817: SOUNDEX Syntax SOUNDEX(expr) Descri
- Page 818 and 819: SPACE Syntax SPACE(expr) Descriptio
- Page 820 and 821: SPLICE Syntax SPLICE(expr1,"expr",
- Page 822 and 823: SQLAllocConnect Syntax status = SQL
- Page 824 and 825: SQLAllocEnv Syntax status = SQLAllo
- Page 826 and 827: SQLAllocStmt Syntax status = SQLAll
- Page 830 and 831: SQLBindParameter Syntax status = SQ
- Page 832 and 833: Parameters The following table desc
- Page 834 and 835: SQLCancel Syntax status = SQLCancel
- Page 836 and 837: SQLColAttributes Syntax status = SQ
- Page 838 and 839: 1-796 UniBasic Commands Reference C
- Page 840 and 841: SQLColumns Syntax status = SQLColum
- Page 842 and 843: Return Values The following table d
- Page 844 and 845: Parameter Description Return Values
- Page 846 and 847: Parameter Description Return Values
- Page 848 and 849: Return Values The following table d
- Page 850 and 851: ODBC Data Sources When a program is
- Page 852 and 853: SQLExecDirect Syntax status = SQLEx
- Page 854 and 855: Parameter Description Return Values
- Page 856 and 857: SQLExecute tells the data source to
- Page 858 and 859: Return Values The following table d
- Page 860 and 861: Return Values The following table d
- Page 862 and 863: Return Values The following table d
- Page 864 and 865: Parameters The following table desc
- Page 866 and 867: SQLGetInfo Syntax status = SQLGetIn
- Page 868 and 869: 1-826 UniBasic Commands Reference S
- Page 870 and 871: Return Values The following table l
- Page 872 and 873: Parameters The following table desc
- Page 874 and 875: 1-832 UniBasic Commands Reference C
- Page 876 and 877: SQLNumParams Syntax status = SQLNum
Parameters<br />
The following table describes each parameter of the syntax.<br />
Parameter Description<br />
statement.env SQL statement environment of the executed SQL statement.<br />
col# Column number of result data, starting at 1. This value must be from 1<br />
to the number of columns returned in an operation.<br />
data.type BASIC data type into which to convert the incoming data. Possible<br />
values are the following:<br />
SQL.B.CHAR – Character string data.<br />
SQL.B.BINARY – Bit string (raw) data.<br />
SQL.B.NUMBER – Numeric data (integer or double).<br />
SQL.B.DEFAULT – SQL data type determines the BASIC data type.<br />
SQL.B.INTDATE – UniData date in internal format.<br />
SQL.B.INTTIME – UniData time in internal format.<br />
column Variable that will contain column results obtained with SQLFetch.<br />
SQLBindCol Parameters<br />
Return Values<br />
The following table describes the return values of the SQLBindCol function.<br />
Return Value Description<br />
0 SQL.SUCCESS<br />
−1 SQL.ERROR<br />
−2 SQL.INVALID.HANDLE<br />
SQLBindCol Return Values<br />
SQLBindCol 1-787