Toad® for Oracle

Version 11.6.1

Release Notes

November 19, 2012


Contents

Welcome to Toad for Oracle

New in This Release

Resolved Issues and Enhancements

Known Issues

Third Party Known Issues

Upgrade and Compatibility

System Requirements

Global Operations

Getting Started

For More Information


Welcome to Toad for Oracle

Toad for Oracle provides an intuitive and efficient way for database professionals of all skill and experience levels to perform their jobs with an overall improvement in workflow effectiveness and productivity. With Toad for Oracle you can:

The Toad for Oracle solutions are built for you, by you. Over 10 years of development and feedback from various communities like Toad World have made it the most powerful and functional tool available. With an installed-base of over two million, Toad for Oracle continues to be the “de-facto” standard tool for database development and administration.

Toad for Oracle Editions

All commercial versions of Toad are bundled with additional Quest products, based upon the Edition that you purchased. For more information about the latest features in your Toad Edition and the bundled products, see the Toad Editions Release Notes.


New in This Release (11.6)

Review the following sections for new features in this release.

All Toad Editions

A note about menu icons and toolbar buttons:

An artist was employed to update a substantial portion of Toad's main menu, toolbar buttons, and Editor icons. Further work will continue in Toad to enhance more icons throughout the product. The familiar placement of buttons and icons will allow you to quickly grow accustomed to the updated images.

Documentation and Localization

For 11.6, the new user guide, the installation guide, and release notes have been translated into Korean, Japanese, and Simplified Chinese. You can download these translated documents on our award-winning Support Site.

New User Guide

The new "Guide to Using Toad for Oracle 11.6," includes the original "Beginner's Guide" content, updated for 11.6, plus two additional chapters: "Toad Without Code" and "Toad and Your Code." It is shipped with the 11.6.1 patch and is available for download on Toad World.

Visit the Toad World library to download both of these new documents:

New Online Capabilities

Toad Options now includes an Online section (View | Toad Options | Online) for new online features:

- Project Lucy (available with the DB Admin Module DBA Suite Edition, and DBA Suite RAC Edition)

- MyToad Monitor

- Enable MyToad

- Enable user file syncing

- Toad World.

Note: When you log in to Toad World in the online options, you won't have to sign in each time you Open from Repository or Save to Repository within the Editor. Read "Toad World Repository" below.

These three new tools allow you to perform remote script execution using mobile devices, access public script files from a global repository and place your user files online, for backup and sharing across multiple computers.

MyToad

Introducing MyToad for Remote Script Execution

Now you can use MyToad, a new Web application available at MyToad.ToadWorld.com.

With MyToad, you can:

- Store script files using your Dropbox account

- View them via the Web

- Choose which ones to execute.

If you have multiple Toad installations, you can select the machine to execute the scripts.

This data is encrypted using 256-bit AES encryption.

First-time use of MyToad

Enable user files syncing

You can sync files with a Dropbox account.

Go to View | Toad Options | Online | Enable user files syncing

Benefits:

- Each copy of Toad you have can be set up to use a single set of application data files.

- Backup - Dropbox provides a secure, online storage mechanism.

- Versioning - Dropbox automatically versions every file stored in it. You can roll back to an earlier version of a data file.

Toad World Repository

With Toad World Repository, you can share your scripts and see other Toad users' scripts.

By uploading scripts you think would be useful to the community of Toad Oracle professionals, you can be part of this worldwide script library.

You can also:

- Comment on scripts

- Rate them

- Bookmark your favorites

- Organize them into collections.

- Discover the popularity of scripts by seeing the number of downloads, and their number of Likes and Dislikes.

To access scripts in the Repository:

To add your script to the Repository:

You can manage your Toad World Repository login in Options (View | Toad Options | Online).

TNS Names

Toad now supports the IFILE directive within TNS Names files. The IFILE directive allows you to link to an external TNS Names file and dynamically include its contents along with the contents of your local TNS Names list. You can include TNS files up to three levels deep in order to organize and manage TNS entries within your company.

Editor

The new Compare to menu item lets you easily access this feature.

You can compare one tab to another tab, or one tab to a file on disk.

You can also use the Control-key/click/drag method from one tab onto another that has always been available.

You can now edit search-and-replace macros via the right-click menu in Editor. This advanced macro editor lets you reconfigure any macro, rename it, remove it, and create new macros. Copy/paste is supported. You can also copy/paste your macros and email them.

Schema Browser

- Table Filter has a new option to exclude Object tables. When selected, this could make the SB load noticeably faster for some users.

- The RHS Data tab is now read only if you don't have UPDATE privilege on the table, view or MView.

Script Generation

You can now specify version of the target database, so scripts generated from a higher DB version can run in a lower DB version.

You have this option in:

Optimize SQL Statements

The new database type option lets you optimize SQL without using hints

Right-click a SQL statement in the Editor and select Optimize | Auto Optimize SQL

Amazon RDS Support

The following features now support Oracle databases running on Amazon RDS:

Note: Some of the features listed are only available with the DB Admin Module.

Version Control

