Microsoft KB Archive/294699

= Use of the $Disconnect_Specific Function in MMS =

Article ID: 294699

Article Last Modified on 6/17/2005

-

APPLIES TO


 * Microsoft Metadirectory Services 2.2 Service Pack 1

-



This article was previously published under Q294699



SUMMARY
When Microsoft released Microsoft Metadirectory Services (MMS) Service Pack 1 (SP1), a new $Disconnect_Specific template function was included. You can use this function to disconnect a connector space object that resides under a specific management agent (MA). This article describes this new function, and explains how it can be used to disconnect a connected object by using an MA.



MORE INFORMATION
Prior to MMS SP1, the $Disconnect function could also be used to disconnect a connector space object. The operation and use of this function is unchanged. However, the $Disconnect function does not have the flexibility of selecting a particular MA under which the connector is to be disconnected. It was limited to deleting either connectors under all MAs or under all MAs except the MA that was currently running. The ability to selectively affect just one particular MA's connector space for the deletion did not exist.

The $Disconnect_Specific function allows more detail in the selection of which connector space objects are deleted because you can select one particular MA's connector space.

The function takes as its argument the full or partial distinguished name that identifies the Connector Space object(s) to be deleted. The function then performs a comparison of the argument and the zcConnectedDirectoryID attribute of a metaverse object. Any matching value is removed, which results in the disconnection of the corresponding connector space entry.

For example, if an employee leaves the organization, one MA may use an attribute from a connected directory to set an attribute of the employee object to a particular value. This value might reflect the status of the employee, for example, &quot;Inactive&quot; or &quot;Terminated&quot;. In this case, the value of the attribute can later be used to determine whether the employee's connector(s) should be disconnected.

Syntax
$Disconnect_Specific($MA)

For example, this function could be used in the Advanced Attribute Flow Script of the MA where the employee is to be disconnected: if $mv.status = INACTIVE

then

$DISCONNECT_SPECIFIC($MA)

endif The preceding example assumes that an attribute called &quot;status&quot; exists in the metaverse and in the connected directory that is authoritative for that attribute. It also assumes that the value has been set to &quot;INACTIVE&quot; in that connected directory.

Alternatively, you can specify a specific DN of an MA and use this function on the MA where the status change originates. By using this method, you can specifically designate the DN of the MA where the user will be disconnected. However, if you want to globally disconnect all connected objects from every MA, use the $Disconnect function. For more information about this function, see the &quot;MMS Management Agent Toolkit Manual toolkit, Appendix D - Management Agent Functions&quot; on-line manual.

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements.

Additional query words: zoomit

Keywords: kbinfo kbenv KB294699

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.