Manually configure and run Msextmz.exe

Configure the Msextmz.ini file

The Msextmz.ini file must be configured correctly for Msextmz.exe to run correctly. We recommend that you read the comments in the Msextmz.ini file carefully before you modify the Msextmz.ini file.

Specify the Msextmz.exe execution mode

Msextmz.exe runs in two modes. To specify the mode of execution, specific parameters have to be set in the Msextmz.ini file. The following list describes the three modes and describes how to configure the modes in the Msextmz.ini file.

•

Time Zone Extraction In this mode, Msextmz.exe extracts time zone information from each mailbox by reading a set of MAPI properties. Msextmz.exe can examine recurring appointments that are organized by the user in the user’s calendar and then try to determine a time zone for the user. However, this option is resource-intensive. By default, therefore, this option is not enabled. To enable this option, set the ReadCalendarTimezones parameter in the Msextmz.ini file. Msextmz.exe records the time zone information for each user in an output file that contains a list of mailbox legacy DNs. Each mailbox legacy DN has the following types of time zone values: • Outlook Web Access Time Zone • CDO Time Zone • Outlook Time Zone • Recurring Meeting Time Zone The format of the file uses the following format: User_DN<\TAB >CDO_Time_Zone<\TAB>Outlook Web Access_Time_Zone<\TAB>Outlook_Time_Zone<\TAB >Recurring_Meeting_Time_Zone<\CRLF> If Msextmz.exe cannot extract time zone information for any of the four types of time zones, the mailbox legacy DN will be logged in the error file. To map the user to only one time zone, you must import the output file to Microsoft Excel. In Excel, filter the list of users according to one of the time zones. The time zone that you use depends on your environment. For example, if most users use BlackBerry devices, Exchange 5.5 Outlook Web Access, or other CDO-based solutions, filter the list by CDO Time Zone. If most users use Exchange Outlook Web Access, filter the list by Outlook Web Access Time Zone. If most users do not fit into one of these scenarios, filter the list by Recurring Meeting Time Zone. To run the tool in Time Zone Extraction mode, configure the .ini file as follows: • Leave the CommandLine parameter uncommented. • Set the OutputFile parameter. • Set the ErrorFile parameter. • Set the ServerDN parameter. • Set the Profile parameter. • Set the LogFile parameter. • Set the ExportTimezones parameter to 1. • Comment out the rest of the parameters in the .ini file.

•

Update In this mode, Msextmz.exe will update all mailboxes that are specified in an input file. The input file should be in the following format: User_DN<\TAB>Server_Friendly_Name<\TAB>OS_Time Zone_Registry_Key<\CRLF> Only one instance of Msextmz.exe can run on one client. However, Msextmz.exe can be run on multiple clients at the same time. To run Msextmz.exe in this mode, you must configure the Msextmz.ini file as follows: • Make sure that the CommandLine parameter is uncommented and points to the correct location of Tzmove.exe. • Set the InputFile parameter. • Comment out the OutputFile parameter. • Set the ErrorFile parameter. • Set the ServerDN parameter. • Set the LogFile parameter. • Set the LogDirectory parameter. • Comment out the ExportTimezones parameter. • Uncomment remaining parameters. In Update mode, Msextmz.exe can accept an input file that contains users on different Exchange servers. The .ini setting requires that you provide the DN of an Exchange server. In this case, you only have to specify a server DN of an Exchange server in the Exchange organization. To update recurring appointments only, configure the CommandLine parameter with the following value: tzmove.exe /q /onlyrecurring To update both recurring and single-instance appointments, use the default CommandLine value.