ClearCase

Toad now supports IBM Rational ClearCase for version control.

Note: Toad has been tested with ClearCase Version 7.1 for Windows. ClearTool command line is required. A working client view, mapped to the project VOB, must be set up the client computer before using in Toad.

Team Foundation Server

Toad now supports mapping to multiple Work Directories (as available with Team Foundation Server) on the new Workspace tab of the Team Foundation Server Login Dialog. Versions of Toad prior to 11.6 only permitted a single Work Directory (client folder mapping) for a Workspace.

Links to Answers & the Support Bundle

Easier access to answers

To help you find answers quickly, a link to the Knowledge Base of our award-winning Support team has been added to many error messages.

Support bundle

- Quest Support has a new policy regarding the submission of Support Bundles inside the product. An existing Case or Service Request ID is now required. This information is prompted for now when clicking the 'Email Quest Support' label on the Support Bundle form.

- We have added a link to Quest Web Support on the Support Bundle page.

64 Bit

Toad for Oracle's 64-bit version now lets you connect using 64-bit Oracle clients.

Internet-free Toad Installation

Toad 11.6 introduces a secure, Internet-free Toad installation with a restrictive parameter used when installing Toad silently. The "i" parameter of the RESTRICTIONS option ensures Toad does not access the Internet. This prevents the use of all functionality which could do so, such as the FTP window and opening Browser windows through Toad.

Refer to the "Toad for Oracle 11.6 Installation Guide" for instructions. Visit the Toad for Oracle library for that and many other resources.

Professional Edition and Higher

Code Analysis

Code Analysis (formerly CodeXpert) is Toad's powerful code review and analysis tool. It helps you ensure that the performance, maintainability, and reliability of code meets and exceeds your company’s best practice standards.

Code Analysis has the following new features:

Ignore Rules

You can now choose to ignore specific Code Analysis Rules.

You can also access the "Ignore Rules" option by right-clicking on rule violations in the Messages tab at the bottom of the Editor window.

You can choose to:

- Ignore this instance

- Ignore all instances in this window

- Ignore all instances.

To restore a rule to full service:

Legend (checkboxes are read-only indicators):

  1. For "Ignore this instance" ,the Line and Column are populated.
  2. For "Ignore all instances in this window" (Ignore In Object),the Line and Column are N/A.
  3. For "Ignore All Instances" (Ignore All), the Line and Column, are N/A.

Updated UI

Code Analysis options, toolbars, and windows have been updated to improve usability.

On the Code Analysis toolbar, the 'Analyze Code' and 'Scan SQL statements...' buttons have been replaced by a drop-down list to apply to selected items:

- Run Review

- Run SQL Scan

- Run Review and SQL Scan.

Make your selection and press F9, or click 'Analyze Code for all selected items' on the toolbar .

Or to apply your selection to all items, press F5.

Run (F9), Run all (F5), and Cancel have been updated.

The Code Analysis Rules window has been updated.

The new graphic icon legend makes it easier to see rule types/objectives at a glance.

Updates to edited rules display

Edited rules are now indicated by a checked box in the User Defined column.

Modified rules are now indicated by a checked box in the Modified column.

To reset user-defined or edited rules to their original values, select the rule and click the 'Restore Original Rule Value' button, or click the double-arrow 'Restore All Original Rule Values' button. These buttons replace the right-click functionality for restoring rules.

When editing Rule Sets, it is easier to identify read-only rules sets.

Toad's standard rule sets cannot be edited.

Your new rule set will appear with the Read Only checkbox unselected.

The 'Export Rule Set' and the 'Edit Rule Set' buttons become available when you select your new rule set.

Importing and Exporting Rules and Rule Sets

- The Edit Code Analysis Rules toolbar now includes import and export buttons to import existing or export user-defined rules.

- See "Create, Clone, or Edit Code Analysis Rules" in the online help for more information.

- The import and export of rule sets has been updated.

- See "Create or Edit Rule Sets" in the online help for more information.

Streamlined Code Analysis Action

See Code Analysis Action for more information.

Analyze Code from the Project Manager

You can now perform a full Code Analysis directly from the Project Manager, using your default rule set, via the right-click menu.

Updated Code Analysis Rules

The following Code Analysis Rules have been improved:

Rule 2118 (Avoid DDLs other than Truncate, Exchange/Split partition): Did flag procedures/functions.

Rule 2829 (Avoid declaring NUMBER subtypes which have no precision [INTEGER etc.], and avoid declaring NUMBER without precision): Adding DEC.

The data types which cannot have a precision or scale have been removed.

Rule 4213 (Use CASE statement rather than a complex conditional IF statement): The smallest "complex" statement is now IF-ELSIF-ELSE-END rather than IF-ELSIF-END.
Rule 4409 (Ensure END [LOOP] statement is not missing a semi-colon): Has become a pink rule (with XPath expression).
Rule 4602 (Avoid use of literals in non-declarative parts of the program): Adding all numeric literals except 0, 1 and -1.

