AskToad.com -- Home of your Toad Oracle KnowledgeBase
General
How do I start using Toad?
When Toad first loads, the main MDI screen appears and an initial Toad Server Login Window is displayed. This window will prompt for a Database, UserName, and Password. The database name should be one of the valid Oracle TNS entries. The user and password are the user/password for the schema to which you want to connect. For example, a sample schema that is installed with many versions of Oracle has a user/password of SCOTT/TIGER.
Previous connections will display in a list on the left of the Login window. Toad stores passwords for previous logins if the appropriate option is enabled. On most Toad screens, the Oracle connection active for that screen will display in the first or second panel of the status bar at the bottom of that particular screen. This is important to note because with several connections active, you will need to know which connection is in use for the active window.
For basic information about the most popular Toad features, please see the Features chapter of the Toad Getting Started Guide, which should be located in the docs folder of the Toad installation directory.
If you need help with a particular feature, you can press the F1 key while you are in the window to receive help on that topic.
Can I restrict users from using free TOAD in my oracle environment?
If you want to knock out the freeware users, here is how to do so:
- Create table TOAD.TOAD_FREEWARE ( Message VarChar2(2000));
- Insert one row into that table containing the message you want your users to see when they attempt to login with Free Toad.
- Grant select access on that table to PUBLIC. If the table exists AND is populated with at least one row, the freeware will not connect to that database.
Does anyone know how to import data from an Excel file into a table?
- METHOD 1: See Database → Import → Source Files. This window can be used to import data from various kinds of source files into a table.
- METHOD 2: SQL*Loader You can use TOAD's interface to a program from Oracle called sqlloader. Save the Excel file as a comma-delimited (.csv) or tab-delimited (.txt) file. If your data has commas within a text field, save your file as tab-delimited.
- Open DBA→Sql Loader Wizard
- Choose "build a new control file". Next.
- Click "Add". Choose your comma-delimited or tab-delimited file. Next.
- Click "Add". Choose your table.
- If you are loading a comma-delimited file, type a comma in the "all fields delimited by" combo box. If you are loading a tab-delimited file, select "TAB" from the "all fields delimited by" combo box. Next.
- Choose a "load method" noting the following:
- TRUNCATE will erase whatever is in the table before loading.
- INSERT will insert data if table is empty but will return an error if table has any data in it.
- APPEND will insert data without deleting any existing data. You might get duplicates this way but it's a good method if you're trying to get that last line that somehow got munged for some reason or another.
- If your file has column headers in its first row, type a 1 in the skip box. Next.
- Type a control file name in the control file name box. Next.
- Choose either "execute now" to load the data now or "just build the control file" to build the .ctl file. Once you have the ctl file theoretically you don't even need TOAD, as you could just use sqlloader on any machine that has sqlloader and can connect to the database. But why would you want to. :) I choose execute now.
Note: If you are working with Oracle 8.0 or earlier on a Windows 2000 or later OS, uncheck "Watch Progress"
Note: once you have a ctl file you can:
- Choose DBA→Sql Loader Wizard
- Choose "Use control file". Next.
- Select your control file. Next.
- Choose "execute now". Finish.
How can I get synonyms and views to show up in the SQL Modeler?
Check the options "Show Views on Table Selector" and "Show Synonyms on Table Selector" under Options → Editors. The next time you open the SQL Modeler, your views and synonyms will show up.
I can no longer perform a Trace Start/Trace Stop, either through Oracle or through TOAD's Session Browser.
Oracle changed access to the dbms_system package which contains the trace procedure. Try the following:
CREATE PUBLIC SYNONYM dbms_system FOR sys.dbms_system; GRANT EXECUTE ON sys.dbms_system TO DBA;
I have a flat file (.csv, tab delimited, etc.) and I want to import the data to a table. What is the best way to do that using TOAD?
For a relatively small file (a few thousand rows) try Database → Import → Table Data. It's very easy to use, and the whole load takes place within TOAD. For a large file, use DBA → SQL Loader wizard. That lets you set up a control file for Oracle's SQL*Loader utility and run it. Of course, if you use this you will need to have the Oracle SQL*Loader installed on your client. See the Help file with its "SQL*Loader Wizard tutorial" for more information.
I keep getting the error "ORA-01460 unimplemented or unreasonable conversion requested"
Your database character set is probably UTF8 or another Unicode character set, which TOAD does not currently support. There used to be a recommended workaround to change your Oracle client's NLS_LANG value to AMERICAN_AMERICA.UTF8, which will eliminate these error messages. But this can result in the wrong data being inserted into your database when you update records, because TOAD does not know how to interpret UTF8 data. TOAD 7.5 and up does not give these ORA-01460 errors except in TOAD Reports, but it still does not support UTF8, in that non-ASCII data may be retrieved and/or inserted incorrectly.
In the Session Browser, on the Waits tab, I'm seeing a "-2" as the value of WAIT_TIME for "SQL*Net message from client".
The WAIT_TIME column contains a value of -2 on platforms that do not support a fast timing mechanism. If you are running on one of these platforms and you want this column to reflect true wait times, you must set the TIMED_STATISTICS parameter to TRUE. Remember that doing this has a small negative effect on system performance
My procedure editor toolbar icon is grayed out, and there are some other things on the Create menu that are grayed out. I can't edit any of the data grids, either. What's going on?
Somehow, your TOAD has become read only. There are 3 possibilities.
- One possibility is that the file "readonly.lic" has been copied over "toad.lic". To see if this is the problem, replace the "toad.lic" file in your Toad directory with "fulltoad.lic" and then restart TOAD. If you do not have a "toad.lic" or "fulltoad.lic" at all, then you will need to reinstall TOAD.
- Another possibility is that someone has implemented TOAD Security on your database and made your user or one of your roles read only. Run the following query:
select user_name, feature
from toad.toad_restrictions
where user_name=USER or user_name in
(select ROLE from session_roles)
If one of the results that comes back contains "Read only override", then that's the problem. Your TOAD will be read only unless you have the DBA role.
- A third possibility is that you have a read-only version of the TOAD executable. This would only happen if you downloaded the read only installation from Quest's website.
Why am I getting "File not Found" when using certain Toad Options?
Browsing for a file name using certain browse-for-file dialogs in options unnecessarily adds double quotes to the path, which results in an error when the option is used. Double quotes are added when the file path/name isn't DOS/8.3 compatible. This issue will not occur if the path/file are entered manually. The following locations are affected: Options > Startup > "File to load on startup" and "File to execute on new connections", Options > Executables, Options > Monitors > "Alert file".
The workaround is to remove the double quotes added by the browse dialog or manually enter the path/file name into the field.
What configuration files need to be copied from one system to another to preserve preferences for the Editor,Files to launch at startup, connections to make etc?
Install Toad on your laptop so you get all the registry stuff done. Zip up your desktop install and extract it over your desktop install. Voila.
Settings Files
| File Name | Description |
|---|---|
| \User Files\CodeMap.ini | Ini file for Code Road Map. |
| \User Files\MenuShortcuts.ini | |
| \User Files\PEBARS.INI | |
| \USER FILES\TOOLBARS.INI | |
| \Toad\DataBaseProbe.ini | Saves the Database probe settings. |
| cnvfuncs.txt | Data Conversion Functions. |
| DatabaseProbe.INI. | Copy |
| datefmts.txt | Date Format Options. |
| datfuncs.txt | Date Functions. |
| Desktops.xml | Saves the layout of the desktop in an XML format. |
| FILTERS.TXT | Saves Filter rules set-up by the user. |
| fmtoptions.ini | |
| grpfuncs.txt | |
| html.dci | |
| html.dci | |
| htmlkeys.bin | |
| htmlopts.txt | |
| htmlscr.txt | HTML Syntax Highlighting Support. |
| htmlsub.txt | |
| inikeys.bin | |
| iniopts.txt | |
| iniscr.txt | INI Syntax highlighting support. |
| inisub.txt | |
| javascr.txt | JAVA Syntax highlighting support. |
| jobdates.txt | |
| longscr.txt | Syntax highlighting in the SQL Editor and Procedure Editor. |
| mscfuncs.txt | Other Misc. Functions. |
| newfunc.sql | Template |
| newpackage.sql | Template |
| newpackagebody.sql | Template |
| newpkgfunc.sql | Template |
| newpkgproc.sql | Template |
| newproc.sql | Template |
| newtrig.sql | Template |
| newtype.sql | Template |
| newtypebody.sql | Template |
| newtypefunc.sql | Template |
| newtypeproc.sql | Template |
| nmbrfmts.txt | Number Format Options. |
| numfuncs.txt | Single Row Number Functions. |
| opthints.txt | SQL Optimizer Hints. |
| Oracle 8i Data Dictionary.sdf | |
| plsql.dci | |
| plsqlkeys.bin | |
| plsqlopts.txt | |
| plsqlscr.txt | Syntax highlighting in the SQL Editor and Procedure Editor. Main file. |
| plsqlsub.txt | |
| plsqlsub.txt | |
| predfxcp.txt | Defined Exceptions |
| prnt.txt | Saves the Debug DBMS output to a file and then prints it out. |
| pseudo.txt | Oracle Pseudo Columns. |
| Schema Objects.sdf | |
| ScriptMgr\DBA\*.sql | |
| ScriptMgr\Schema Objects\*.sql | |
| shortscr.txt | Syntax highlighting in the SQL Editor and Procedure Editor. The default - PLSQLSCR.TXT = SHORTSCR.TXT |
| strfuncs.txt | Single Row Character functions. |
| text.dci | |
| textkeys.bin | |
| textopts.txt | |
| textscr.txt | TEXT Syntax highlighting support. |
| textsub.txt | |
| Toad\ ExportWizSettings.ini | |
| Toad\CONNECTIONS.INI | Stores connection information such as passwords, usernames, and servers. |
| Toad\DbWizSettings.ini | Saves the Database settings. |
| Toad\DefaultSaveName | Saves the Sql Edit Window to file without prompting. |
| Toad\ImportWizSettings.ini | |
| Toad\Project.tpr | |
| Toad\ProjectConfig.txt | |
| Toad\Reportparams.ini | Initialization files for the reports feature. |
| Toad\SavedSQL.xml | A list of user named SQLs, user personal SQLs, and Toad\SBQueries.dat |
| Toad\SCHEMA.FLT | Schema filters files. If you use browser filters, TOAD creates SCHEMA.FLT files. |
| Toad\Services.ini | |
| Toad\SQLLoaderSettings.ini | Stores Sql Loader settings. |
| Toad\SQLPLS.SQL | |
| Toad\ssql.sql | |
| Toad\User Files\%Connection.Server%\Projects.Lst | |
| Toad\User Files\%Lang%scr.txt | |
| Toad\User Files\%User%_%Server%.LST | |
| Toad\USER FILES\ALIASES.TXT | List of user-defined table aliases. |
| Toad\User Files\DataModeler.ini | |
| Toad\USER FILES\FILECOMPARE.INI | |
| Toad\User Files\ftp.ini | |
| Toad\User Files\KILLSESS.INI | |
| Toad\User Files\KILLSESS2.INI | |
| Toad\User Files\MenuShortcuts.ini | |
| Toad\User Files\PARAMS.TXT | |
| Toad\User Files\SAVEDSQL.xml | |
| Toad\User Files\SBFilterHist.xml | |
| Toad\User Files\SEBARS.INI | |
| Toad\User Files\SGATRACE.INI | |
| Toad\User Files\SQLFILES.TXT | |
| Toad\User Files\SQLRFIND.txt | |
| Toad\User Files\tblsp.sql | |
| Toad\User Files\TEXTSCR.TXT | TEXT Syntax highlighting support. |
| Toad\User Files\TOOLBARS.INI | |
| Toad\User Files\USERSTAT.SQL | |
| Toad\User Files\USRFUNCS.TXT | User Provided Function List. |
| Toad\Toad.ini | Initialization parameters file. |
| Toad\Toad_gui.ini | Third party component file. No control over it. |
| Toad\TOADMAIL.INI | |
| Toad\TOADMONITORS.INI | |
| Toad\TOADPARAMS.INI | |
| Toad\TopSess.ini | |
| Toad_SESSBROWFILTERS.ini | canned filters for SessionBrowser |
| toadstats.ini | |
| Toad\User Files\SRBARS.INI | |
| Toolbar_templates\*.ini | |
| Unixjobs\base\* |
What is the Project Manager? What is it good for? How do I start using it?
The Project Manager is a window in TOAD that helps you accomplish your frequent tasks with the least amount of effort. Interested in reading more? Click Here.
When I FTP, why are my filenames blank or corrupted?
Your FTP Server is returning an unknown format of LIST (Long dIrectory LisTing). You may workaround this by setting your default FTP directory to '/' at the login screen.
When I connect to an Oracle 9.0.1.4 database using the Database Browser the values in the SGA area of the Overview tab are sometimes way off. For example, on one instance the max value in the graph is 16,000,000,000,000 MB! This appears to occur only for Oracle 9.0.1.4 instances which I connect to using a shared session (MTS)
This is a known Oracle bug (# 2106606 - verified and tested)
When I login to Toad, the SQL Editor Window screen will open partially, and Toad displays an error message 'Member not Found.'
If you have SQLab Developer, the file - Xpert_InterCommProj1.ocx - needs updated for the Xpert Tuning Module. SQLab has included an executable file, sqlabocx.exe, in the SQLab Tuning folder that will re-installs and registers the correct OCX file for that version of SQLab Xpert.
When I try to FTP a file or even list a directory, i get a 'RETR command not understood' error message. What's the problem?
The problem is that this server is non RFC compliant. The RETR request asks the server to send the contents of a file over the data connection already established by the client as specified in the FTP RFC. Our components are build to be RFC compliant and it is sending the RETR cmd, which the server is not recognizing.
Where did auto-open on startup of various windows go?
Starting with 7.5 you can now auto-open almost any TOAD window. Therefore the options have all been consolidated and moved to Options → Windows.
Why are my toolbar icons faded?
If you have a Win98 client, upgrade your display adapter from version 4.11 to 4.12
Why does TOAD have problems loading large packages/procs over my VPN?
Perhaps the SQL Net configuration needs tuned. Try this: Some SQL Net issues worth a try with VPN's (note - this is not a TOAD issue):
SQLNet.ora file
TCP.NODELAY=yes SQLNET.EXPIRE_TIME=10
TNSNames.ora file
SDU=2920
Why does TOAD suddenly put itself first on the Z-lists? The last time for me was when I looked at the properties for a printer.
One of the third-party components we are using is trapping for WM_SETTINGCHANGED message in a WNDPROC. This is also why TOAD hops to the foreground after making any desktop change that causes a WM_SETTINGCHANGED message. This has been fixed for Release 7.3
Why does the Export Utility Wizard fail when using a 10g client?
When using the export utility (exp.exe) supplied with 10g clients you may see results like this.
Message 206 not found; No message file for product=RDBMS, facility=EXP: Release 10.1.0.2.0 - Production on Tue Jan 18 09:43:09 2005
Copyright © 1982, 2004, Orac
Invalid format of Export utility name
Verify that ORACLE_HOME is properly set
Export terminated unsuccessfully
EXP-00000: Message 0 not found; No message file for product=RDBMS, facility=EXP
The solution for this error is to add the environment variable 'ORACLE_HOME' and set its value to the ORACLE_HOME value for your client (ex. C:\Oracle\Ora10g).
QSR (Quest Script Runner) says it is expired?
This message means that you have uninstalled, removed your license key, deleted the directory where tha last version of Toad was installed or deleted the key found where you last installed Toad. Make sure the SERVER key in the registry points towards a licensed installation of Toad.
- run REGEDIT,
- hkey_local_machine –> Software –> Quest Software –> Toad –> SERVER
Why am I getting an error message that says "IN is not a valid integer" when I try to look at the source of a procedure?
You are connecting to an Oracle 10G release 2 database (10.2.0.2 or higher) and you have a version of TOAD that is less than 8.6.1. Oracle made a change to the ALL_ARGUMENTS view at release 10.2.0.2 and this 'broke' TOAD.
The solution is either to :
- Stop connecting to 10.2.0.2 or newer databases :o)
- Upgrade to TOAD version 8.6.1 or higher.
- Alter the ALL_ARGUMENTS view in your database, moving the SUBPROGRAM_ID column to the end. Altering the data dictionary is unsupported by Oracle, so you probably should not do this to a production database. It does, however, seem to do the trick, with no known side effects.
What V$ tables are required in order to use the various windows in Toad?
NOTE: This list is always expanding. If you receive a "Table does not Exist" error, you can find what table is missing by spooling SQL to screen to see the code Toad is using.
Access to V$ synonyms required on selected Toad windows are:
AutoTrace (Editor/Query Builder)
- V_$Sesstat
- V$Statname
- V$Session
Optimization & Session Info screens
The following public synonyms must be present:
- v$rowcache
- v$sysstat
- v$system_event
- v$librarycache
- v$STATNAME
- v$SESSTAT
- v$sess_io
- v$session
- v$process
- v$latch
Database Browser
The following public synonyms must be present:
- V$DATABASE
- v$datafile
- v$filestat
- V$INSTANCE
- v$latch
- v$librarycache
- V$OPTION
- V$PARAMETER
- v$rollname
- v$rollstat
- v$sess_io
- v$session
- v$sesstat
- v$sgastat
- v$sqlarea
- v$statname
- v$sysstat
- v$system_event
- v$tablespace
Database Probe
The following public synonyms must be present:
- V$ARCHIVE_PROCESSES
- V$BH
- v$buffer_pool
- V$buffer_pool_statistics
- v$database
- v$dispatcher
- V$INSTANCE
- v$librarycache
- v$library_cache_memory
- V$LOG
- V$LOG_history
- V$PARAMETER
- v$pq_slave
- v$process
- V$ROWCACHE
- v$session
- V$SESSTAT
- v$sga
- v$sgastat
- V$STATNAME
- v$sysstat
- v$version
Database Monitor
The following public synonyms must be present:
- v$sysstat
- v$system_event
- v$session
- v$librarycache
- x$ksllt
- v$sgastat
Database Health Check
The following public synonyms must be present:
- v$version
- v$instance
- v$sysstat
- v$librarycache
- v$rowcache
- v$sgastat
- v$parameter
- v$database
- v$log_history
- v$filestat
- v$datafile
- v$tablespace
Index Monitor
To see indexes other than your own you must have access to the following:
- sys.ob$
- sys.ind$
- sys.user$
- sys.object_usage
You must also have the ALTER ANY INDEX privilege.
Oracle Parameters
The following public synonym must be present:
- v$parameter
LogMiner
The following public synonyms must be present:
- v$logmnr_contents
- v$logmnr_logs
You must also have:
- Execute privileges on DBMS_logmnr
- Execute privileges on DBMS_logmnr_d
- the Parameter UTL_FILE_DIR set in init.ora (Oracle 8i only)
SGA Trace
The following public synonyms must be present:
- v$sqlarea
- v$sqltext_with_newlines
You must also have access to the V$ Oracle Dictionary views
Debugging
No special public synonyms required. However, DBMS_DEBUG must be valid
On 10g databases, Debug Connect Session privileges must be granted
eBiz Module
- SYS.OBJ$ – used only in Activity tab of the browser
- SYS.USER$ – used only in Activity tab of the browser
- V$INSTANCE – used only in Activity and 'User' tabs of the browser
- V$LOCK – used only in Activity tab of the browser
- V$PROCESS – used only in Activity tab of the browser
- V$SESS_IO – used only in Activity tab of the browser
- V$SESSION – used only in Activity tab of the browser
In addition, you will need SELECT privileges on many Oracle Applications views
Instance Manager > Shutdown
The following public synonym must be present:
- v$parameter
- V$INSTANCE
Toad Server Statistics > Analysis
The following public synonyms must be present:
- V$SESS_IO
- V$SESSION
- V$PROCESS
- V$STATNAME
- V$ROWCACHE
- V$SYSSTAT
- V$SYSTEM_EVENT
- V$LIBRARYCACHE
- V$SESSION_PRIVS
Toad Server Statistics > Waits
The following public synonym must be present:
- V$SYSTEM_EVENT
Toad Server Statistics > Latches
The following public synonym must be present:
- V$LATCH
Toad Server Statistics > Sessions
The following public synonyms must be present:
- V$SESS_IO
- V$SESSION
- V$PROCESS
- V$STATNAME
Toad Server Statistics > Instance Summary
The following public synonym must be present:
- V$SYSSTAT
Toad Session Browser
The following public synonyms must be present:
- V$SESSION
- V$PROCESS
- V$SESS_IO
- V$SESSION_WAIT
- V$SESSION_EVENT
- V$ACCESS
- V$SESSSTAT
- V$STATNAME
- V$OPEN_CURSOR
- V$SQL
- V$LOCK
- V$SESSION_LONGOPS
- V$SQLTEXT_WITH_NEWLINES
In addition, you must have access to the following:
- SYS.V_$TRANSACTION
- SYS.V_$ROLLNAME
Space Manager Setup
The following public synonym must be present:
- V$SYSSTAT
The Toad schema must have the privileges to create and alter jobs, create and drop its own tables and procedures, and must have SELECT access on the following:
- DBA_DATA_FILES
- DBA_FREE_SPACE
- DBA_JOBS
- DBA_TABLESPACES
- V_$FILESTAT