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