DOCUMENT:Q222937  09-NOV-2001  [sna]
TITLE   :INF: Creating a Linked Server to DB2 w/ OLE DB Provider for DB2
PRODUCT :Microsoft SNA Server
PROD/VER::4.0 SP2,4.0 SP4
OPER/SYS:
KEYWORDS:

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft OLE DB Provider for DB2, version 4.0 SP2 
 - Microsoft Host Integration Server 2000 
 - Microsoft SNA Server, version 4.0 SP4 
-------------------------------------------------------------------------------

SUMMARY
=======

This article provides a sample SQL script for creating a linked server to DB2
using sp_addlinkedserver, and issues a few queries to illustrate the Distributed
Query Processing (DQP) using DB2OLEDB, the Microsoft OLE DB provider for DB2.
Please refer to the following article in the Microsoft Knowledge Base for
information on the keywords used in the DB2OLEDB initstring.

   Q218590 INF: Configuring Data Sources for the Microsoft OLE DB Provider for
   DB2

Creating Linked Server
----------------------

   EXEC sp_addlinkedserver
   @server = 'WNW3XX',
   @srvproduct = 'Microsoft OLE DB Provider for DB2',
   @catalog = 'OLYMPIA',
   @provider = 'DB2OLEDB',
   @provstr='NetLib=SNA;NetAddr=;NetPort=;RemoteLU=OLYMPIA;LocalLU=LOCAL;ModeName=QPCSUPP;User ID=WNW3XX;Password=WNW3XX;InitCat=OLYMPIA;Default Schema=WNW3XX;PkgCol=WNW3XX;TPName=;Commit=YES;IsoLvl=NC;AccMode=;CCSID=37;PCCodePage=1252;BinAsChar=NO;Data Source=Olympia_WNW3XX'

   EXEC sp_addlinkedsrvlogin 'WNW3XX', false, NULL, 'WNW3XX', 'WNW3XX'

Please note that:

 - DB2OLEDB provider needs to run in-proc. To enable this setting:

   1. Start the Microsoft SQL Server Enterprise Manager.

   2. In the Console tree, find the Linked Servers node (under the Security
      folder). Right-click on the linked server created above, and in the
      Properties dialog box, click the General tab, then click on Options, and
      click to enable the Allow InProcess setting. This is the only way to
      enable this setting, and after it has been enabled for a given provider,
      the setting is used for every subsequent linked server created using that
      provider, including the ones created with T-SQL script.

 - The total length of the linked server initstring must be no more than 278
   characters, so it is advantageous to use the DB2OLEDB short connection string
   arguments as documented above.

 - Linked Servers using DB2OLEDB can also be configured to connect over TCP/IP,
   though the above script illustrates this using an SNA APPC connection.

Sample Distributed Queries
--------------------------

Example of SELECT using 4-part name: LinkedServer.Catalog.Schema.Table
SELECT * FROM WNW3XX.OLYMPIA.WNW3XX.DEPARTMENT

Example of Pass Through SELECT using OPENQUERY with 3-part name:
SELECT * FROM OPENQUERY(WNW3XX,"SELECT * FROM OLYMPIA.WNW3XX.EMP_ACT")

Example of Pass Through SELECT using OPENROWSET with 2-part name:
SELECT * FROM OPENROWSET
('DB2OLEDB',Netlib=SNA;NetAddr=;NetPort=;RemoteLU=OLYMPIA;LocalLU=LOCAL;ModeName=QPCSUPP;User
ID=WNW3XX;Password=WNW3XX;InitCat=OLYMPIA;Default
Schema=WNW3XX;PkgCol=WNW3XX;TPName=;Commit=YES;IsoLvl=NC;AccMode=;CCSID=37;PCCodePage=1252;BinAsChar=NO;Data
Source=Sample',
'SELECT * FROM WNW3XX.EMPLOYEE' )

Example of an INSERT using 4-part name:
INSERT INTO WNW3XX.OLYMPIA.WNW3XX.DEPARTMENT VALUES
('E21','DUMMY',NULL,'E01')

Note that UPDATE and DELETE using DQP are not possible with the DB2OLEDB provider
that shipped with SNA version 4.0 Service Pack 2 and Service Pack 3 due to lack
of bookmark support, but these do work with the SNA 4.0 Service Pack 4 provider
and the provider that shipped with Host Integration Server 2000. For more
information on this, see the following article in the Microsoft Knowledge Base:

   Q287093 DB2OLEDB Supports UPDATE/DELETE from SQL Linked Server

Example of JOIN between a SQLServer and DB2 table:
SELECT A.EMPLOYEE_NUMBER,B.ACTNO FROM CORPDATA..EMPLOYEE_ACCOUNT A,
WNW3XX.OLYMPIA.WNW3XX.EMP_ACT B WHERE A.EMPLOYEE_NUMBER = B.EMPNO ORDER BY
A.EMPLOYEE_NUMBER

Additional query words: AS/400 MVS OS/390 Mainframe

======================================================================
Keywords          :  
Technology        : kbAudDeveloper kbOLEDBSearch kbSNAServSearch kbHostIntegServ2000 kbOLEDBProvDB2400SP2 kbSNAServ400SP4 kbOLEDBProvSearch
Version           : :4.0 SP2,4.0 SP4
Issue type        : kbinfo

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2001.