Using SQL Adapters with Ensemble - InterSystems Documentation

c. Parameters as appropriate for the query and for the method (see next section).Executing QueriesIf you did not provide a snapshot instance, the method returns a result set. If you did pass a snapshotinstance to the method, the method creates a new result set, uses it to populate your snapshot instance(using the values of the FirstRow and MaxRowsToGet properties to choose the rows), and then returnsthe snapshot.5.3.2 Syntax for the MethodsTo execute a query, use one of the following methods:ExecuteQueryMethod ExecuteQuery(ByRef pRS As EnsLib.SQL.GatewayResultSet,pQueryStatement As %String,pParms...) As %StatusExecutes a query. You provide a query string and any number of parameters. The result isreturned by reference in the first argument; the result is an instance ofEnsLib.SQL.GatewayResultSet or EnsLib.SQL.Snapshot as described previously.The second argument is the query statement to execute. This statement can include the standardSQL ? to represent replaceable parameters. Note that the statement should not use UPDATE.ExecuteQueryParmArrayMethod ExecuteQueryParmArray(ByRef pRS As EnsLib.SQL.GatewayResultSet,pQueryStatement As %String,ByRef pParms) As %StatusExecutes a query. This method is similar to the preceding method with the exception of howparameters are specified. For this method, you specify the parameters in a Caché multidimensionalarray (pParms), as described in “Specifying Parameters in a Caché MultidimensionalArray,” earlier in this chapter.Use the ExecuteQueryParmArray method if you need to specify parameters and if theODBC driver that you are using does not support the ODBC SQLDescribeParam function.5.3.3 ExampleThe following shows an example method that executes a query:Using SQL Adapters with Ensemble 39