Rule 4801 (Use EXIT WHEN rather than IF THEN EXIT): The rule states that EXIT WHEN is ok, but plain EXIT is not. Formerly EXIT_WHEN was caught as well.

Rule 4804 (Avoid use of EXIT/RETURN statements in a FOR/WHILE loop): EXIT is now allowed in an endless loop.

Rule 4809 (A loop that contains DML statements should be refactored to use BULK COLLECT and FORALL): Not flagging SELECT if no DML statements are found.

XPath expression updated.

Rule 4810 (Ensure that FORALL statements rely on a driving array that is not empty): This rule has been removed as an empty driving array does not cause trouble.
(Rule 4811 has been removed.)
Rule 4812 - (SELECT-BULK-COLLECT [implicit bulk query] or FETCH-BULK-COLLECT...): XPath expression updated.
Rule 5002 (Avoid assigning strings of zero length to character-type variables ): Removing hitting parameters because that's allowed in many cases, see topic text.

Rule 5406 (Remove unused parameters or modify code to use the parameter): False positive on cursor parameter declarations, such as "cursor c_test(v_test integer) is ...".

Excluding procedure, function and cursor specifications.

Changed to XPath based.

Rule 5825 (Consider replacing INSERT/UPDATE or UPDATE/INSERT pairs working on the same table by a MERGE): Now flags more cases.

Did not look within a same block hence false positives.

Rule 5914 (Use untransformed column values in the WHERE clause): Adding anonymous block context.

The rule has been refined to limit the transformations to TO_NUMBER() and SUBSTR() only. Perhaps a few others can be added later.

Rule 5917 (Do not use 'Insert into ... select * ...' statements) : Did not filter on "SELECT *", rather flagged all selects.

Rule 6401 (Avoid multiple declarations of labels and variables): XPath updated to find procedure and function declarations.

Changed to XPath based.

Rule 6801 (Ensure all statements can be reached [dead code]): Now supports full Oracle syntax (formerly only Oracle up to 9.2 was supported). Fixed for correctness.

Rule 6806 (Use native execution for PL/SQL that is compute intensive and has little SQL) : Now triggers whenever the total count of non-DML statements is greater than 30 times the number of DML statements.

The legacy code has been replaced by a new XPath expression which will trigger whenever the total count of non-DML statements is greater than 30 times the number of DML statements. This can serve as a starter, and can be refined later.

 

DB Admin Module, DBA Suite Edition, and DBA Suite RAC Edition

Project Lucy

Project Lucy is now launched as an embedded Toad window, and the UI has been updated.

- Your token is now stored in the new Online section of Toad Options (View | Toad Options | Online)

- You can launch Project Lucy from the Database Browser toolbar or click Database | Diagnose | Project Lucy.

See "Project Lucy" in the online help for more information.

Idea Pond

Idea Pond is a site where you can submit your ideas to improve Toad and vote or comment on other people's ideas. Toad's development has always been driven by our customers, and now it is even easier for you to tell us what changes are most important. This site is free for all customers.

The following Idea Pond submissions were implemented for this release:

Enhancement Idea Pond ID
64-bit version of Toad. 11
You can now specify SELECT_CATALOG_ROLE in order to export TABLESPACE definitions with an ASM template instead of hard coded files with OMF names. 458
In data grids, Toad will now only remember column sizing if you resize or reposition a column. If you don’t make a change to the grid, it will auto size on the next execution. 482
Added support for IBM Rational ClearCase to source control. 490
Added the ability to ignore Code Analysis rules. You can ignore a specific rule at a specific location, a rule in a window, or any instance of a rule. 530
In the Schema Browser, the ‘Cancel’ button has been moved so it remains visible regardless of the size of the LHS portion of the window. 533
Option added to display the number of found occurrences/replacements made following a search/replace all. 554
Added the menu bar to the LHS of the Schema Browser when you have hidden the RHS using F12. 583
Schema Compare now has two options for private synonyms: "Owned by schema" and "For schema's objects." 613
Added support for proxy connections. 616
Added a filter to the Code Analysis main window. 627
Added the ability to show Code Analysis violations in the tree view by location (current), or grouped by objective, or grouped by severity. 645
Added an option to display outline hints (formatting option OUTLINE) in the DBMS_XPLAN formatting of execution plans. 675
A new Record View Option dialog allows you to set the maximum percent of screen space (height and width) the Single Record View window can use. 686

Resolved Issues in 11.6.1

The following list includes issues addressed in this release of Toad for Oracle.

Feature Resolved Issue ID
Administration Revoking of more than one object privilege now works correctly. 102974
Automation Designer

In Automation Designer, the Compare Schemas action now specifies the Exclude File.

102981
Automation Designer

In Automation Designer, the Compare Schemas action now generates the correct Schema Definition file.

103530
Code Analysis Rule 6401 - Avoid multiple declarations of labels and variables; rule is now correctly triggered. 102632
Code Analysis Rule 5914 - Use untransformed column values in the WHERE clause; rule is now correctly triggered. 102635
Code Analysis Rule 5405 - Ensure mode of Procedure / function parameter is specified with IN parameter. 102713
Code Analysis Rule 5407 - Ensure mode of cursor parameter is specified with IN parameter. 102715
Code Analysis

