home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / VISUAL_B / PROGRAMS / ORACLE11 / ORACLE.TXT < prev    next >
Encoding:
Text File  |  1993-08-25  |  12.3 KB  |  280 lines
  1. SETTING UP THE ODBC ORACLE DRIVER FOR USE WITH THE SQL*NET FOR WINDOWS DLLs
  2.  
  3. This file discusses how to set up the ODBC ORACLE driver to run with your 
  4. ORACLE Server software. To use the ODBC ORACLE driver with any large 
  5. application, such as Microsoft Access, you must use the SQL*Net for Windows 
  6. DLLs. Because the ODBC ORACLE driver is designed to use ORACLE Server 
  7. version 6 and the SQL*Net for Windows DLLs are designed to use ORACLE Server 
  8. version 7, you must be careful to configure your system correctly.
  9.  
  10. If you do not have the SQL*Net for Windows DLLs, or, after following the
  11. instructions in this file, you are still unable to connect to ORACLE Server
  12. with SQL*Net, you can contact Oracle Corp. at 1-800-345-DBMS.
  13.  
  14.  
  15. If ORACLE Server version 6 is already installed on your system
  16. --------------------------------------------------------------
  17.  
  18. To set up the ODBC ORACLE driver and the SQL*Net for Windows DLLs if you 
  19. already have ORACLE Server version 6 on your system:
  20.  
  21. 1.  Make sure you have the correct versions of ORACLE products, including at 
  22.     least one SQL*Net protocol.
  23.  
  24.     Product                                  Version
  25.     --------------------------------         -----------
  26.     ORACLE Installer                         3.0.8.3.7
  27.     Required Support Files                   7.0.12.1.0
  28.     SQL*Net Named Pipes for Windows          1.1.1.3
  29.     SQL*Net SPX for Windows                  1.1.1.5
  30.     SQL*Net TCP/IP for Windows               1.1.7.6
  31.  
  32. 2.  Test your current SQL*Net connection by using an ORACLE tool such as 
  33.     SQL*Plus for Windows.
  34.  
  35. 3.  Search for and delete all copies of ORA6WIN.DLL from your system. A new
  36.     (backwards compatible) version of ORA6WIN.DLL will be installed with the
  37.     ODBC ORACLE driver.
  38.  
  39. 4.  Run the ORACLE Installer program. When asked for your ORACLE installation
  40.     directory, use the suggested default directory.
  41.  
  42. 5.  Follow the instructions in "Setting Up SQL*Net for Windows" to install
  43.     the SQL*Net for Windows DLLs and support files.
  44.  
  45. 6.  If the following line exists, remove it from your AUTOEXEC.BAT file:
  46.  
  47.       SET CONFIG=<oracle_configuration_file>
  48.  
  49.     Add the following line to your AUTOEXEC.BAT file:
  50.  
  51.       SET CONFIG_FILES=C:\WINDOWS\ORACLE.INI
  52.  
  53.     NOTE: If you are using the MS-DOS 6.0 operating system, add the following 
  54.     line to the end of your AUTOEXEC.BAT file:
  55.  
  56.       SET CONFIG=
  57.  
  58.     ORACLE Server first checks the CONFIG environment variable for the path of
  59.     the ORACLE configuration file. If the CONFIG variable is not set, ORACLE
  60.     Server checks the CONFIG_FILES variable. Because MS-DOS 6.0 can use the 
  61.     CONFIG environment variable during system startup, you must clear this 
  62.     variable before leaving your AUTOEXEC.BAT file. Otherwise, ORACLE Server 
  63.     will use its value as the path of the ORACLE configuration file.
  64.  
  65. 7.  So that you can use Oracle Version 6 Tools, follow the directions in
  66.     the "Oracle Version 6 Tools Configuration" section of the ORACLE manual
  67.     "Setting Up SQL*Net for Windows".
  68.  
  69. 8.  So that SQL*Net for Windows runs properly, follow the directions in
  70.     the "Verify and Update CONFIG.SYS File" section of the ORACLE manual
  71.     "Setting Up SQL*Net for Windows".
  72.  
  73. 9.  If it is not already running, start Windows. Insert the ODBC Setup disk 
  74.     in drive A, choose Run from the Windows Program Manager (or File Manager)
  75.     File menu, and then type "a:\setup.exe" in the Command Line box. For 
  76.     information about using the ODBC Setup program, see the online Help.
  77.  
  78. 10. Run the ODBC Control Panel option and add a data source for your ORACLE
  79.     server. For information about using the ODBC Control Panel option, see
  80.     the online Help.
  81.  
  82. You should now be able to run the ODBC ORACLE driver. You should also be 
  83. able to run ORACLE version 6 and version 7 tools and applications written for 
  84. Windows. All of these can run over SQL*Net for Windows DLLs.
  85.  
  86. NOTE:  Due to differences in memory use, this configuration may not allow you 
  87. to run ORACLE MS-DOS-only tools or applications.
  88.  
  89.  
  90. If ORACLE Server is not installed on your system
  91. ------------------------------------------------
  92.  
  93. To set up the ODBC ORACLE driver and the SQL*Net for Windows DLLs if you do not
  94. have any versions of ORACLE Server on your system:
  95.  
  96. 1.  Make sure that you have the correct versions of ORACLE products, including 
  97.     at least one SQL*Net protocol.
  98.  
  99.     Product                                  Version
  100.     --------------------------------         -----------
  101.     ORACLE Installer                         3.0.8.3.7
  102.     Required Support Files                   7.0.12.1.0
  103.     SQL*Net Named Pipes for Windows          1.1.1.3
  104.     SQL*Net SPX for Windows                  1.1.1.5
  105.     SQL*Net TCP/IP for Windows               1.1.7.6
  106.  
  107.  
  108. 2.  Install the network software connecting your client workstation to the
  109.     server and check that a connection can be made. For example, for the 
  110.     TCP/IP protocol, type "ping <servername>". This connection must work 
  111.     before you install the SQL*Net for Windows DLLs.
  112.  
  113. 3.  Search for and delete all copies of ORA6WIN.DLL from your system. A new
  114.     (backwards compatible) version of ORA6WIN.DLL will be installed with the
  115.     ODBC ORACLE driver.
  116.  
  117. 4.  Run the ORACLE Installer program. When asked for your ORACLE installation
  118.     directory, use the suggested default directory.
  119.  
  120. 5.  Follow the instructions in "Setting Up SQL*Net for Windows" to install
  121.     the SQL*Net for Windows DLLs and support files.
  122.  
  123. 6.  Add the following line to your AUTOEXEC.BAT file:
  124.  
  125.       SET CONFIG_FILES=C:\WINDOWS\ORACLE.INI
  126.  
  127.     NOTE: If you are using MS-DOS 6.0, add the following line to the end 
  128.     of your AUTOEXEC.BAT file:
  129.  
  130.       SET CONFIG=
  131.  
  132.     ORACLE Server first checks the CONFIG environment variable for the path of
  133.     the ORACLE configuration file. If the CONFIG variable is not set, ORACLE
  134.     Server checks the CONFIG_FILES variable. Because MS-DOS 6.0 can use the 
  135.     CONFIG environment variable during system startup, you must clear this 
  136.     variable before leaving your AUTOEXEC.BAT file. Otherwise, ORACLE Server 
  137.     will use its value as the path of the ORACLE configuration file.
  138.  
  139. 7.  Make sure your PATH variable includes the C:\ORAWIN\BIN directory. To do
  140.     this, add the following line to your AUTOEXEC.BAT file:
  141.  
  142.       SET PATH=%PATH%;C:\ORAWIN\BIN
  143.  
  144. 8.  So that the ODBC ORACLE driver can use ORACLE version 7 error messages, 
  145.     copy the version 7 error messages to the directory where the ODBC
  146.     ORACLE driver searches for error messages:
  147.  
  148.       COPY C:\ORAWIN\RDBMS70\*.MSB C:\ORAWIN\DBS
  149.  
  150. 9.  If it is not already running, start Windows. Insert the ODBC Setup disk
  151.     in drive A, choose Run from the Windows Program Manager (or File Manager)
  152.     File menu, and then type "a:\setup.exe" in the Command Line box. For 
  153.     information about using the ODBC setup program, see the online Help.
  154.  
  155. 10. Run the ODBC Control Panel option and add a data source for your ORACLE
  156.     server. For information about using the ODBC Control Panel option, see
  157.     the online Help.
  158.  
  159. You should now be able to run the ODBC ORACLE driver.
  160.  
  161.  
  162. ORACLE Error Messages
  163. ---------------------
  164. The following section explains what to do when you encounter various error
  165. messages from ORACLE Server through the ODBC ORACLE driver.
  166.  
  167.  
  168. ORA-xxxxx Message not found; product = RDBMS; facility = ORA; language = NULL
  169. -----------------------------------------------------------------------------
  170.  
  171. The ODBC ORACLE driver searches for error messages in the subdirectory that
  172. normally contains the ORACLE version 6 error messages. If you receive this
  173. error, it means that the ODBC ORACLE driver cannot find the error messages.
  174. To fix this:
  175.  
  176. 1.  Check that the CONFIG_FILES variable is set in your AUTOEXEC.BAT file and
  177.     that it points to your ORACLE configuration file (ORACLE.INI). If you are
  178.     using MS-DOS 6.0, check that the CONFIG environment variable is either not 
  179.     set or is cleared in the last line of your AUTOEXEC.BAT file.
  180.  
  181. 2.  Check that the ORACLE_HOME variable is set correctly in your
  182.     C:\WINDOWS\ORACLE.INI file.
  183.  
  184.     If ORACLE Server version 6 was already installed on your system,
  185.     ORACLE_HOME should be set twice. The first time, it should be set to your
  186.     version 6 <oraclehome> directory, usually C:\ORACLE6. The second time, in
  187.     the [Oracle] section of the file, it should be set to C:\ORAWIN.
  188.  
  189.     If ORACLE Server was not installed on your system, ORACLE_HOME should be
  190.     set to C:\ORAWIN.
  191.  
  192. 3.  If you did not have any ORACLE software on your workstation, make sure 
  193.     that you copied all the .MSB files from C:\ORAWIN\RDBMS70 to C:\ORAWIN\DBS.
  194.  
  195. The ODBC ORACLE driver should now be able to print the ORACLE Server error
  196. message, enabling you to fix the problem that generated the error.
  197.  
  198.  
  199. ORA-03121  No interface driver connected -- function not performed
  200. ------------------------------------------------------------------
  201.  
  202. The ODBC ORACLE driver cannot find ORA6WIN.DLL or one of the SQL*Net 
  203. components. Check the following:
  204.  
  205. 1.  Without running the ODBC ORACLE driver, make sure the network connection 
  206.     is valid. For example, type "ping <servername>" for a TCP/IP connection.
  207.  
  208. 2.  Search for and delete old versions of ORA6WIN.DLL. The correct version of
  209.     the ORA6WIN.DLL was installed by the ODBC ORACLE driver in the SYSTEM
  210.     subdirectory of your Windows directory.
  211.  
  212. 3.  Check that the PATH variable contains the BIN subdirectory of the
  213.     <oraclehome> directory (usually C:\ORACLE6\BIN or C:\ORAWIN\BIN).
  214.  
  215. 4.  Check that the CONFIG_FILES variable is set in your AUTOEXEC.BAT file and
  216.     that it points to your ORACLE configuration file (ORACLE.INI). If you are
  217.     using MS-DOS 6.0, check that the CONFIG environment variable is either not 
  218.     set or is cleared in the last line of your AUTOEXEC.BAT file.
  219.  
  220. 5.  Check that SQLTCP.DLL (for TCP/IP), SQLSPX.DLL (for Novell NetWare 
  221.     IPX/SPX), or SQLNMP.DLL (for Named Pipes) is in the ORACLE BIN directory 
  222.     specified in the PATH variable. (If not, SQL*Net was not installed 
  223.     correctly.)
  224.  
  225. 6.  Check that ORA7WIN.DLL and COREWIN.DLL are in the ORACLE BIN directory
  226.     specified in the PATH variable. (If not, SQL*Net was not installed
  227.     correctly.)
  228.  
  229.  
  230. ORA-06120  NETTCP: network driver not loaded
  231. --------------------------------------------
  232.  
  233. This error can occur when ORA6WIN.DLL is loaded but cannot find another
  234. SQL*Net component, such as SQLTCP.DLL.
  235.  
  236. 1.  Check that the directories containing the SQL*Net components are in your
  237.     PATH variable.
  238.  
  239. 2.  Check that the ORACLE_HOME variable is set correctly in your
  240.     C:\WINDOWS\ORACLE.INI file.
  241.  
  242.     If ORACLE Server version 6 was already installed on your system,
  243.     ORACLE_HOME should be set twice. The first time, it should be set to your
  244.     version 6 <oraclehome> directory, usually C:\ORACLE6. The second time, in
  245.     the [Oracle] section of the file, it should be set to C:\ORAWIN.
  246.  
  247.     If ORACLE Server was not installed on your system, ORACLE_HOME should be
  248.     set to C:\ORAWIN.
  249.  
  250. 3.  Search for and delete old versions of ORA6WIN.DLL. The correct version of
  251.     the ORA6WIN.DLL was installed by the ODBC ORACLE driver in the SYSTEM
  252.     subdirectory of your Windows directory.
  253.  
  254. 4.  Check that you have followed all the instructions for the SQL*Net driver
  255.     you are using. For example, for the SQL*Net for TCP/IP driver, make sure
  256.     that all the TSRs, such as NMTSR and SOCKTSR, are loaded. (If not,
  257.     SQL*Net was not installed correctly.)
  258.  
  259.  
  260. ODBC Error Messages
  261. -------------------
  262. The following section explains what to do when you encounter various ODBC
  263. error messages.
  264.  
  265.  
  266. IM003    Driver specified by data source could not be loaded
  267. -----------------------------------------------------------
  268.  
  269. The ODBC Driver Manager is attempting to load the ODBC ORACLE driver
  270. (SQORA.DLL). SQORA.DLL loads ORA6WIN.DLL to connect to the ORACLE server.
  271. You can receive this message if it cannot find ORA6WIN.DLL or finds the wrong
  272. version of ORA6WIN.DLL.
  273.  
  274. 1.  Search for and delete old versions of ORA6WIN.DLL. The correct version of
  275.     the ORA6WIN.DLL was installed by the ODBC ORACLE driver in the SYSTEM
  276.     subdirectory of your Windows directory.
  277.  
  278. 2.  Make sure that ORA6WIN.DLL was installed when the ODBC ORACLE driver was
  279.     installed.
  280.