In this section: |
The Adapter for Oracle provides several parameters for customizing the environment and optimizing performance. This topic provides an overview of customization options.
How to: |
When an SQL SELECT statement refers to CURRENT_DATE, CURRENT_TIME, or CURRENT_TIMESTAMP, it will obtain the date or time value from the Server (the default), or from the Oracle DBMS. You can override the default using the new SET DATETIME_PROCESS option. This is effective only for reports using Automatic Passthru.
To choose a source for system date and time, the syntax is
SQL SET DATETIME_PROCESS=SERVER|DBMS
END
where:
Specifies that the date and time values will be taken from the Server. This is the default.
Specifies that the date and time values will be taken from the Oracle DBMS.
How to: |
You can use the SET DBSPACE command to designate a default tablespace for tables you create. For the duration of the session, the adapter places these tables in the Oracle tablespace that you identify with the SET DBSPACE command. If the SET DBSPACE command is not used, Oracle uses the default tablespace for the connected user.
ENGINE SQLORA SET DBSPACE tablespace
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Is a valid tablespace in the database.
Note: This command will affect only CREATE FILE and HOLD FORMAT SQLORA requests issued by Table Services. It does not affect Passthru CREATE TABLE commands.
How to: |
You can use the SET IXSPACE command to override the default parameters for the index space implicitly created by the CREATE FILE and HOLD FORMAT commands.
ENGINE SQLORA SET IXSPACE
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Is the portion of the Oracle CREATE INDEX statement that defines the parameters for the index. It can consist of up to 94 bytes of valid Oracle index space parameters. To reset the index space parameters to their default values, issue the SET IXSPACE command with no parameters.
Note: Refer to the Oracle documentation for more information on this command.
The long form of SQL Passthru syntax for commands exceeding one line is:
ENGINE SQLORA
SET IXSPACE index-spec
END
For example, to specify the NOSORT, NOLOGGING, and TABLESPACE portions of the Oracle CREATE INDEX statement, enter the following commands:
ENGINE SQLORA SET IXSPACE NOSORT NOLOGGING TABLESPACE TEMP END
Note: This command will only affect CREATE INDEX requests issued by CREATE FILE and HOLD FORMAT SQLORA commands. It does not affect Passthru CREATE INDEX commands, for example:
ENGINE SQLORA SET IXSPACE TABLESPACE tablespace_name TABLE FILE table_name PRINT * ON TABLE HOLD AS file_name FORMAT SQLORA END
How to: |
The Adapter for Oracle has the ability to issue calls in NONBLOCK mode. The default behavior is BLOCK mode.
This feature allows the adapter to react to a client request to cancel a query while the adapter is waiting on engine processing. This wait state usually occurs during SQL parsing, before the first row of an answer set is ready for delivery to the adapter or while waiting for access to an object that has been locked by another application.
Tip: You can change this setting manually or from the Web Console by clicking Data Adapters on the menu bar, clicking a configured adapter, and choosing Change Settings from the menu. The Change Settings pane opens.
ENGINE SQLORA SET NONBLOCK {0|n}
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Is a positive numeric number. 0 is the default value, which means that the adapter will operate in BLOCK mode. A value of 1 or greater activates the NONBLOCK calling and specifies the time, in seconds, that the adapter will wait between each time it checks to see if the:
Note: A value of 1 or 2 should be sufficient for normal operations.
How to: |
PASSRECS returns the number of rows affected by a successfully executed SQL Passthru INSERT, UPDATE, or DELETE command.
Tip: You can change this setting manually or from the Web Console by clicking Data Adapters on the menu bar, clicking a configured adapter, and choosing Change Settings from the menu. The Change Settings pane opens.
ENGINE SQLORA SET PASSRECS {ON|OFF}
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Provides the number of rows affected in the application program SCB count member after the successful execution of an SQL Passthru INSERT, UPDATE, or DELETE command. ON is the default value.
Provides no information after the successful execution of an SQL Passthru INSERT, UPDATE, or DELETE command.
How to: |
You can use the SET SPMAXPRM command to specify the maximum number of input parameters that can be associated with any Oracle stored procedure.
ENGINE SQLORA SET SPMAXPRM nnn
where:
Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.
Is the maximum number of parameters that can be passed to any stored procedure available to be run in this client session. 256 is the default value.
WebFOCUS |