Code Analysis can be run from the command line.

103907
Code Analysis Green rules are processed successfully in 64-bit. 104053
Connections Deleting a description in the TNS Editor no longer causes errors. 104418
General HTML Schema Doc Generator now displays Trigger names in the report. 103493
Online Options Trial version no longer generates "path not found" message when online options are checked for the first time. 103767
Schema Browser The Describe window now behaves properly when searching through a Package Body. 103744
Schema Browser Selecting an XMLTYPE column no longer causes an access violation (AV) error. 103357
Schema Browser

Using the 'Save to File' option for packages in the Schema Browser now works properly.

103843
Schema Browser In the Schema Browser tree view, clicking on a schema-level trigger no longer causes AV. 104159
Source Control Team Foundation Server (TFS)- Toad no longer allows checkouts to unmapped workspaces. 104067
Tables

Queries that return nulls for particular column (if there are nulls in the DB) no longer result in an error stating "‘’ is not a valid integer."

104071
Tables 'Rebuild Table' now runs without any errors. 104203
Team Coding

The freeware version of Toad now works properly with Team Coding installed.

103668
Team Coding

32-bit Toad now successfully integrates with SourceGear Vault via SCC API; Team Coding works properly.

103899
Team Coding When checking out files from TFS, 'Open database version' now functions properly. 104201
Team Coding

In Team Coding Code Collections with Subversion, 'Create new collection' now shows the correct schema.

104242
Toad Toad now operates properly on Windows XP. 103712
Toad

32-bit Toad now runs on Windows 2003 (32 or 64-bit).

NA

Resolved Issues and Enhancements in 11.6

The following issues were addressed in the 11.6 release of Toad.

Feature Resolved Issue ID
Alter Table The SB Alter Table now recognizes changes to physical attributes. 100,488
Automation Designer The Advanced Properties button is now available in Win7. 99,066
AWR Browser Double clicking on wait in the grid now gives you advice for that specific wait, as stated in Help. 99,120
Code Analysis Code Analysis rule violations now trigger correctly. 99,750
Code Analysis All rule violations are now inserted into the database. 100,383
Code Analysis Code Analysis rule violations now trigger correctly. 100,335
Code Analysis CRUD Matrix is now valid for Insert statements with select statements. 99,454
Code Analysis Rule 4804 is now working properly. 101,515
Code Analysis Rule 4801 is now triggering correctly. 100,656
Code Insight Code Assist pop-up. Highlighted objects now show enough contrast. 99,769
Code Insight Code insight no longer removes the period after sequence names. 56,652
Compare Data Saving sync scripts no longer generates "Out of memory" errors. 99,357
Compare Data The ability to compare a table to itself has been restored. 100,849
Compare Schemas Source and Target schemas are now placed correctly in the file difference viewer after schema compare. 100,445
Compare Schemas

In a Compare Schema action, the option to use '/' to end SQL statements is now saved successfully.

99,653
Compare Single Objects The 'Ignore minor differences' option in file compare is now working properly. 100,921
Connections IFILE is again supported in tnsnames. 84,831
Connections

The Direct tab now supports additional connection options.

101,026
Copy User Settings Copy User Settings: This window is now operable when pointing to an old version of Toad. 101,701
Create Create Table: You can now access a list of directory objects when creating an external table. 101,089
Data Grids The data grid is now resizing correctly on second F9. 101,317
Database Browser Tablespaces/users tabs are now populating for OS Auth user. 101,568
Database Menu Nested tables now display hugeclob data in the popup editor. 102,811
Editor The Script Editor scroll bar slider is available. 57,052
Editor Large queries can now be run successfully in the Editor. 102,024
Editor

Issues upon updating connections.ini when running two instances of Toad have been resolved.

101,630
Explain Plan Tab The right-hand-side connection is set correctly for.Explain Plan Comparison. 99,316
Export DDL Sequence is no longer omitted when exporting DDL for multiple schemas in one file using simple search. 99,012
(F5) Script Execution EZCONNECT is now supported in the script engine. 99,754
(F5) Script Execution COMPUTE SUM BREAK ON is now working correctly in the Editor. 98,812
(F5) Script Execution Editor: F5 no longer inserts decimal place in the wrong location. 100,062
(F9) Execute and Compile

Executing a SQL statement with SHIFT+F9 now works properly on PL/SQL mode (i.e. package).

100,577
Find and Replace The Find and Replace window now comes to front after switching to another application. 100,908
Import Table Data Imports from Access Tables no longer truncates data fields. 102,299
Import Table Data Generating insert statements for CLOB data no longer gives a "Missing Keyword" error. 101,213
Import Table Data Leap year days are now handled correctly 99,314
Import Table Data The Import wizard now properly ignores the count of lines from the flat file if the First Row field is populated with the Line Count. 102,514
Materialized Views

Table script now puts synonyms DDL in the correct place; "Create or Replace Synonym" now works properly.

