OCI_oparse

function

Library: Oracle Call Interface database support (OMOCI legacy)
Include: omoci.xin

Returns: OCI_SUCCESS if the function completes without error.

Declaration

define external integer function OCI_oparse
   (  value OCI_Handle_type cursor,
      value string sqlstm,
      value integer sqllen,
      value integer defflg,
      value integer lngflg
   )

Purpose

This function parses an SQL statement or a PL/SQL block and associates it with a cursor. The parse can, optionally, be deferred.

Input arguments:

cursor -- Cursor data area descriptor.
sqlstm -- The SQL statement.
sqllen -- The length of the contents of sqlstm or OCI_NTS.
defflg -- Deferred parsing flag. The following values are allowed:
- OCI_DEFERRED -- Defer the parse of the SQL statement until execution. This is the preferred method.
- OCI_NODEFERRED -- Parse the SQL statement immediately.
lngflg -- ANSI conformance flag. The following values are allowed:
- OCI_ORACLE_V6 -- Specifies Oracle Version 6 behavior.
- OCI_ORACLE_V7 -- Specifies Oracle Version 7 behavior.
- OCI_ORACLE_DEFAULT -- Specifies behavior dependent on the connected database.

Example:

  set RetCode to OCI_oparse
     (  Cursor,
        "insert into Midi values ( 4, :Midi )",
        OCI_NTS,
        OCI_NODEFERRED,
        OCI_ORACLE_V7
     )