Click here to jump to Nash!Com Solutions Homepage - Click here to request a test version.

Daylight Savings Fixup

Nash!Com Solutions

Version: 1.0
Shortname: nshdst
Category: Command-Line Tool

Short Description

Nash!Com Dayligh Savings Fixup a command line tool for correcting documents stored with disabled daylight savings at summer time.
This program can be used on clients or servers (server console).

Key Features

- correct timedates
- timedate ranges and timedate lists
- report problems without fixing them
- optional also work on profile documents

Screen Print

* |  NshDst 1.0 - Notes DST Fixup Tool
|\|  (c)2000-2001 NashCom - Daniel Nashed Communication Systems
| * -

Syntax:  nshdst <database> [-f<filename>]

Database Selection Options:

 -r             : process directories recursively
 -s<servername> : server name

Output Options:

 -o<outfile>    : output file
 -m<mailuser>   : send report to
 -k[0,1]        : override client/sever: k1=client, k0=server


 -x             : execute fixup on documents
 -y             : commit fixup
 -p             : also run on profile
 -v             : log verbose


This command line program is intended to analyse and correct timedate problems. Specially in Notes R4 some companies disabled Daylight Savings in Notes but activated the summer time on operating system level. This incorrect setting caused problems specially in international environments and environments where some parts have different DST settings. This program scans all documents in specified databases and corrects the wrong timedates by changing them to the right timezone but keeping the actual time and date.

-- Action to perform --

The following actions are currently supported

( -x ) Correct timedates that have been stored with incorrect DST settings

Modifieds all timedates in all Notes documents in the specified databases
If you don't user the -y flag those changes are not stored to disk (only reporting what it would do)

( -y )

Commits the changes and does only work with -x option

( -p )

Also process profile documents

( -v )

Verbose logging

What happens if no flags are used?

If you do not use one of the action flags, the databases are only listed.
You could use this feature to check if your selection is OK or to create a file that you can modify and use via -f option

-- Ways to select databases --

1. specify a database name in the command line
2. specify a list of databases listed in a file via option -f
3. use wildcards (* and ?) for specifying databases and templates including subdirectories if using the ( -r ) option
4. specify a remote server name ( -s ) where to search for databases

you can combine any listed ways

Some examples:

1. specify a database name in the command line


nshdst mydb.nsf

runs on mydb.nsf

2. specify a list of databases in a file via option -f


nshdst mydb.nsf -fdb.txt

runs on whatever.nsf and all databases listed in db.txt
db.txt should contain databases including full path like


3. use wildcards for specifying databases and templates including subdirectories if using the ( -r ) option


nshdst mail/*test*.nsf

runs on all databases that meet the selection within the mail subdirectory
e.g. mail/dus-test.nsf but not mail/dus/old/test.nsf

If you want to include subdiretories use the -r switch.
As soon you have multiple wildcards in different directories you need to use the recurse subdirectory switch


nshdst mail/test?/*.nsf -r

this does match e.g. mail/test1/dnashed.nsf

but also matches mail/test2/hilden/nashcom.nsf because this does also match the pattern.

4. specify a remote server name ( -s ) where to search for databases

-s Option defines the server where databases are searched


nshdst -snotes-acme-01 mail/*.nsf

runs on databases (.nsf files) in directory mail on notes-acme-01

nshdst mail/test??xxx*.nsf

runs on databases (.nsf files) that match the pattern "/mail/test??xxx*.nsf"

-- Output options --

In case you want to redirect output you have the following options

( -o ) Redirect output to file

Writes output to a the file specified.

Example: nshdst mydb.nsf -ooutfile.txt
writes output to outfile.txt

Comment: this option might help to create a list of databases that can be modified and uses as input for "-f" option.

( -m ) Send output via mail

Sends output to the specified user.

Example: nshdst mydb.nsf -m"John Doe"
sends output to John Doe

( -k ) Overwriting Client/Server Settings

Nash!Com Command Line Tools run on Servers or Clients.
However in some cases and environments it can not determine if running on server or as client program using server environment.
Therefore you can override the default settings using this option.
Server and Client functionality does only differ in the way output is logged.

Show details for Installation InstructionsInstallation Instructions
Hide details for Installation InstructionsInstallation Instructions
  1. copy into Notes exe directory
  2. run from command line or server console
    and make sure notes.ini can be found in the directory or is in the path