Click here to jump to Nash!Com Solutions Homepage - Click here to request a test version.
Daylight Savings Fixup
Version: 1.0
Shortname: nshdst
Category: Command-Line Tool
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).
- correct timedates
- timedate ranges and timedate lists
- report problems without fixing them
- optional also work on profile documents
* | NshDst 1.0 - Notes DST Fixup Tool
|\| (c)2000-2001 NashCom - Daniel Nashed Communication Systems
| * mailto:info@nashcom.de - http://www.nashcom.de
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
Actions:
-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
Example:
nshdst mydb.nsf
runs on mydb.nsf
2. specify a list of databases in a file via option -f
Example:
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
names.nsf
mail/jdoe.nsf
info/acme.nsf
3. use wildcards for specifying databases and templates including subdirectories if using the ( -r ) option
Example:
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
Example:
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
Example:
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.
Installation Instructions
- copy into Notes exe directory
- run from command line or server console
and make sure notes.ini can be found in the directory or is in the path
