Difference between revisions of "CURSORNAME()"

From Recital Documentation Wiki
Jump to: navigation, search
(Class)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
 
 
==Purpose==
 
==Purpose==
 
Function to return the name of the cursor open in a workarea with an active gateway
 
Function to return the name of the cursor open in a workarea with an active gateway
Line 20: Line 18:
 
<code lang="recital">
 
<code lang="recital">
 
set gateway to "ora@sales:scott/tiger"
 
set gateway to "ora@sales:scott/tiger"
exec sql
+
declare employees;
  declare employees cursor for
+
  cursor for;
   select empno, ename, job
+
   select empno, ename, job;
   from emp
+
   from emp;
   order by deptno;
+
   order by deptno
  
exec sql
+
open employees
  open employees;
+
  
 
? cursorname()
 
? cursorname()
Line 35: Line 32:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[Category:SQL]]
 
[[Category:SQL]]
[[Category:Data Connectivity]]
+
[[Category:Remote Data Connectivity]]
[[Category:Data Connectivity Functions]]
+
[[Category:Remote Data Connectivity Functions]]

Latest revision as of 11:50, 22 June 2010

Purpose

Function to return the name of the cursor open in a workarea with an active gateway


Syntax

CURSORNAME([<workarea | alias>])


See Also

CLOSE, DECLARE CURSOR, DROP CURSOR, FETCH, FINDCURSOR(), GATEWAY(), OPEN


Description

The CURSORNAME() function returns the cursor name corresponding to the workarea specified by <workarea | alias>. If there is no cursor open, or no gateway active in the specified workarea then an empty string is returned. If no <workarea | alias> is specified then the CURSORNAME() function defaults to the current workarea.


Example

set gateway to "ora@sales:scott/tiger"
declare employees;
  cursor for;
  select empno, ename, job;
  from emp;
  order by deptno
 
open employees
 
? cursorname()
EMPLOYEES


Products

Recital Server, Recital