101,889
SQL Optimizer

Using Oracle Instant Client no longer produces the error, "Cannot find OCI DLL."

80,670
Options Visual Style is now saved after closing Toad. 99,260
PLSQL Debugger Declarations no longer always include the schema name, which was causing issues. 99,747
Query Builder The Object Palette can now be undocked without causing errors. 100,415
Query Builder

Toad no longer gives this message when you open the Query Builder: "The Query Builder has been restricted for <connection name>. You can still use the Code Road Map, however it will be operating without a connection"

101,772
Detail Testing

Passing tests from Toad to Quest Code Tester for Oracle now works properly.

99,581
Schema Browser Adding two or more favorites no longer gives the "Could not convert variant of type (Null)" error. 100,527
Schema Browser Insert Short-cut key now functions properly in the Alter Table window to add a column. 100,814
Schema Browser Tree-view Mode - Load only users with objects filter now works with schemas only having DB Links. 100,816
Session Browser The Locks tab in the Session Browser no longer give this error: "INST_ID not found." 101,285
Refresh Groups Copy/paste changes are now recognized. 99,328
Scheduler Jobs A job no longer runs immediately after changing the start date. 100,361
Session Browser

Columns are now displayed properly.

100,910
Session Browser All columns are now displayed. 101,120
Session Browser

Toad now displays consistent details about the explain plans being used by a query regardless of where you access that information.

101,347
Sub Tabs An unpinned grid no longer pops up when toggling from an editor with pinned grid. 101,119
Synonyms Create script for synonym across dblink now works properly. 101,635
Team Coding Team coding now creates temp CVS file to successfully check out code. 92592
Team Coding and Source Control TFS2010: Errors no longer occur during check-in and check-out. 100,909
Team Coding and Source Control TFS2010: This message no longer appears upon check-in: "File...is not in the Source Control Project Working Directory." 100,703
Team Coding and Source Control Code Control window now populate properly. 102,090
Team Coding and Source Control Error checking out using team coding, when local Path contains German characters 81,417
Tables Posting data larger than 4k in the popup Editor no longer causes issues. 101,319
Text Editing The Editor no longer has performance issues when using APPS account against Oracle Apps databases. 102,372
Triggers Parsing schema names with "$" now works properly. 99,456
Triggers Generation of source script of TRIGGER syntax is now accurate. 101,638

Resolved Issues and Enhancements in 11.5.2

The following issues were addressed in the 11.5.2 release of Toad.

Feature Resolved Issue ID
Code Analysis Rule 2118 was missing DDL such as trigger, function, and package objects. N/A
Code Analysis Rule 2129 was not triggering when more than 6 OR operations were used in a where clause. N/A
Code Analysis Rule 2832 was being fired for all VARCHAR2 declarations. N/A
Code Analysis Rule 4801 was incorrectly triggering EXIT WHEN statements when it should only trigger IF THEN EXIT. N/A
Code Analysis Rule 4804 was being triggered in a simple LOOP and should only be fired in FOR LOOP or WHILE LOOP statements. N/A
Code Analysis Rule 4809: Loops were being triggered even when using bulk and for all. N/A
Code Analysis Rule 5406 was falsely triggering parameters as unused when they were used. N/A
Code Analysis Rule 5825 was being violated in a package that had only 1 insert statement for a table. This rule should only fire when there are multiple inserts. N/A
Code Analysis Rule 5914: All transformations not in the database columns were being flagged, such as trun(sysdate) or nvl() function. N/A
Code Analysis Rule 5917 was falsely triggering select statements that did not contain a select *. This rule should only trigger "Insert into" statements that contain a select *. N/A
Code Analysis Rule 6401: The same procedure name with different parameters in a package were being triggered. N/A
Code Analysis Rule 6811 was being fired when the data type "double precision" was used. It should only fire for variables with spaces. N/A
Code Analysis Not all rule violations were getting inserted into the Database. 1040377
Code Analysis Code Analysis could not scan pl/sql objects that contained the keyword TABLE. 1040377
Team Coding Code Collections Window did not always populate. 1057039

Known Issues

The following is a list of issues known to exist at the time of this release.

Feature

Known Issue

ID
64-bit SQL Tracker

Launching SQL Tracker (in the UI: Database | Monitor | SQL Tracker) gives the following error:

If the .NET framework v2.0.50727 or higher is not installed, launching SQL Tracker will give you the following error:

“The application failed to initialize properly."

The error should indicate:

“To run this application, you first must install one of the following versions of the .NET Framework: v2.0.50727. Contact your application publisher for instructions about obtaining the appropriate version of the .NET Framework.”

Workaround: Install the latest .NET framework.

99633
Team Coding

The 64 bit version of Toad does not provide native support for the following Version Control Providers:

- Microsoft Visual SourceSafe

- Merant Version Manager (PVCS) version 5.2/5.3/6.0

- Merant Version Manager (PVCS) version 6.6 and later

Integration with vendors who support the SCC API is dependent on the provider’s 64 bit implementation of SCC.

N/A
General

Database Probe does not work with Oracle version 8.1.5.

