Export (0) Print
Expand All

Tzmove: Stsadm operation (Windows SharePoint Services)

Office 2007

Updated: December 6, 2007

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2007-12-04

Enables an administrator to update data that is affected by a change in the start and/or end of daylight saving time (DST).

NoteNote:
The Tzmove operation was first introduced in Windows SharePoint Services 3.0 Service Pack 1.

stsadm -o tzmove

   -name <name of the history tag>

   -update {all | before}

    [-date] <YYYYMMDD>

   -clear

 

Parameter name

Value

Required?

Description

name

A valid name, such as "dst2007"

Yes

The name of the history tag that identifies the change in daylight saving time in the Timezone.xml file.

update

Either one of the following values:

  • All

  • Before

Yes

NoteNote:
Either the update parameter or the clear parameter must be specified, but not both.

All: Updates all date values that occur in the future and that are affected by the change in daylight saving time.

Before: Updates date values that occur in the future and that are affected by the change in daylight saving time that were changed before the date specified using the date parameter. This is useful when there is an update to the Timezone.xml file, but the tzmove operation is not immediately run.

date

A valid date in the form "YYYYMMDD"

No

When the update parameter has the value Before, the date parameter is required. When the update parameter is not specified or has the value All, this parameter should not be included.

clear

<none>

Yes

NoteNote:
Either the update parameter or the clear parameter must be specified, but not both.

By default, the tzmove operation will not update data more than once. The clear parameter allows the tzmove operation to be run again safely if a previous invocation of the operation was interrupted. However, if it is necessary to update data more than once (for example, when a time zone definition changes every year), the clear parameter prepares the data to updated again.

As an example, say that November 3, 2007, was defined as standard time in the Timezone.xml file. However, it has been decided that standard time will occur one week early in your country, which changes the date of standard time to October 27, 2007. After updating Timezone.xml to reflect this change, date values that occur in this time period (in this example, between the last Sunday of October and the first Sunday in November) will be incorrect by one hour. The Tzmove operation would update this data so that it is correct.

The Timezone.xml file is located in the following location, "%COMMONPROGRAMFILES%\microsoft shared\web server extensions\12\config" folder.

For more information about Tzmove, see Microsoft Knowledge Base article 939809 (http://go.microsoft.com/fwlink/?LinkId=105804&clcid=0x409).

For the following examples, the following definitions apply:

  • Future data: This data consists of items that contain date values and time values that occur in the new DST period in the year that the DST period first comes into effect and beyond.

  • Past data: This data consists of items that contain date values and time values that occur in the new DST period in the years before the DST period first comes into effect.

  1. If you previously installed an update that modified the DST period of a time zone definition, you must run the following command to update the future data items:

    stsadm –o tzmove –name <name> –update before –date YYYYMMDD

    NoteNote:
    In this command, YYYYMMDD is the date on which you installed the update that modified the time zone definition.
  2. If you did not install an update, and if you modified the Timezone.xml file, you must run the following command to update the future data items:

    stsadm –o tzmove –name <name> –update before -date YYYYMMDD

    NoteNote:
    In this command, YYYYMMDD is the date on which the Timezone.xml file was modified.
  3. If you did not install an update that modified the DST period of a time zone definition, you must run the following command to update the future data items:

    stsadm -o tzmove -name <name> -update all

    NoteNote:
    In this command, all future data is updated.
  4. If the DST period for a time zone definition is modified again after you run the command, the previous data is not restored when you rerun the command. In this case, you must run the following command before you rerun the command:

    stsadm –o tzmove –name <name> -clear

    NoteNote:
    This procedure clears the internal flags that are set by the command, and it enables data to be modified again.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft