Automatic Directory Exchange ver 2.0 
Readme.txt ver 1.1 - Last revised 5/10/94
     
     
Table of Contents:
     
          Topic                      Line Number      Page Number (66 lines)
     
--New features . . . . . . . . . . . . . 30                   1 
--Title propagation, and 
    associated directory entries . . . . 45                   1
--~ADE_Mailbox as a 'p' 'l' or 'r' 
    directory entry. . . . . . . . . . . 60                   1
--Call list administration . . . . . . . 69                   2 
--Upgrading. . . . . . . . . . . . . . . 88                   2 
--Programs comprising ADE 2.0. . . . . . 92                   2 
--Directory synchronization 
    to a post office with 'R' users. . . 100                  2
--'#' files in database directory. . . . 130                  2
--Send B flag with regard to 
    backward compatibility . . . . . . . 142                  3
--'r' and 'l' users on bboard 
    prop lists . . . . . . . . . . . . . 159                  3
--Additional information (sources) . . . 169                  3
     
     
     
NEW FEATURES:
     
        *Indirect propagation
        *Directory synchronization
        *Deferred processing of ADE messages (sending and receiving) 
        *Bboard message deletion propagation
        *Bboard and Mail list title propagation 
        *Bboard message repropagation
        *Ability to depict 'l' (Local (L) at another post office) 
              vs. 'r' user (Remote (R) at another post office)
     
Note:  Duplicate names are not supported in ADE 2.0.
     
     
     
TITLE PROPAGATION AND ASSOCIATED DIRECTORY ENTRIES.
     
Mail list titles and bboard titles do not indirectly propagate, even if 
indirect propagation (I flag) is enabled.
     
When a mailing list title or bulletin board title is added to
a non-home post office by ADE, a hidden and locked directory entry 
with the same name as the mailing list or bulletin board will be 
added to the non-home post office directory.  This directory entry 
is used by the mailing list or bulletin board as a bankshot address,
and must not be deleted.  The propagation flags for this entry should 
only be altered by someone with a compete understanding of ADE 2.0.
     
     
     
~ADE_MAILBOX AS A  'p' 'l' or 'r'  ENTRY.
     
If deferred processing is being used with the existence of the keyname 
account ~ADE_Mailbox (P,L, or R entry), it should be hidden and locked 
(set the H and L prop flags) in the directory.  This way, it will not 
propagate to appear as a 'p' 'l' or 'r' entry on other post offices.
If ~ADE_Mailbox does appear in a post office as a 'p' 'l' or 'r' entry,
router will deliver ADE updates normally, and they will not be deferred.

     
     
CALL LIST ADMINISTRATION
     
In order to enable the call list in the cc:Mail Admin program, use 
the parameter "calllist/y".  This switch need only be used once, and 
can be reverted by using the parameter "calllist/n".
     
A similar parameter exists (dirprop/y) to enable ADE on a post office.
     
Use "admin /?" for more information.
     
There are some new fields in the call list with Admin version 5.1, such 
as the ability to schedule a call as infrequently as once per month (via 
the WEEKS field, and the DATE field).  Other fields for the call list 
are made visible by using the 'TAB' key when viewing the call list.  The 
'RIGHT ARROW' key does not work to display the additional fields, as it 
does when viewing in the mail directory.
     
     
     
UPGRADING
     
     
     
PROGRAMS COMPRISING ADE 2.0
     
When upgrading from ADE 1.0 to ADE 2.0, both the ADMIN.EXE (ver 5.1) 
and ROUTER.EXE (ver 5.1) should be used.  Do not use the 5.1 admin 
program and the 4.x router program, or visa versa.
     
     
     
DIRECTORY SYNCHRONIZING FROM A SUPERIOR POST OFFICE TO A SUBORDINATE 
POST OFFICE WITH 'R' (note capital case) USERS.
     
Mobile (capital 'R') users on Subordinate post offices will become local 
(capital 'L') users after a directory sync with the Superior post office.
     
This is because previous versions of Admin and ADE treated all non-local 
users (either 'R' or 'L') as remote ('r') users.  The new versions of 
Admin and ADE do distinguish between non-local Mobile ('r') and non-local 
Local ('l') users, with the default for existing 'r' directory entries 
being 'l'.
     
This can be avoided with the following upgrade procedure:
     
Using the 5.1 version of cc:Mail Import/Export, export the Subordinate 
post office to get only the "local remote" (R) users:
     
    export /nponame /ppopass /dpopath @export.fil /directory/lr
     
Then, import the resulting file into the Superior post office:
     
    import /nponame /ppopass /dpopath @export.fil /directory/prop
     
This will convert the Mobile users that are listed as 'l' users in the 
Superior post office to the 'r' type instead, and directory synchronization 
from the superior post office to the subordinate post office will not 
result in 'R' users becoming 'L' users on the Subordinate post office.
     
     
     
'#' FILES IN DATABASE DIRECTORY
     
Router 5.1 now maintains files in the database directory that are related 
to the bboards in the post office.  The names of these binary files 
likely resemble the bboard title they represent, and they are used for 
bboard synchronization as well as the propagation of deleted bboard 
messages.  These files should not be deleted.  If they are deleted, 
Router will recreate the files, but all pending propagations of deleted 
messages will not be sent, and a bboard synch may be necessary. 
     
     
     
SEND B FLAG, WITH REGARD TO BACKWARD COMPATIBILITY
     
In order for deleted bboard messages to propagate, or for a post 
office to send a bboard synchronization message, the send B propagation 
flag must be enabled.  This is for backward compatibility with ADE 1.0.  
Although the send B propagation flag is enabled to propagate bboard TITLES 
to another post office, and a message deletion is related to messages, 
this flag is required anyway, to prevent the message deletion from being 
sent to an ADE 1.0 site unexpectedly.  Bboard propagation will operate as 
it did with ADE 1.0 in relation to the bboard propagation list.  Bboard 
messages will prop to the prop list as always, and if a bboard message 
deletion will propagate (or a bboard synch will be sent), the message will 
be sent to those entries on the prop list of the bboard, If the 'send B' 
flag is enabled for that post office in the directory. 
     
     
     
'r' and 'l' USERS ON BBOARD PROP LISTS
     
Previously, the existence of 'r' (or 'l') users on the propagation list of 
a bboard was allowed, but had no function.  Router 5.1 now honors this,
and such 'r' or 'l' users will begin receiving propagated bboard messages.  
This provides the ability to propagate bboard messages to users of foreign 
e-mail systems.
     
     
     
ADDITIONAL INFORMATION
     
Technotes will be written for ADE, Version 2.0, as cc:Mail Support Services 
encounters recurring questions.  They will be made available from sources 
such as cc:Mail's BBS system (415-691-0401) and the cc:Mail Support Facts 
system (fax-back), at (415-966-4951).

