DSKTOOL.EXE Utility - Updates Notes desktop icons for user after recertification

Downloadable files


Abstract

The DSKTOOL.EXE Utility remediates the desktop icons in a recertification exercise.

Download Description

The DSKTOOL.EXE Utility essentially remediates the user's desktop icons in a recertification exercise.

Note: This tool is provided "as is" and no additional support will be provided.

Prerequisites

Lotus Notes

Installation Instructions

Download the correct version of dsktool.exe for the version of Lotus Notes you are using, and place it in the program directory of the Notes client.

dsktool <scriptfilename> -Options

The script file should have one or more lines with the following formats:

Rename <Old Server Name>, <New Server Name>.
Rename <Old Server/File Name>, <New Server/File Name>
Delete <Old Server Name>.
Delete <Old Server/File Name>

For example:

Rename OldServer NewServer
Rename Server/OldOrganization Server/NewOrganization
Delete DeletedServer

Note: The server names can be specified as Server/Org.
If a server has hierarchy, it must be specified.
If a server name has any embedded spaces, a comma MUST be used to separate the old name and new name.


-Q (Q)uiet mode. Suppresses all messages.
-V (V)erbose. Shows files that were not changed as well.
-D Do not allow shut(D)own of the client.
-R Do not allow (R)estart of the client.
-U *(U)ppercase all filenames and directories.
-L *(L)owercase all filenames and directories.
-I *(I)gnore current Notes version and run anyway if newer.
-? (H)elp. Display this.

*Introduced in 6.x compatible version.

Additional Notes:

If a server does not have a space, the old format will still work.
If a server name has a space, it should be followed by a comma.

i.e. All of the following are valid lines

Rename ServerOld ServerNew
Rename ServerOld with a space, ServerNew with a space new
Rename ServerOld with a space,ServerNew with a space new

- the file supports both native character sets and LMBCS

This can be run manually, or via a POST_OPEN db event using LotusScript and creating a scriptfilename to feed to the tool.


There are three known issues running the 6.x version:

1. When deleting servers, you might receive a message "Modify location failed for Note xxxx because document has invalid structure".

This above message can be ignored.

2. Renaming works fine for bookmarks and workspace icons. However, deleting a server does not remove existing bookmarks but it does remove the workspace icon.

This tools was designed for icon manipulation. Since bookmarks are a database (bookmark.nsf) and not a workspace icon, deleting the last server will not remove the entire bookmark entry.

3. The Tool may return the following error when running on later versions of Notes 6.x:

"WARNING: This tool may ONLY be run against a known version of the product. The current Notes version was developed after this tool and is incompatible"

This can be avoided by using the -I switch to skip the Notes version check and continue.

Sample Output:
Using the DSKTool with 6.5.4 Notes Client.

Script file (rename.txt) contains:

Rename serverA/ACME serverB/ACME

Command line execution is:

dsktool rename.txt -I -V

Note: The 6.x version of the Dsktool works with Notes 7.x clients but you must use the -I option to ignore version checking.

OUTPUT:
#############################################################################
C:\temp\DSK>dsktool rename.txt -I -V

Iris desktop tool modification utility, Version 1.24.
Copyright (c) Iris Associates, Inc. 2001. All rights reserved.
Current Notes Build 196.
Tool built for Notes Build 194 and earlier.
Internal release, unsupported.

Asking client to close, please wait...
Working on file C:\Lotus\Notes\Data\desktop6.ndk...
CHANGED: Desktop Icon Entry: serverB/ACME mail\admin.nsf.
CHANGED: Desktop Icon Entry: serverB/ACME names.nsf.
UNCHANGED (Skipped): Desktop Icon Entry: names.nsf.
UNCHANGED (Skipped): Desktop Icon Entry: bookmark.nsf.

Modify Locations:
CHANGED: Last Bookmark Used for 9D6: serverA/ACME names.nsf -> serverB/ACME names.nsf.
CHANGED: Last Bookmark Used for 9D6: serverA/ACME mail\admin.nsf -> serverB/ACME mail\a653.nsf.
CHANGED: Location field MailServer for 9D6: serverA/ACME -> serverB/ACME
#############################################################################

Download package


Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
8.5.x DSKTOOL.EXE Utility 10 Dec 2012 US English 73728 FTP
6.x DSKTOOL.EXE Utility 4/1/2004 US English 93900 FTP

Cross reference information
Segment Product Component Platform Version Edition
Messaging Applications IBM Domino 8.5, 7.0, 6.5, 6.0


Rate this page:

(0 users)Average rating

Document information


More support for:

IBM Notes

Software version:

6.0, 6.5, 7.0, 8.5

Operating system(s):

Windows

Reference #:

4004260

Modified date:

2012-12-11

Translate my page

Machine Translation

Content navigation