ADT95: Including Briefcase Replication in a Custom Application

Last reviewed: May 14, 1997
Article ID: Q160892
The information in this article applies to:
  • Microsoft Access Developer's Toolkit version 7.0

SUMMARY

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

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-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:

   ARTICLE-ID: Q142574
   TITLE     : How to Install and Use Briefcase

   ARTICLE-ID: Q123876
   TITLE     : 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.


Keywords : kbusage WzHowto
Version : 7.0
Platform : WINDOWS
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.

Last reviewed: May 14, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.