Microsoft KB Archive/222506

= XFOR: GroupWise Connector Directory Synchronization Overview =

Article ID: 222506

Article Last Modified on 10/28/2006

-

APPLIES TO


 * Microsoft Exchange Server 5.5 Standard Edition

-



This article was previously published under Q222506



SUMMARY
The Microsoft Exchange Connector for Novell GroupWise uses the Novell GroupWise API Gateway to request directory information from GroupWise, and also to import directory information back to GroupWise.



MORE INFORMATION
When the GroupWise Connector is requested to do a Full Load (Exchange Server to GroupWise directory synchronization) through the Exchange Administrator program, the following takes place:   The GroupWise Connector places a request in the form of an .api file in the Novell GroupWise API Gateway's API_IN directory to request a list of all Exchange Server users. The following is an example of the API file.

WPC-API= 1.2; Msg-Type= Admin; DS-User= Domain= EXCHANGE; Post-Office= US; Operation= List; Visibility= System; Gw-Alias=; ; -END-   The GroupWise Connector will process the response from the API Gateway through the API_OUT directory. The Connector will then compare the list of users currently in the Exchange directory to the response from GroupWise to determine how many directory synchronization transactions to send to GroupWise. Here's a sample of the response .api file from GroupWise. WPC-API= 1.2; Header-Char= T50; Msg-Type= ADMIN;
 * 1) The query information was:
 * 2)            Type = DS-User
 * 3)          Domain = EXCHANGE
 * 4)     Post Office = US

DS-User= Operation= List; Domain= Exchange; Post-Office= US; Object= Administrator; Visibility= System; Description= Administrator; First-Name= Administrator; Gw-Alias= Type= exchange; External-Name= Administrator@EXCHANGE; ; -END-   The GroupWise Connector then places a request in the Novell GroupWise API Gateway's API_IN directory to add, modify, or delete users to maintain synchronization. The GroupWise Connector actually places two .api files into the API Gateway. The first file is to add the post office for the Exchange Server users in GroupWise to ensure that the post office exists before adding users. The second file contains the additions, modifications, and deletions of user accounts. The following is a sample .api file for adding the post office, followed by the second .api file for adding users. WPC-API= 1.2; Msg-Type= Admin; DS-External-Post-Office= Operation= Add; Domain= EXCHANGE; Post-Office= US; Time-Zone= gmt; ; -END- WPC-API= 1.2; Msg-Type= Admin; DS-User= Operation= Modify; Visibility= System; Domain= Exchange; Post-Office= US; Object= Administrator; Last-Name= \\; First-Name= Administrator; Description= Administrator; Account-ID= \\; Title= \\; Department= \\; Phone= \\; Fax= \\; Network-ID= \\; Gw-Alias= Type= exchange; External-Name= Administrator@EXCHANGE; ; ; -END- 

When the GroupWise Connector is requested to do a Full Load (GroupWise to Exchange Server directory synchronization) through the Exchange Administrator program, the following takes place:   The GroupWise Connector places a request in the form of an .api file in the Novell GroupWise API Gateway's API_IN directory to request a list of all users in the GroupWise directory. The following is a sample of this .api file. <pre class="fixed_text">WPC-API= 1.2; Msg-Type= Admin; -GET-DIRECTORY- -END- </li>  The GroupWise Connector will process the response from the API Gateway through the API_OUT directory. The Connector will then make appropriate changes to the GroupWise custom recipients in Exchange Server. Here's a sample response .api file from GroupWise. <pre class="fixed_text">WPC-API= 1.2; Header-Char= T50; Msg-Type= ADMIN; DS-User= Operation= List; Domain= Exchange; Post-Office= US; Object= Administrator; Visibility= System; Description= Administrator; First-Name= Administrator; Gw-Alias= Type= exchange; External-Name= Administrator@BRIANCL001; ; DS-User= Operation= List; Domain= GWDOMAIN; Post-Office= GWPO; Object= GWUser1; Visibility= System; Last-Name= User1; Network-ID= GWUser.ORG; First-Name= GW; DS-User= Operation= List; Domain= GWDOMAIN; Post-Office= GWPO; Object= GWUser2; Visibility= System; Last-Name= User2; First-Name= GW; Network-ID= NewUser.ORG; -END- </li></ol>

For additional information on the Novell GroupWise API Gateway, visit the following Novell Web site:

http://developer.novell.com/ndk/gwsdk.htm

Keywords: kbinfo KB222506

-

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

© Microsoft Corporation. All rights reserved.