File: x331.htm

package info (click to toggle)
gnade 1.2.0-4
  • links: PTS
  • area: main
  • in suites: woody
  • size: 3,036 kB
  • ctags: 245
  • sloc: ada: 11,642; sh: 1,827; makefile: 591; sql: 422; awk: 29
file content (194 lines) | stat: -rw-r--r-- 3,583 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
<HTML
><HEAD
><TITLE
>Cursor Handling</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNADE User's Guide"
HREF="gnade.html"><LINK
REL="UP"
TITLE="Embedded SQL Syntax Specification"
HREF="esqlsyntax.html"><LINK
REL="PREVIOUS"
TITLE="Connection Handling"
HREF="x320.htm"><LINK
REL="NEXT"
TITLE="Mixing ODBC and embedded SQLcode "
HREF="x342.htm"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNADE User's Guide: GNADE, The GNat Ada Database Environment; Version 1.2.0; Document Revision $Revision: 1.26 $</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="x320.htm"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 11. Embedded SQL Syntax Specification</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="x342.htm"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN331"
>Cursor Handling</A
></H1
><P
>   A cursor is a declares a SQL query with its input and result 
   parameters. The result set is created when the cursor is opened.
   The syntax for declaring, opening and closing a cursor is shown
   below.
   </P
><PRE
CLASS="PROGRAMLISTING"
>      'DECLARE' &lt;name&gt; [ 'REOPENABLE' | 'LOCAL' ] 'CURSOR' 
      'FOR' &lt;sql query&gt;

      'OPEN' &lt;name&gt; 
      'CLOSE' &lt;name&gt; ['FINAL']
   </PRE
><P
>   LOCAL cursors are only defined within the scope of the block
   where the nearest DECLARE section is. If the scope is left,
   the cursor and the associated result set are deleted.
   </P
><DIV
CLASS="EXAMPLE"
><P
><B
>Example 11-4. Local Cursors</B
></P
><P
>      As shown in the example below, the cursor emp_cursor will only be 
      valid in the scope of the procedure Print_Departement:
      </P
><PRE
CLASS="PROGRAMLISTING"
>&#13;      procedure Print_Departement( ..........
              ... departement  : in Integer ) is

      EXEC SQL BEGIN DECLARE SECTION ;
      ....
      Depno                   : INT := INT( Departement );
      ....
      EXEC SQL END DECLARE SECTION ;
    begin
 
      EXEC SQL AT DB01
         DECLARE emp_cursor LOCAL CURSOR FOR
            SELECT EMPNO, FIRSTNAME, NAME, JOB, MANAGER, SALARY
            FROM employees
            WHERE deptno = :Depno ORDER BY EMPNO, NAME;
            .......
      </PRE
></DIV
><P
>   Normally it is not possible to open the same cursor twice. The 
   type REOPENABLE has been introduced, in order to allow the recursive 
   opening of cursors. This feature may also be emulated by means of 
   recursive procedures with local cursors.
   </P
><P
>   If the cursor type is omitted the cursor and its associated 
   result set to exist only once.
   </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="x320.htm"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnade.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="x342.htm"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Connection Handling</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="esqlsyntax.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Mixing ODBC and embedded SQLcode</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>