BackUp LevelNext

CFSTOREDPROC

The CFSTOREDPROC tag is the main tag used for executing stored procedures via an ODBC or native connection to a server database. It specifies database connection information and identifies the stored procedure.

Syntax

<CFSTOREDPROC PROCEDURE="procedure name"
    DATASOURCE="ds_name"
    USERNAME="username"
    PASSWORD="password"
    DBSERVER="dbms"
    DBNAME="database name"
    BLOCKFACTOR="blocksize"
    PROVIDER="COMProvider" 
    PROVIDERDSN="datasource" 
    DEBUG="Yes/No"
    RETURNCODE="Yes/No">

PROCEDURE

Required. Specifies the name of the stored procedure on the database server.

DATASOURCE

Required. The name of an ODBC or native data source that points to the database containing the stored procedure.

USERNAME

Optional. If specified, USERNAME overrides the username value specified in the data source setup.

PASSWORD

Optional. If specified, PASSWORD overrides the password value specified in the data source setup.

DBSERVER

Optional. For native database drivers, specifies the name of the database server machine. If specified, DBSERVER overrides the server specified in the data source.

DBNAME

Optional. The database name (Sybase System 11 driver only). If specified, DBNAME overrides the default database specified in the data source.

BLOCKFACTOR

Optional. Specifies the maximum number of rows to fetch at a time from the server. The range is 1 (default) to 100. The ODBC driver may dynamically reduce the block factor at runtime.

PROVIDER

Optional. COM provider (OLE-DB only).

PROVIDERDSN

Optional. Data source name for the COM provider (OLE-DB only).

DEBUG

Optional. Yes or No. Specifies whether debug info will be listed on each statement. Default is No.

RETURNCODE

Optional. Yes or No. Specifies whether the tag populates CFSTOREDPROC.STATUSCODE with the status code returned by the stored procedure. Default is No.

Usage

Within a CFSTOREDPROC tag, you code CFPROCRESULT and CFPROCPARAM tags as necessary.

If you set the ReturnCode parameter to "YES", CFSTOREDPROC sets a variable called CFSTOREDPROC.STATUSCODE, which indicates the status code for the stored procedure. Stored procedure status code values vary by DBMS. Refer to your DBMS-specific documentation for the meaning of individual status code values.

Stored procedures represent an advanced feature, found in high-end database management systems. You should be familiar with stored procedures and their usage before implementing these tags.




BackUp LevelNext

allaire

AllaireDoc@allaire.com
Copyright © 1998, Allaire Corporation. All rights reserved.