Send

The Send method provides a way to communicate with the databases.

Method Synopsis

Send($statement, $returnResults)

Parameters

$statement
Specifies any valid OQL statement.
$returnResults
Specifies whether to return results. This parameter takes one of the following values:
  • 1 – Specify the value 1 for database queries (for example, OQL statements such as select and show) that return results.
  • 0 – Specify the value 0 (zero) for database queries (for example, OQL statements such as insert, update, and delete) that do not return results.

Description

The Send method provides a way to communicate with the databases. The $statement parameter specifies any valid OQL statement that the Send method executes. The $returnResults parameter indicates whether you are interested in the results of the OQL statement. For example, when an OQL select statement is executed and you are interested in the results, the $returnResults parameter must be set to the value 1. The RIV::GetResult method is used to receive the results.

Example Usage

$statement = "select * from ncimCache.entityData;";
$oql->Send($statement, 1);
my ($type, $data) = $oql->RIV::GetResult(10);

Returns

Upon completion, the Send method returns the results of the OQL statement. If you set $returnResults to 0 (zero), the Send method does not return any records.

See Also