OpenEdge Data Management: DataServer for Microsoft SQL Server

RDBMS stored procedure basics
RDBMS stored procedure basics
In the OpenEdge environment, you can think of a stored procedure definition as having two
basic, interrelated parts:
• Execution controls to run and close a store procedure — Comprises the information
needed to execute a stored procedure request against the MS S data source. At a minimum,
all stored procedures discussed in this guide are assessable using the RUN
STORED-PROCEDURE statement.
• Language elements that enable access to specific data results — Qualifies the retrieved
data, or result sets, that the stored procedure’s execution returns. Various keywords,
phrases, statements, and syntax elements support different retrieval options for stored
procedure output. This part of the stored procedure implementation reflects your analysis
of your data needs; based on this analysis, you determine the additional syntax elements
you need to define the output elements and data results you want retrieved.
Table 3–1 identifies and briefly introduces the elements that comprise a stored procedure
definition; each of these elements is also more fully discussed later in this chapter.
Table 3–1: Stored procedure language elements
ABL language element Description
RUN STORED–PROCEDURE statement Executes a stored procedure
PROC–HANDLE phrase Allows you to specify a handle to identify
a stored procedure
PROC–STATUS phrase Reads the return value
LOAD-RESULT-INTO phrase Allows data from a result set that is
returned for a foreign data source to be put
into one or more temp-tables
PARAM phrase Identifies run-time parameters to be passed
to and/or from the stored procedure
CLOSE STORED–PROCEDURE statement Enables the values to be retrieved from the
output parameters that you defined for the
stored procedure, finalizes result sets data
processing, and tells OpenEdge that the
stored procedure has ended
Note: You can substitute the abbreviations RUN STORED–PROC and CLOSE STORED–PROC for the
full names RUN STORED–PROCEDURE and CLOSE STORED–PROCEDURE, respectively. The
remainder of this guide generally uses the abbreviated form.
See the “Run Stored-Procedure details” section on page 3–6 for more details about the reference
entries presented in Table 3–1.
3–3