Workaround: Upgrade to supported Oracle version 8.1.7

N/A
General Toad's help cannot be opened from an installation path that contains Unicode characters. ST72966
General

If you check "Indexes" on the Scripts tab for snapshots, then the primary key for the snapshot will be included in the script, even though the CREATE MATERIALIZED VIEW statement implicitly creates this primary key.

Toad currently does not differentiate between indexes created explicitly on the snapshot and indexes created automatically when the snapshot is created.

Workaround: If you are running the generated script to recreate the snapshot, then you can simply ignore the error that occurs when the script tries to recreate the primary key index for the snapshot. If you do not normally create indexes on snapshots, then you can uncheck "Indexes" when generating the snapshot script.

N/A
General

You may get the following error when moving from the first screen of the LogMiner to the second screen of the LogMiner: "17:46:25 Info: ORA-06532: Subscript outside of limit ORA-06512: at "SYS.DBMS_LOGMNR_D", line 793 ORA-06512: at line 2" This results from an Oracle bug in 8.1.7.0.0 and 8.1.7.1.0.

Workaround: Upgrade to Oracle version 8.1.7.2.0 or later, or see Oracle Metalink Note:124671.1 for details of how to fix the package.

N/A
General

If you use 11g Oracle ODP.NET client or any other client that does not have the oci.dll in the BIN directory, Toad has the following problems:

  1. Client shows as invalid
  2. Client version is not detected
  3. As a result of #2, columns of the following datatypes are not shown in the Schema Browser table data: CLOB, BLOB, NCLOB, XMLTYPE, TIMESTAMP, INTERVAL, BINARY_DOUBLE, and BINARY_FLOAT
N/A
Code Analysis Saving results to a database: When dealing with nested procedures, CodeXpert can only insert run data from procs one level deep. N/A
Code Analysis

Saving PL/SQL results to a database may fail or save invalid data to the database for invalid PL/SQL objects.

Workaround: To ensure PL/SQL results are saved to the database correctly, verify the validity of all objects before running CodeXpert.

N/A
Connections While Toad supports LDAP connectivity, some features of Toad depend on tnsnames.ora file to operate correctly. These features include but may not be limited to Quest Script Runner, Database Browser, and Service Manager. N/A
Data Grids

You may receive an "ORA-00902 invalid datatype" error when editing an object, nested table, or varray data if you have redefined the data type for that data during the current session.

Workaround: If you redefine an object type, nested table, or varray and then need to edit data in a table based on that type, end your current connection and begin a new one.

N/A
Editor

When file splitting is used in the Editor, Code Analysis does not automatically check the code in the Editor.

Workaround: Click the "Analyze Code in Editor" button.

ST85604
Editor

Toad errors when you query on a field of Oracle collection types.

Workaround: Execute using SQL*Plus.

ST64373
Editor

When spooling to an unpinned output window, the window becomes unresponsive and errors are given when Toad is closed ("Canvas does not allow drawing").

Workaround: Keep the output window pinned.

ST68523
Editor If you select object tables with nested VARRAYs, the statement is busy and cannot be aborted. ST62336
Editor Toad Insight (Code Assist) is activated in comments, which may decrease Toad's performance. ST64254
Editor

If you use a non fixed-width font, the results are misaligned in the of Script Output tab in Editor after executing a SQL script.

Workaround: Go to Options | Scripts and select a fixed-width font for script output.

ST62234
Import/Export

Exporting data grid cells of over approximately 800 bytes could cause "OLE error 800A03EC" for Microsoft Office 2003 when using the "XLS Instance" option.

Workaround: Save using the "XLS file" option instead.

N/A
Import/Export Constraint scripts from Export DDL do not contain the "using index" or "tablespace" clause. ST59228
Schema Browser

Sometimes on Oracle 8.1.7 or higher, after pressing "Compile invalid objects", you may get ORA-20000, ORA-06512, or ORA-06512 errors. This could mean that you do not have the privileges to compile the object, but it also happens when the schema contains a package body that does not have an associated spec.

Workaround: Look in the schema that you are trying to compile to see whether there are any orphan package bodies. If it is your own schema, then do:select * from user_objects o1 where object_type = ''PACKAGE BODY'' and not exists (select ''x'' from user_objects o2 where o2.object_name = o1.object_name and o2.object_type = ''PACKAGE'') Then drop any orphan package bodies that are found.

N/A
Schema Browser

For data in tables, changing the order of the columns in the "View/edit query" popup does not change the order of the columns in the grid.

Renaming a column in the "View/edit query" popup moves the renamed column one position to the left. The renamed column will not be editable.

Workaround: Use drag-and-drop in the grid to change the column order.

N/A

Session Browser

Session Browser does not work with Oracle version 8.1.5.

Workaround: Upgrade to supported Oracle version 8.1.7 or later.

N/A
Session Browser The Program name in the Session Browser may be blank or may be the full path to the executable instead of just the executable name. This depends on the Oracle client, not on Toad. N/A
Session Browser

