Chat now with support
Chat with Support

Migrator for Notes to Exchange 4.16 - Program Parameters Reference Guide

About the Migrator for Notes to Exchange documentation Introduction Parameters for Admin Components Parameters for the Self-Service Desktop Migrator (SSDM)

[SSDMThrottle] section

Type: boolean

Default: 0

New in ver 4.1.5

Determines whether the SSDM will use any of the throttling features, whereby an admin can regulate end users' execution of the SSDM to avoid processing bottlenecks that might otherwise occur if too many users try to use the SSDM simultaneously. For example:

… tells the SSDM program to use the throttling features, as configured by an administrator in the SSDM Throttling Utility. (The SSDM Throttling Utility is fully documented in the Migrator for Notes to Exchange Administration Guide.) By default these features are disabled (UseThrottle=0).

If UseThrottle=1, then a value must also be specified for the WebServiceUrl parameter, also in this [SSDMThrottle] section.

Type: string

Default: [none]

New in ver 4.1.5

Specifies the URL to the web service for the SSDM throttling features, as configured by an administrator in the SSDM Throttling Utility. (The SSDM Throttling Utility is fully documented in the Migrator for Notes to Exchange Administration Guide.) For example:

A value for the WebServiceUrl parameter becomes mandatory if UseThrottle=1 (also in this [SSDMThrottle] section).

[Status] section

All of these are internal scratch parameter (see Transient “scratch” parameters).

[TimeZoneInfo] section

Exchange uses time zone identifiers that correspond with time zones found in the Windows time zone database. Depending on the client application used to create an appointment or meeting, the Notes calendar item being migrated may not contain the specific time zone code that is used by Exchange. For example, if an appointment is created using an application on an Apple device, the time zone code in the appointment will not match any of the known Windows time zones. To help the migration software identify the appropriate Windows time zone, specify a list of preferred Windows time zones in the [TimeZoneInfo] section.

To understand how the list of preferred time zones is used, the algorithm that is used to select the appropriate time zone from the Windows time zone database is described below.

2
If a unique match is not found, a list of preferred time zones (configured in the [TimeZoneInfo] section) is compared to the list of potential matches. The first successful compatible match from the list of preferred time zones is selected.

The [TimeZoneInfo] section lists your preferred time zones from the Windows Time Zone database. Each time zone is specified with its unique identifier. You can retrieve a full list of Windows time zone identifiers using the following PowerShell cmdlet:

The cmdlet returns a table of time zone DisplayName and Id values.

The Id value is used in the [TimeZoneInfo] section. The [TimeZoneInfo] collection is configured by providing the Id values of the preferred time zones. Each value in the [TimeZoneInfo] section should be prefixed with the name TimeZoneN, where N represents a counter starting at 0. Below is a sample configuration of the [TimeZoneInfo] section:

[TimeZoneNames] section

For most migrations, configuring the [TimeZoneInfo] section should be sufficient to determine the correct time zone for scheduled meetings and appointments. However, if two very similar time zones are being used, the migration may have difficulty identifying the correct time zone. Configuring the [TimeZoneNames] section can provide additional guidance.

Each Notes meeting and appointment contains a time zone description string similar to the following:

The ZN parameter of the string identifies the name of the time zone. If the appointment was scheduled from a Windows client or browser, the name corresponds to a name in the Windows time zone database and a unique time zone match is assured. If the appointment was scheduled from a mobile device or a non-Windows operating system, the time zone name will not match a Windows time zone and additional steps must be taken.

In the example shown above, scheduled from an Android device, the time zone America/New_York corresponds to the Windows time zone identifier Eastern Standard Time. You can configure the [TimeZoneNames] section to map non-Windows time zone names to their Windows equivalent. For example:

The value on the right corresponds to the identifier of the Windows time zone. See the [TimeZoneInfo] section for details on retrieving the correct time zone identifier.

Related Documents