The Lotus Notes Management Agent Discovers Only One FullName Attribute Value (300557)

RESOLUTION

A supported hotfix is now available from Microsoft, but it is only intended to correct the problem that is described in this article. Only apply it to systems that are experiencing this specific problem. This hotfix may receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next version of Microsoft Metadirectory Services that contains this hotfix.

To resolve this problem immediately, contact Microsoft Product Support Services to obtain the fix. For a complete list of Microsoft Product Support Services phone numbers and information about support costs, visit the following Microsoft Web site:NOTE: In special cases, charges that are ordinarily incurred for support calls may be canceled if a Microsoft Support Professional determines that a specific update will resolve your problem. The typical support costs will apply to additional support questions and issues that do not qualify for the specific update in question.

The English version of this fix should have the following file attributes or later:

   Date        Time    Version     Size       File name
   ------------------------------------------------------
   30-May-2001  19:31  2.2.1300.2    174,080  Cdir_ad.dll
   07-Jun-2001  17:28  2.2.1300.1  1,013,760  Cdir_ln.exe
				

To resolve this issue, you must first obtain and install this hotfix. After you install the hotfix, you must modify the Notes management agent.

To not change the default behavior of Cdir_ln.exe, you must use a command-line switch for multivalued FullName discovery. To add the switch and update the templates:

1. Click Design MA, click Control MA Operations, and then click the MA Control script.
2. Add the /fullname2 parameter to Cdir_ln in the management agent script to turn on multivalued discovery of FullName into a supplemental attribute that is named FullName2 in the import file.
   
   NOTE: You must use this parameter only during import. It must be the last parameter.
   
   Locate the following section in the management agent Control script:

   echo ******************************************************************
            echo Start of Lotus Notes Users Discovery 
            echo ******************************************************************
            EXECUTE cdir_ln /srv="%zcNotesRegSrvName%" /dn="%dn%" /export /objclass=User +
                                       /expfile=%zcDsDirectory%\import /explist="%zcNotesAttrList%" +
                                       /foreignOU="%zcNotesForeignOU%" /mainpab=%zcNotesUseMainPab% +
                                       /pab="%zcNotesPabNames%" /dom="%zcNotesDomainsNames%"
   						

   Change this section to be:

   echo ******************************************************************
            echo Start of Lotus Notes Users Discovery 
            echo ******************************************************************
            EXECUTE cdir_ln /srv="%zcNotesRegSrvName%" /dn="%dn%" /export /objclass=User +
                                       /expfile=%zcDsDirectory%\import /explist="%zcNotesAttrList%" +
                                       /foreignOU="%zcNotesForeignOU%" /mainpab=%zcNotesUseMainPab% +
                                       /pab="%zcNotesPabNames%" /dom="%zcNotesDomainsNames%" /fullname2
   						

3. Click Design MA, click Control MA Operations, and then click Template Definitions.
4. Add "c_syntax ;" to the template definitions by changing the following section:

   # others
   
           c_repeat                +
        s_substitution           " ."
           s_domain                any
           s_pab                   any
   
   
        n_failure_percentage    30
   						

   Change the section to be:

   # others
   
           c_repeat                +
        s_substitution           " ."
           s_domain                any
           s_pab                   any
           c_syntax                ;
   
   
        n_failure_percentage    30
   						

5. Click Design MA, click Control Metadirectory, click Parsing Templates, and then click Add.
6. Add the following line to the Parsing Add template immediately under the existing "FullName" line:

   +FullName2: $I_READ_ATTRIBUTE("$v_zvalue","multilines:attribute:$cd.zcTestAttribute;add")
   						

   The zcTestAttribute is set to multivalued by default and works correctly. You can use a different attribute name if you want.
   
   
7. Click Design MA, click Control Metadirectory, click Construction Templates, and then click Metaverse.
8. Add the following line at the top of the Metaverse Construction template:

   $mvp.zcTestAttribute = $cd.zcTestAttribute
   						

9. Click Design MA, click Control Connected Directory, click Output Templates, and then click Add and Modify.
10. Add the following line at the bottom of the Output template (this turns on the export of FullName changes):

    ($MULTI_VALUED("0", $mv.zcTestAttribute, "+FullName: "))