In RAC databases, version 10.1.0.3 (and possibly other 10.1 versions), the query used to populate the "Current Statement" in the Session Browser fails with the following error: Runtime error occurred: 12801 (ORA-12801: error signaled in parallel query server PZ99, instance <instance name> ORA-01008: not all variables bound) This problem does not occur in Non-RAC environments.

Workaround: Clear the "Use RAC Views" checkbox, and log into the appropriate instance of the database, if necessary.

N/A
Team Coding

When using Microsoft Team Foundation Server, customers may receive an "Unable to get revision from VCS repository" error followed by "VCS archive is empty". This error generally occurs if customers use different workspaces when logged in to TFS.

Workaround: See Quest Support Solution SOL74899.

ST90025
Team Coding Team Coding is disabled for mixed-case object names. N/A
Team Coding

Team Coding and SourceSafe:

  • Integration via the SCC API is available but not recommended for SourceSafe 6.0
  • SourceSafe 5.0 ignores the "Force revision" flag and ''Create a new revision for existing objects'' option when exporting.
N/A
Team Coding

With CVS, Toad may fail to retrieve the list of projects for you to select from in the CVS browser or in the Code Control Groups configuration.

Workaround: See "Missing CVS\Entries File Error" in the online help.

N/A
Team Coding Team Coding and StarTeam: If you cancel the login dialog for StarTeam, you will not be able to log in to StarTeam until you restart Toad. N/A
Team Coding

Team Coding and PVCS:

  • PVCS Version Manager 6.6 and above only supports "Tip Revisions" via the COM interface used by Toad. Attempting to retrieve a non-tip revision using the Version Control Browser will always return the latest revision. (Merant case ID 1230782). This means that comparing revisions in the VCS Browser will fail because both versions will return the text of the latest version of the file.
  • After connecting to a PVCS database, successive connections made during the same Toad session will always connect to the same PVCS database, even if a different database is specified in the "Logon to PVCS" dialog.

Workaround: Close and re-open Toad before attempting to connect to a different PVCS database. If simultaneous connections to two different PVCS databases are required, this can be achieved by opening a second copy of Toad.

