The purpose of this program is to search through aGroupWise users's personal address books looking for aspecified search string. It will replace thatstring with another one. For example, if there areaddresses of the form @domain1.com, it can replacethose with addresses of the form @domain2.com.It can search through almost all of the availablefields.
This program was written when we removed an Exchangeconnector from our GroupWise system. All the Exchangeaddresses in the personal address books hadthe form ofusername.ExternalPostOffice.ExternalDomain. Obviously,this would have created problems trying to send tothese Exchange users without theconnector. To solve this, this program was writtenthat searched all personal address books, looking forthe .ExternalPostOffice.ExternalDomain string andreplace it with a valid @thecorrectdomain.com.
In our implementation of this, the search and replacestrings were hard coded. To configure the programnow, a separate text file, gwabfix.conf must be copiedinto the same directory as the executable,gwabfix.exe. In the configuration file change theSearchAddress, ReplaceWith, and Field entries towhatever is needed. Then run the program. The usermust be logged into GroupWise for the program to work.
Also,if the address book is open at the same time as theprogram is run, the user willneed to refresh the address book before the changeswill be seen. For this reason, it is recommended torun the program with the address book closed. Stepby step instructions on its use are included in thereadme.txt file as well.
There are two main differences between this versionand previous versions of the program. First, previousversions could only search through email addresses. This version allows a search and replace to be done onalmost all of the fields in the personal addressbooks. Second, configuration parameters were addedthat allow a user to change things such as thelocation of the log file, whether a log file should begenerated, the visibility of the user interface, andwhether all of the frequent contacts should be deleted.