 |
Steps to Prepare Notes/Domino for the Repeal of Argentina Daylight Saving Time 2009
|
| | | Abstract | Argentina introduced the observance of daylight saving time (DST) in 2007. On October 16, 2009, the government of Argentina announced that it would not continue observing DST. This ends Argentina's observance of daylight saving time.
-- In 2007 DST started on the last Sunday in December and ended the second Saturday in March (December 30, 2007 to March 15th, 2008).
-- In 2008 DST started on the third Saturday in October and ended the second Saturday in March (October 18, 2008 to March 14, 2009).
-- For 2009 DST was scheduled to begin the third Saturday in October and end the second Saturday in March (October 17, 2009 to March 13, 2010). Effective immediately DST will no longer be observed in Argentina.
This document provides details on the steps necessary to prepare a Lotus Notes client and Lotus Domino server for the removal of daylight saving time for Argentina.
NOTE: The instructions for preparing a Domino server for the removal of DST are also necessary for Lotus software products that rely on a Domino server, for example, Lotus Enterprise Integrator (LEI) or Lotus Sametime.
If a Notes client or Domino server is not actually set to Argentine (Buenos Aires) time, you may still need to update the system. A Notes client should be updated as described in this document to reflect the repeal of DST rules if either of the following are true:
-- Users schedule Calendaring and Scheduling entries, Resource Reservation entries, or Notes date/time entries using the Argentina time zone.
-- Users set their user preferences to display a secondary time zone in the Calendaring views in which the time zone specified is the Argentina time zone.
In the above scenarios, it is also advisable to update the operating system of the Domino server and Notes client machines to reflect the repeal of DST. | | | |  | | | Content |
1. Operating system
Apply operating system patch(es) to modify the system's DST rules. It is recommended that you follow the installation guidelines provided with the patch. Some operating systems may allow you to directly modify system settings to affect changes in the DST rules. For example, the Microsoft utility, TZEdit, can be used to define DST rules. NOTE: Microsoft is not currently providing a patch for this issue; however, customers may manually patch their registry to remove the observance of DST for Argentina. Microsoft should be contacted to obtain precise guidance regarding registry-related time zone changes.
In the absence of an operating system patch, customers may set their client workstation to time zone (GMT-3) Cayenne, which is present in the latest Microsoft time zone update (August 2009). Cayenne has the same GMT offset as Argentina (GMT-3 Buenos Aires), and does not observe daylight saving time. Calendar entries created in this time zone will align with Argentina's current time zone, it is also possible that Microsoft may choose to merge Buenos Aires into SA Eastern along with Cayenne.
On workstations running time zone rules prior to the August 2009 Microsoft time zone update the time zone (GMT-3) Cayenne will not be available, instead you will see any entry labeled (GMT-3) Georgetown, which has since been moved to GMT-4. This is correct for Georgetown, Guyana. To prevent future complications, it is advisable that customers upgrade to the latest Microsoft time zone update detailed here (http://support.microsoft.com/kb/914387) if they choose to select Cayenne as their time zone, instead of updating the Argentina (Buenos Aires) time zone rules to reflect the removal of DST.
IMPORTANT: The Notes 8.x and 8.5.x standard client versions have a dependancy on ICU4J data that must be resolved before existing calendar entries will appear at the correct times in the calendar grid. See section 4 below on further details on how to resolve this for the standard client. Changes will be required whether you choose to change your time zone to Cayenne or update the operating system time zone for the Argentina to no longer observe DST.
Important Note: The Notes client or Domino server should be shut down while any operating system patch or registry change is being applied. Before restarting Notes or Domino it is important to follow the below instructions in order for Notes and Domino to work as expected. It is suggested that in cases where a patch is being installed using an automatic distribution procedure, the procedure should be designed to instruct users to exit Notes/Domino before the patch is installed. If required, the system should be rebooted after the patch is installed and then Notes/Domino can be restarted. The following undesired behaviors can occur if the above steps are not followed:
- If the Windows operating system is not restarted after the patch is installed, Notes/Domino will return the old time zone information for time zones other than the current time zone.
- IMPORTANT for Windows operating systems: These instructions expect that the system's registry has been updated (per the Microsoft recommendation) to define the Argentina daylight saving time parameters as: Third Saturday in October 11:59:59 PM and third Sunday in March 12:00:00 AM.
- There have been reported cases where the Notes time zone setting is set to an unexpected value when the patch has been installed using an automatic distribution rollout while the Notes client is running.
- Do not simply adjust the operating system clock to compensate for the introduction of daylight saving time.
After applying the operating system (OS) patch, some systems may need to be restarted. Refer to the following table based on manufacturer's recommendation:
| IBM AIX or Sun Solaris | You are required to restart the OS. | | Microsoft Windows | You are required to restart the OS. | | Red Hat Linux | It is recommended that you restart the OS. | | i5/OS | An OS restart is not required. |
2. All Notes and Domino - Java/JVM
You will want to update the reference tables that Java uses to ensure that Java code and Java applets that reference time zones function as expected. You can use the IBM Java Time Zone Update Utility (JTZU) tool to do this, when an update is released. There is not currently one available for this change. For information relating to the JTZU tool including a link to the download document, refer to Document #1249964, "Using the IBM Time Zone Update Utility for Java with Lotus software products."
NOTE: The JTZU tool is not applicable for System i. Therefore, i5/OS and OS/400 users must update their SDKs and JREs using PTFs when they become available.
3. Additional requirements and steps specific to operating systems
Note that in Notes/Domino 6.0 and later, the notes.ini parameter, DSTLaw, cannot be used to control the DST rules that Notes/Domino obeys (with the exception of Domino for i5/OS). In these releases, the DST rule functionality works in conjunction with the operating system DST rule settings, and the DSTLaw parameter is reset to the current operating system rules when Domino is started.
Microsoft Windows
On Windows operating systems, be sure that the parameter "UseNotesTimeZone=1" is either removed from the notes.ini file or modified so that it is set to "0" (zero). For details on setting up custom fields in a Desktop Policy, refer to Document #1196837, "Using a Desktop Policy to set notes.ini and Location parameters" .
IBM i5/OS
Domino running on IBM i5/OS (System i) must use the DSTLaw and DST notes.ini parameters in order to properly control the observance of DST. The following parameter should be present in the notes.ini for the Domino server:
DST=0
DSTLaw= 0, 0, 0, 0, 0, 0
This requirement may change in later Notes/Domino releases. It is still suggested that you apply any available i5/OS operating system updates for the revised DST rule changes to ensure that the operating systems and other applications function as expected.
Mac client and non-Windows servers
The Notes Mac client in releases prior to 7.0.3 relies on an internal table for time zone DST rules. Additional functionality was introduced in Notes 6.5.6 and 7.0.2 that allows you to use a supplied text file (Timezones.txt) to add or customize time zone DST rules. The functionality is also available for Notes 6.5.x releases that were updated with the hotfix for SPR# MCMA6JNVG6. Hotfixes are available for download by referring to Document #4014840, "DST 2007 hotfixes for Lotus Notes client on Macintosh" . Once you modify the Timezones.txt as noted below, you must add the following value to the preferences file: TimeZoneTable=Timezones.txt
Non-Windows Domino releases rely on an internal table for time zone DST rules. Additional functionality was introduced in Domino releases 6.5.5 Fix Pack 3 (FP3), 7.0.3 and 8.0 that allows you to use a text file (Timezones.txt) to add or customize time zone DST rules. Once you modify the Timezones.txt as noted below, you must add the following entry to the notes.ini file of the Domino server (the server should be shut down for this modification): TimeZoneTable=<path>Timezones.txt
How to implement the revisions for the DST revisions:
1. Create a file called Timezones.txt file if you are not already currently using one. NOTE: It may be possible that a system is already using a Timezones.txt to deal with other DST revisions. In this case, it is important that you modify the file in use rather than overwrite it.
2. Edit the Timezones.txt file using a text editor.
3. At the end of the file add an additional entry (or edit if already present):
"Argentina", 0, 0, 3, N, 0, 0, 0, 0, 0, 0, 0"
4. All Notes clients
Starting with the Notes 8 Standard Client, the calendar grid relies on a time zone set maintained inside of the Expeditor/Eclipse framework called ICU4J. After you perform corrective actions against the operating system running the Notes client new entries in the calendar grid will show one hour off. Entries corrected by the DST agents will also be displayed one hour off in the calendar grid. Currently there is no way to update this rule set independently of an maintenance release or hotfix; however, you can alter its behavior by editing the tzmappings file, which ships with the JVM. To do this, follow the steps below:
1. Locate the tzmappings file associated with the Expeditor/Eclipse framework. In all releases prior to 8.5.1, you must search for the tzmappings file as its location will vary based on the release, Fix Pack, Cumulative Client Hotfix (CCH), or hotfix that you may be running. To do this:
a. Open a command line prompt and change (cd) to the <notes program>\framework directory on a client workstation.
b. Enter the command dir /s tzmappings <enter>. This will search for the tzmappings files in all subdirectories of the framework folder. For example, on 8.5 gold you would see the following returned:
C:\Program Files\IBM\Lotus\Notes\framework>dir /s tzmappings
Volume in drive C has no label.
Volume Serial Number is 6806-ABBD
Directory of C:\Program Files\IBM\Lotus\Notes\framework\rcp\eclipse\plugins\com.ibm.rcp.j2se.win32.x86_1.6.0.20081029a-200811140851\jre\lib
11/14/2008 01:24 PM 7,570 tzmappings
1 File(s) 7,570 bytes
NOTE: If you are making this change to an 8.5.1 client the tzmappings file will be located under <notes program directory>\jvm\lib. In previous releases this refers to only the core JVM, which is used to run agents and perform other non-Eclipse Java related tasks.
c. Make a backup copy of the file before proceeding, just in case you need to restore it to its gold configuration later when ICU4J updates are installed that reflect the most current time zone changes for Argentina.
2. Open the tzmappings file in Wordpad. If you chose to change your workstation's time zone to Cayenne, find the following entries in the tzmappings file:
SA Eastern:42,43:GY:America/Guyana:
SA Eastern Standard Time:42,43:GY:America/Guyana:
Change them to the following
SA Eastern:42,43:GY:America/Cayenne:
SA Eastern Standard Time:42,43:GY:America/Cayenne
If you have elected to patch your client's operating system's time zone rules, so that the Argentina time zone no longer observes DST, find the following entry in the tzmappings file:
Argentina Standard Time:913,913::America/Buenos_Aires
Change the entry to:
Argentina Standard Time:913,913::America/Cayenne
By doing this you are telling the JVM and the ICU4J framework that when your workstation is set to (GMT-3) Cayenne or (GMT-3) Buenos Aires, that they should use the time zone rules for Cayenne, which is located in GMT-3 and does not observe DST.
3. Save and close the file.
NOTE: Although the time zone rules maintained by the JVM and ICU4J are mutually exclusive, ICU4J determines what time zone it is in by asking the JVM. The tzmappings file tells the JVM what strings on the operating system map to what Java time zone IDs. So making this change will affect both ICU4J and the JVM.
Updating the tzmappings file and ICU4J data is under investigation for a future Fix Pack.
After adjusting the operating system and configuring Notes, it may be necessary for users to reset the time zone setting within their calendar preferences. The setting is accessed through the action button Tools --> Preferences --> Calendar & To Do (tab) --> Scheduling (tab) --> Time Zone (keyword).
NOTE: If the entry reflects "Local Time", it does not need to be reset.
If you set an optional secondary time zone display for your Calendar views, then this must be re-selected once the operating system and Notes have been updated. The menu selection is File --> Preferences --> User Preferences --> International --> Calendar --> Time Zone.
NOTE: In most cases, the user's Location document setting "Use operating system's time zone settings" will work as expected whether set to "Yes" or "No". If the value is set to "No" and you experience behavior where the time zone setting reverts to an unexpected value, then check the time zone setting in all of your Location documents to ensure the expected value is populated for all of them.
5. Domino Web Access & iNotes clients
It is recommended that the updates described below be performed as closely as possible to the time when the host client has its operating system updated to the new DST time zone rules.
FormsX.nsf must be updated as follows:
NOTE: The following steps are only applicable to Domino releases 6.5.5, 7.0.1, and later.
a. Open the form Custom_JS.
b. Locate the function API_TimeZones(a_Table).
c. Prior to the line "return (a_Table);" add, or edit if present, the following entry as listed below if you have updated the OS time zone rules for Argentina not to observe DST (do not add carriage return):
a_Table[a_Table.length] = ["Argentina", "Argentina", "(GMT-03:00) Buenos Aires", 3, false, "0, 0, 0, 0, 0, 0"]
d. Restart the HTTP task on the server using the console command: tell http restart.
 Back to top
Systems updated to new daylight saving time rules
Any calendar entry that falls within the daylight saving time (DST) period created before the application of the DST rules (by the necessary operating system or related Notes/Domino hotfixes) will appear an hour later than originally scheduled.
Note: An additional issue exists specific to Notes 8 (Standard Configuration) with a mail8.ntf design. You may observe that calendar entries appear off by an hour. This may happen with all of the Notes/Domino 8.x mail design's calendar views. For additional details, refer to the following document: "Calendar entries appear off by an hour when using Notes 8 (Standard Configuration)" (# 1286434)
Actions to take
First, update your Notes client and Domino servers as noted above to apply the changed DST rules. The sooner this is accomplished, the fewer entries will need to be updated after the operating system DST patch is in place.
Once the systems have been updated, you will want to reschedule the affected calendar entries. Entries can either be manually rescheduled, or rescheduled using agents IBM provides.
How to manually reschedule Calendaring and Scheduling or Resource Reservation entries
It is possible to highlight an entry and reschedule it manually using the action button Owner Actions --> Reschedule.
Agents to assist with making updates to Calendar entries and Resource Reservations
IBM Lotus has prepared a set of LotusScript agents that will update any existing Notes calendar entries and Resource Reservation entries to conform to the repeal of DST rules for 2009. These agents provide an IT organization flexibility on how to roll out these updates. They will work on Notes 6.x and above template-based databases by default, with optional support for documents created using a Notes 5.x template.
The following document contains the agents, operating instructions, and specific details on the functionality. "Agents for updating Calendaring and Scheduling entries and Resource Reservation entries for the Repeal of Argentina Daylight Saving Time (DST) 2009" (# 1316462)
NOTE: The following document describes issues that are applicable to revised daylight saving time rules but the date references and steps to follow relate to US/Canada. The document may still be helpful in understanding related calendaring issues in greater detail than can be found elsewhere.
-- Document #1232652 - "Effects of 2007 Daylight Saving Time (DST) changes on Lotus Notes Calendaring and Scheduling functionality and Resource Reservation functionality"
 Back to top
NOTE: The following issues will not occur on Domino server releases 7.0.3 or 8.0 which have been set to use the Timezones.txt file (as instructed above) to revise the relevant time zone table entries.
Domino - All Platforms
1. A Domino-generated cookie based on $Preferences has old time zone and DST rules.
The Domino $Preferences Web page that creates a Domino-generated cookie does not have the current time zone tables for revised DST rules. This page is used in custom Web applications that parse the cookie. It is also used by Lotus QuickPlace if users choose the option to display times in a different time zone from the server. For additional information, refer to Document #1256236, "$Preferences does not contain DST2007 choices in QuickPlace" .
This issue is corrected for Domino on Windows platforms in Domino 7.0.3 Fix Pack 1 (FP1) and Domino 6.5.6 Fix Pack 3 (FP3) based on SPR# MKIN79ERSB. The fix makes Domino servers running on Windows dependent on the operating system for this detail.
Fix details: SPR# MKIN79ERSB
Background: Domino HTTP servers allow you to access a URL that will generate and store a cookie on user browsers with regional and time zone settings. This cookie can then be leveraged in Web applications or JavaScript in order to display or act on data according to time zone/regional settings stored in the cookie.
Domino - Non-Windows Platforms
2. @GetCurrentTimezone returns old DST rules
When the @GetCurrentTimezone @function is executed using a background agent, or in a Web application on a non-Windows server, or from a Linux client locally, the function will return the old DST rules. Execution by a Windows client when the database simply resides on a non-Windows server is not impacted.
3. Outbound iCal entries might have start and end times that are an hour too early.
The SMTP server that does the MIME conversion will reference the internal time zone table with old DST rules which sets the start and end times of the meeting so it is an hour too early for the shifted DST weeks. The issue does not occur if the MIME conversion was handled by a Windows client or server.
4. Calendar entries accessed using POP/IMAP will appear an hour too early. The same issue that affects the MIME conversion also affects the POP3/IMAP tasks.
5. Calendar entries created using WebMail will appear an hour too early.
The WebMail functionality relies on the @Function @GetCurrentTimeZone to populate a number of fields. As noted above in point #1, this function relies on an internal table and thus functionality based on it will return values that appear an hour earlier than expected.
Below are the places in which the @GetCurrentTimeZone function is used in the WebMail design:
- View: "($Calendar)" - In Script
- Form: "(Notice)" - In the field: LocalTimeZone
- Form: "_Calendar Entry" - In the fields: LocalTimeZone, tmpShowTZ, StartTimeZone, EndTimeZone
- Subform: "(CSMeetingInterval)" - In the fields: StartTimeZone, EndTimeZone
- Script Library: CSUIViewClass
- Agent: "(MailPolicy)"
Notes Client - Non-Windows
6. Linux 7.0.1 client.
The Linux client relies on an internal time zone table for DST rules. This means that C&S entries that fall within the shifted weeks of DST will appear an hour later than expected on non-Linux clients. These entries are correctable by the DST fix agents but the resulting entry will appear an hour too early to Linux clients and correct for non-Linux clients. Other date/time values will also be off by an hour, stored with the incorrect DST rules. For example, converting to MIME from a Linux client is also expected to be affected. There are no current plans to provide a Fix Pack to revise the table for the 7.0.1 Linux client. As a workaround, use the Notes 8.0 Linux client (when available).
 Back to top
- Date/Time fields in custom applications can be affected by the revised DST rules. The agents that IBM/Lotus has provided to assist in the revision of Date/Time values in mail databases (Calendaring and Scheduling entries) and in Resource Reservation databases are specific to those applications and document types. The agents do not affect Date/Time values that may be affected in custom applications. For additional detail on this subject as well as a sample LotusScript agent that can be used as a starting point for a solution to revise affected Date/Time fields, refer to Document #1249177, "Daylight Saving Time (DST) 2007 effects on Date/Time fields in Lotus Notes and Domino" .
- Scheduled agents and tasks execute an hour later than expected on the first day of Daylight Saving Time (DST), Document #1256479 .
- Meeting times are off by one hour in Two Day and One Work Week views during the first weekend/week of Daylight Saving Time, Document #1167716
| |  Back to top | | | | | | | | Cross Reference information | | Segment | Product | Component | Platform | Version | Edition | | Messaging Applications | Lotus Domino | Lotus Domino Designer | Windows | 8.0, 7.0, 6.5, 6.0 | All Editions | | Messaging Applications | Lotus Domino Web Access | Calendar | Linux, Mac OS X, Windows | 8.0, 7.0, 6.5, 6.0 | All Editions | | Messaging Applications | Lotus iNotes | Calendar | Linux, Mac OS X, Windows | 8.5 | |
| | |
|
|
| IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml. |
|
|
|
|
| Please take a moment to complete this form to help us better serve you. |
|
 |
|
|
|
|
|
|
| Product categories: |
|
| | Software | |
| | Messaging Applications | |
| | Advanced Messaging | |
| | Lotus iNotes | |
| | Calendar | |
|
| Operating system(s): |
| |
Linux, Mac OS, Windows
|
|
| Software version: |
| |
6.5, 7.0, 8.0, 8.5
|
|
| Software edition: |
| |
All Editions
|
|
| Reference #: |
| |
1316451
|
|
| IBM Group: |
| | Software Group |
|
| Modified date: |
| | 2009-10-18 |
|
|
