Difference between revisions of "SQLMORERESULTS()"

From Lianjapedia
Jump to: navigation, search
m (Text replace - "Recital" to "Lianja")
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Check if more results sets are available and if so, copy next results set to a cursor
 
Check if more results sets are available and if so, copy next results set to a cursor
 
  
 
==Syntax==
 
==Syntax==
 
SQLMORERESULTS(<nStatementHandle>)
 
SQLMORERESULTS(<nStatementHandle>)
 
  
 
==See Also==
 
==See Also==
 
[[CREATE CONNECTION]], [[SQLCANCEL()]], [[SQLCOLUMNS()]], [[SQLCOMMIT()]], [[SQLCONNECT()]], [[SQLDISCONNECT()]], [[SQLERROR()]], [[SQLEXEC()]], [[SQLGETPROP()]], [[SQLPREPARE()]], [[SQLROLLBACK()]], [[SQLSETPROP()]], [[SQLSTRINGCONNECT()]], [[SQLTABLES()]]
 
[[CREATE CONNECTION]], [[SQLCANCEL()]], [[SQLCOLUMNS()]], [[SQLCOMMIT()]], [[SQLCONNECT()]], [[SQLDISCONNECT()]], [[SQLERROR()]], [[SQLEXEC()]], [[SQLGETPROP()]], [[SQLPREPARE()]], [[SQLROLLBACK()]], [[SQLSETPROP()]], [[SQLSTRINGCONNECT()]], [[SQLTABLES()]]
 
  
 
==Description==
 
==Description==
Line 15: Line 12:
  
 
The SQLMORERESULTS() function operates on the data source specified by <nStatementHandle>.
 
The SQLMORERESULTS() function operates on the data source specified by <nStatementHandle>.
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 23: Line 19:
 
|-
 
|-
 
|}
 
|}
 
  
 
====Valid Return values:====
 
====Valid Return values:====
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 42: Line 36:
 
|-
 
|-
 
|}
 
|}
 
  
 
SQLMORERESULTS() always returns 2.
 
SQLMORERESULTS() always returns 2.
 
  
 
==Example==
 
==Example==
Line 61: Line 53:
 
endif
 
endif
 
</code>
 
</code>
 
 
==Products==
 
==Products==
 
Lianja, Lianja Server
 
Lianja, Lianja Server

Revision as of 11:16, 11 December 2012

Purpose

Check if more results sets are available and if so, copy next results set to a cursor

Syntax

SQLMORERESULTS(<nStatementHandle>)

See Also

CREATE CONNECTION, SQLCANCEL(), SQLCOLUMNS(), SQLCOMMIT(), SQLCONNECT(), SQLDISCONNECT(), SQLERROR(), SQLEXEC(), SQLGETPROP(), SQLPREPARE(), SQLROLLBACK(), SQLSETPROP(), SQLSTRINGCONNECT(), SQLTABLES()

Description

The SQLMORERESULTS() function is used in non-BatchMode to check whether more results sets are available and if so, to copy the next results set to a cursor. BatchMode is set using the SQLSETPROP() function. BatchMode is always True and cannot be used to return results sets individually. It is included for compatibility reasons only.

The SQLMORERESULTS() function operates on the data source specified by <nStatementHandle>.

Keywords Description
nStatementHandle The workarea in which the gateway data source is open

Valid Return values:

Return Value Description
2 No more data found
1 SQL statement has finished executing
0 SQL statement is still executing
–1 Connection error
–2 Environment error

SQLMORERESULTS() always returns 2.

Example

nStatHand=SQLSTRINGCONNECT("rec@rec1:user1/pass1-southwind.tcpip",.T.)
if nStatHand < 1
  messagebox('Cannot make connection', 16, 'SQL Connect Error')
else
  messagebox('Connection made', 48, 'SQL Connect Message')
  store "00010" to myVar
  SQLEXEC(nStatHand, "SELECT * FROM example WHERE account_no = ?myVar", "restab")
  display all
  SQLMORERESULTS(nStatHand)
  SQLDISCONNECT(nStatHand)
endif

Products

Lianja, Lianja Server