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



The information in this article applies to:

  • Microsoft Metadirectory Services 2.2
  • Microsoft Metadirectory Services 2.2 SP1

This article was previously published under Q300557

SYMPTOMS

If you use the Lotus Notes management agent to import Lotus Notes users into Microsoft Metadirectory Services (MMS), the discovery of the Notes FullName attribute may discover only one value. Only one value may appear in the import file.

CAUSE

This is the current behavior of the Cdir_ln.exe tool that discovers Notes. This tool discovers only one value for the FullName attribute.

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

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed at the beginning of this article.

MORE INFORMATION

For additional information, click the article number below to view the article in the Microsoft Knowledge Base:

320718 Microsoft Metadirectory Services 2.2 Post SP1 Hotfix List


Modification Type:MinorLast Reviewed:10/12/2005
Keywords:kbHotfixServer kbQFE kbbug kbfix kbQFE KB300557