DOCUMENT:Q160892  23-JUL-1999  [accother]
TITLE   :ADT95: Including Briefcase Replication in a Custom Application
PRODUCT :Microsoft Access Distribution Kit
PROD/VER:WINDOWS:7.0
OPER/SYS:
KEYWORDS:kbusage

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

 - Microsoft Access Developer's Toolkit, version 7.0 
-------------------------------------------------------------------------------

Advanced: Requires expert coding, interoperability, and multiuser skills.

SUMMARY
=======

You may want to include Briefcase Replication functionality within your
Microsoft Access 7.0 run-time application. This article describes how to use the
Microsoft Access Developer's Toolkit for Windows 95 Setup Wizard to accomplish
this.

MORE INFORMATION
================

The following steps show how to specify the Briefcase Replication DLLs and the
proper Windows Registry keys using the Setup Wizard. This will enable your
application to include Briefcase Replication functionality on computers running
under Microsoft Windows 95 or Microsoft Windows NT 4.x.

To add the files needed for Briefcase Replication, do the following:

1. Start the Microsoft Access 7.0 Developer's Toolkit Setup Wizard. Click Next
   to go to the "Add the files...." dialog box.

2. Click the Add button and browse for the file, Msjrci30.dll. It should be in
   your Access folder.

3. Double-click on the file to add it to the distribution set.

4. In the Destination Folder list, select $(WinSysPath).

5. Repeat steps 2 through 4 for the file, Msjtrclr.dll.

6. Select other settings on this panel according to the needs of your
   application.

   In the "Add the Registry values" dialog box, add the following entries.

   NOTE: An underscore (_) at the end of a line is used as a line-continuation
   character. Remove the underscore from the end of the line when typing in the
   particular Registry parameter. Also, braces "{}" and parentheses "()" are
   used in the settings below.

   To add the required entries, click the add button and then type the following
   to specify the Properties of the six (6) required values:

   Top-Level for Key: HKEY_CLASSES_ROOT
   Path to Key: CLSID\{B54DCF20-5F9C-101B-AF4E-00AA003F0F07}\_
   Roles\NotifyReplica
   Value Name:
   Base Value Data on File: <Not used for any of the 6 values>
   Value Data Type: String
   Value Data: {C20D7340-5525-101B-8F15-00AA003E4672}

   Top-Level for Key: HKEY_CLASSES_ROOT
   Path to Key: CLSID\{B54DCF20-5F9C-101B-AF4E-_
   00AA003F0F07}\Roles\Reconciler
   Value Name:
   Value Data Type: String
   Value Data: {C20D7340-5525-101B-8F15-00AA003E4672}

   Top-Level for Key: HKEY_CLASSES_ROOT
   Path to Key: CLSID\{C20D7340-5525-101B-8F15-00AA003E4672}\InprocServer32
   Value Name:
   Value Data Type: String
   Value Data: $(WinSysPath)\MSJTRCLR.DLL

   Top-Level for Key: HKEY_CLASSES_ROOT
   Path to Key: CLSID\{C20D7340-5525-101B-8F15-00AA003E4672}\InprocServer32
   Value Name: ResourceDll
   Value Data Type: String
   Value Data: $(WinSysPath)\msjrci30.dll

   Top-Level for Key: HKEY_CLASSES_ROOT
   Path to Key: CLSID\{C20D7340-5525-101B-8F15-00AA003E4672}\InprocServer32
   Value Name: ThreadingModel
   Value Data Type: String
   Value Data: Apartment

   Top-Level for Key: HKEY_CLASSES_ROOT
   Path to Key: CLSID\{C20D7340-5525-101B-8F15-_
   00AA003E4672}\SingleChangeHook
   Value Name:
   Value Data Type: String
   Value Data: x <Note: This is a dummy value; any letter can be used.>

In the "...Microsoft Access components...." dialog box, follow these steps:

1. Select the Components you want to include in your application according to
   the type of setup you want.

2. Make sure the Replication Component check box is not selected.

3. Add any other necessary information for your application, and click the
   Finish button when you are finished.

NOTE: Briefcase must be set up on any computer that uses the replication features
in your custom application. Briefcase is installed only if you choose the
Portable option during Windows setup, or if you choose the Custom option, and
specify installing Briefcase.

The following articles in the Microsoft Windows Knowledge Base provide further
information on installing the Briefcase component of Microsoft Windows 95:

   Q142574 How to Install and Use Briefcase

   Q123876 Installed Components for Typical, Compact, or Portable Setup


REFERENCES
==========

The Microsoft Jet Database Replication White Paper. This can be found in
\Program Files\Common Files\Replication Manager\Msjtwtpr.doc if the Microsoft
Access 7.0 ADT has been installed.

For more information about Briefcase Replication, search for "Briefcase," and
then "Briefcase Replication," using the Microsoft Access for Windows 95 Help
Index.

Additional query words:

======================================================================
Keywords          : kbusage 
Technology        : kbAudDeveloper kbAccessSearch kbZNotKeyword3 kbAccessDevTK700
Version           : WINDOWS:7.0
Hardware          : x86
Issue type        : kbhowto

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

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 1999.