Welcome to the Generic Conduit Manager

  • To everyone who is taking this:

  • Contents


    Installing the Conduit Manager

    1. Extract all the files from the .zip into a work directory.
    2. Start the program CondMgr.exe
    3. GCM13: Select the first menu item Install/InstallConduitManager. GCM20: This step is not required.
    4. Add any of
    5. You must restart the HotSync program to force it to reload its configuration data

    What the install does

    1. Adds a few simple entries to the Win95 Registry:

    It does not modifiy any existing entry. To manually remove the GCM, simply delete the above two keys.

    2. Copies the GenCond.dll/GenCn20.dll file from the work directory to your Pilot directory.


    Using the Conduit Manager

    During your next HotSync, the GCM will automatically engage, and update your PC with the data from the Pilot.

    If you wish more control over the operation of the conduit, you can control the direction of data flow by selecting options from the HotSync field on the GCM application.

    You may

    Note: If you wish to disable the conduit, there is also a checkbox at the bottom of the GCM screen which causes this conduit to be 'skipped' during a HotSync.

    Backups

    The GCM keeps several backup copies of your sync data. You can control the number of backup files through an entry on the GCM screen.

    Backups are numbered, like the old VAX system. For instance, if you were working on the DinkyPad conduit, the main data file is

    and the backups are

    This allows you to keep quite a long, ordered history of your data.


    Testing the Generic Conduit System

    On the next HotSync, have a look at the file HotSync.log.

    HotSync1.0/GCM13: If everything is working properly, you should see:

    HotSync started 11/26/96 09:05:33
    Port speed is 57600 bps
    OK Address Book
    OK Date Book
    OK Memo Pad
    OK DinkyView
    OK PilotMoney
    OK To Do List
    OK Backup

    The first three will almost certainly be there. If the ToDo list entry appears, then the GCM is working properly. In between the MemoPad and ToDo entries, there is a list of generic conduit activity. In this example, I have the DinkyView and PilotMoney conduits working properly.

    HotSync1.1/GCM20: If everything is working properly, you should see:

    HotSync started 11/26/96 09:05:33
    Port speed is 57600 bps
    OK Address Book
    OK Date Book
    OK To Do List
    OK Memo Pad
    OK DinkyView
    OK PilotMoney
    OK Backup

    The first four will almost certainly be there. If any of the conduits that you installed appear, then the GCM is working properly. In between the MemoPad and Backup entries, there is a list of generic conduit activity. In this example, I have the DinkyView and PilotMoney conduits working properly.

    Both: If you see a line such as:

    database not found on Pilot

    then the application that the conduit expects is either not installed on the Pilot, or has no data.

    If you have any doubt about the operation of the GCM, simply run the CondMgr.exe application, and select Remove/RemoveCM from the menu.


    Adding your own conduits

    To add a conduit for any Pilot app, select Insert/InsertNewConduit from the menu.

    Fields

    Conduit Name
    This name appears in the selection list box on the left
    Module Name
    is not used
    Full Module Path
    is not used
    Data File Name
    is the name of the data file on the PC
    Data Directory
    is the directory for the above file. If you use a simple string, like "abc", then this directory will be below your user-name. For example, on my machine, the example data file will be d:\Pilot\BeirneP\cBasView\cbasvw.dat
    If you use a name that looks like a full path, such as "d:\users\database\cbasVw", you can specify exactly were the file will go.
    Number of Backups
    Every time the GCM writes data to the PC, it makes a backup of the previous data. You can select how many backups to keep.
    Creator Key
    This is the 4 character key that must match up with the creator key on the Pilot. See the Stinger web site for a list of creator keys. This is case sensitive
    Pilot DB Name
    This is the data base name that must match up with the database name on the Pilot. See the Stinger web site for a list of database names.
    Sync Dir
    This controls the direction for default HotSync data flow.
    Next Sync Dir
    This controls the direction for the next HotSync only. After a successful HotSync, this field is cleared, and the default SyncDir is used.
    Notify App Service
    The GCM notifies all the applications on the PC when a HotSync occurs. It uses the Windows DDE protocol. If you wish, you can insert a DDE/ServiceItem string here, and any app that uses this DDE/ServiceItem will be notified before and after the HotSync.
    Notify App Topic
    This string works as a modifier to the above string
    App Registry #
    Each generic conduit has a unique number, such as ApplicationGC0 or ApplicationGC1. Normally, these numbers are assigned automatically, but you can over-ride them manually, here. This field is usually write protected, but you can unlock that by a control-click on the label (not the text field). NOTE: in version 2.0 of the GCM, these entries are called Application0 and Application1.
    Disabled
    Simply causes this conduit to be skipped during a HotSync. Not very useful.


    Global Backup (GCM2.0 only)

    The Conduit Manager also presents you with the opportunity to backup all the applications and data in the Pilot, onto the PC. This occurs the next time you hotsync. Because there may be a lot of data involved, this may take some time (about 7minutes for a full Pilot 5000 and 15 for a 1Meg Pilot)

    You can specify the following options:

    1. copy all the applications, preferences and data from the Pilot onto the PC; make a ripcord.ini file
    2. just make the ripcord.ini file without actually moving the data; this give you a list of what's on the Pilot; if you examine all the .prc entries, you can easily determine which apps are installed
    3. copy just the applications to the PC; this builds a profile of your apps, without the data
    4. copy just the data to the PC; you might do this more often then 3. above; this allows you to pull out data that is normally not retrievable, such as zip (game) files, DOC files and Harry's HTML viewer files.

    Note: It is not certain that all apps will be reconstructed on the PC in exactly the way they were first written; the Pilot programming environment allows apps to be modified while they are running. At this point, as far as I know, all apps do reconstruct properly.

    Note: Again, no warantee or guarantee is implied through this documentation or associated with the use of this code. Please use it with caution.