N/A
Team Coding Team Coding and Clearcase: Dynamic Views are not supported via SCC interface. Snapshot Views must be used instead. (Rational case ID v0830629, Rational Defect # CMBU00053934) N/A
Unicode

The following features in Toad do not support Unicode:

  • ASM Manager
  • Export File Browser
  • Hex Editor

In addition, Java itself does not allow Unicode class names or file names. This is relevant to the Java Manager, Editor, and Schema Browser.

N/A
Unicode Connections to Service Names with Unicode Characters are not supported. N/A
Unicode

The Editor does not fully handle Unicode words, and as a result highlight object names, CTRL + Click, and mousing over watch hints may not work.

Workaround: The fix is to change a regular expression in the PL/SQL language parser. New installations will not have this issue, but the language parser is not applied for upgrading users (so you do not lose any language parser customizations). If you are upgrading, you need to modify the PL/SQL language parser and add "?r)" (without quotes)  to the beginning of the “Any name" parser rule’s expression if you want full Unicode object name support. For detailed instructions, please see the Unicode Troubleshooting topic in the Help file.

N/A
Unicode Script Execution in Editor: Error offset can be incorrect when running scripts with multi-byte object names. N/A
Unicode XML (Plain) format creates bad XML if Unicode string values and Unicode column names are exported through Export Dataset. N/A
Unicode

Import mapping for Unicode characters is incorrect if the characters are not a fixed width (such as Korean).

ST63221
Unicode In Team Coding, objects with Unicode contents are supported, objects with Unicode names are not. Supported Version Control Providers do not support Unicode names. N/A
Virtualization An access violation error may display when you close Toad in a Citrix XenApp environment. ST76354

Third Party Known Issues

The following is a list of third party issues known to exist at the time of this Toad for Oracle release.

Feature Known Issue Defect ID
Help

(Affects the 64-bit version of Toad only)

If IE9 is installed, clicking a link in the Help file may crash Toad 64-bit, even if IE9 is not the default browser.

Workaround: Users who have IE9 installed can open Help from outside of Toad.

N/A
E-Control (Editor component) Odd word-wrapping behavior in some languages. Word wrapping may appear between symbols, with no space required to wrap, and some characters cannot be word-wrapped at all (for example, multi-byte characters in ANSI text). N/A
ODAC

ODAC does not support Unicode in XMLTYPE (editing of XMLTYPE data is not supported).

Querying of XMLTYPE with binary storage will lead to an error.

ST62654

Upgrade and Compatibility

Upgrades for Toad install side-by-side with any previous versions you have installed. You can run the new and previous versions concurrently. The first time you run the new version of Toad you are asked to migrate previous settings files.

Note: Toad supports importing settings only if the new version is within two releases of the previous version. If your versions are more than two releases apart, you need to install an intermediate version to successfully import the files.

Deprecated Features

This feature has been deprecated:

  


System Requirements

Before installing Toad, ensure your system meets the following minimum hardware and software requirements:

Memory

1 GB RAM required for 32-bit

2 GB RAM required for 64-bit

Note: The memory required may vary based on the following: 

  • Applications that are running on your system
  • Size and complexity of the database
  • Amount of database activity
  • Number of concurrent users accessing the database
Hard Disk Space
120 MB

Toad for Oracle 32 bit

150 MB Toad for Oracle 64 bit
Operating System

Windows Server 2003 (32-bit and 64-bit)

Windows XP (32-bit and 64-bit)

Windows Vista (32-bit and 64-bit)

Windows Server 2008 (32-bit and 64-bit) - 2 CPU required

Windows Server 2008 R2 (64-bit) - 2 CPU required

Windows 7 (32-bit and 64-bit)

Windows 8 (32-bit and 64-bit)

Windows Server 2012 (64-bit)

Database Client

Oracle Client 9.2.0.8

Oracle Client or Instant Client 10.2.0.3/10.2.0.4

Oracle Client or Instant Client 11.2.0.1/11.2.0.3

Note: You must use the 32-bit version of Toad with the 32-bit Oracle client, and the 64-bit version of Toad with the 64-bit Oracle client.

Database Server

Oracle 8.0.6; 8.1.7; 9i; 9i R2; 10g; 10g R2; 11g, 11g R2

Toad has been tested on Oracle Exadata 2.0 running Oracle database 11g R2.

Important: It is recommended that your client version be of the same release (or later) as your database server. This is an Oracle recommendation to prevent performance issues.

Cloud Database Service

Oracle databases running on Amazon EC2

IPv6 Internet Protocol Version 6 (IPv6) is being adopted by the US Federal Government and industries around the world. In its most basic format, the new protocol uses 128-bit addresses instead of 32-bit addresses used by the current IPv4 to route packets over the Internet. Toad for Oracle features such as FTP access the Internet through third-party vendors such as /nSoftware's IP*Works that are IPv6 compliant. For access to Web sites by way of the Toad Online window, Toad simply invokes the user-defined or default Web browser.
Additional Software

Microsoft Internet Explorer 6.0 or later (to view the Release Notes)

Adobe Acrobat Reader 7.0 or later (to view the Installation Guide)

Virtualization Support

Before installing Toad, review the following for virtualization support:

Application Virtualization

Citrix XenApp 5.0 has been tested.

Desktop Virtualization (VDI)

Quest vWorkspace 7.0 has been tested.

Server Virtualization

Oracle VM 3.1 has been tested.

VMware ESX Server 3.5 has been tested.

Note: Toad may work in virtualization environments other than the ones listed.


Global Operations

This section contains information about installing and operating this product in non-English configurations, such as those needed by customers outside of North America. This section does not replace the materials about supported platforms and configurations found elsewhere in the product documentation.

This release is Unicode-enabled and supports any character set. In this release, all product components should be configured to use the same or compatible character encodings and should be installed to use the same local and regional options. This release is targeted to support operations in the following regions: North America, Western Europe and Latin America, Central and Eastern Europe, Far-East Asia, Japan.

This release has the following known capabilities or limitations: Toad is a Unicode application. As such, it has native support for any Oracle Unicode character set, such as UTF8 or AL32UTF8. There are some features in Toad which use or invoke Oracle Utilities or applications which are not themselves Unicode applications. Their functionality is therefore limited to the character set of the client on which Toad is running, and NLS_LANG must be carefully set to match the Windows character set.

We have also observed issues with US7ASCII when used with non-Latin characters.


Getting Started

Contents of the Release Package

The Toad release package contains the following products:

  1. Toad for Oracle 11.6.1

    Note: Toad is available in different editions. The release package includes the edition that you purchased.

  2. Product Documentation, including:

Installation Instructions

Refer to the Toad for Oracle Installation Guide for installation instructions.


For More Information

Get the latest product information, find helpful resources, and join a discussion with the Toad team and other community members. Join the Toad for Oracle community or visit ToadWorld for more information about Toad.

Contact Quest Software

Email

info@quest.com

Mail

Quest Software, Inc.

World Headquarters

5 Polaris Way

Aliso Viejo, CA 92656 

USA

Web site

www.quest.com

See our web site for regional and international office information.

Contact Quest Support

Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to our Support Portal at www.quest.com/support. From our Support Portal, you can do the following:

The guide is available at www.quest.com/support.

Note: This document is only available in English.


© 2012 Quest Software, Inc.

ALL RIGHTS RESERVED.

This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written permission of Quest Software, Inc.

The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.

If you have any questions regarding your potential use of this material, contact:

Quest Software World Headquarters
LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
email: legal@quest.com

Refer to our Web site (www.quest.com) for regional and international office information.

Trademarks

Quest, Quest Software, the Quest Software logo, Benchmark Factory, Knowledge Xpert, Quest vWorkSpace, Spotlight, Toad, T.O.A.D., Toad World, and vToad are trademarks and registered trademarks of Quest Software, Inc in the United States of America and other countries. For a complete list of Quest Software’s trademarks, please see

http://www.quest.com/legal/trademark-information.aspx