Sumatra Development LLC

This application extracts GroupWise calendar info.

What you get:
SGWEx.exe the application, run this
GWTapp.dll this dll you need
GWTapp.dbg the debug version, use it if we tell you so
pw.txt sample password file
pwset.txt sample password file setting a pw
ReadMe.txt this file obviously

SGWEx is run from the command line (formerly known as the DOS prompt). The information and any error messages are dumped to standard out, that means you should run SGWEx like this to get a file of output to send to us:
 

    SGWEx ...options... > gwout.txt

    SGWEx generates a file called SGWdump.dat.

    SEND SGWDUMP.DAT to Sumatra! 

We convert SGWdump.dat into an Access database and map users for you to insert into Exchange.

You MUST be logged in to NetWare as an administrator to run SGWEx.
(i.e. you should be able to run ConsoleOne and create GroupWise users). If you
are not logged in you'll probably get this ugly error:
 

 Access Violation (error 0xC0000005)

The program takes various flags & options, they are detailed in the usage
section below. But the best thing is to follow the examples given depending
on your scenario.

This program has been tested in GroupWise 6.5 installations.
It may not work at all on earlier versions.

Authentication Methods

There are several options for accessing user accounts, these are listed
below in order of desirability, which method you use depends on your
particular situation.

1. Trusted Application

The best way to use SGWEx is as a trusted application. This will only
work in GroupWise 6.5. This does not require you to know any user passwords
(except your own Admin password) nor does it change any passwords.

To install SGWEx as a trusted app run the following:
SGWEx -tinstall

This will write a key to the file "key.dat"

Then dump user calendar info by running:

SGWEx -pt

which should find the key file in the working directory

SGWEx -pt key.dat

where you supply the key file name or path.


To remove SGWEx as a trusted application, use ConsoleOne or run:

SGWEx -tremove

or
SGWEx -tremove key.dat

You do need the key file to remove the app with -tremove.

Remember to keep the key file safely.

2. Password file

If the program is able to run in versions of GroupWise before 6.5, you
may wish to use a password file. This file will supply the passwords
for all users.

The password file is a comma separated (CSV) file, the syntax of each
line is:

<login>,<password>[,<set>]

Where <login> is the (GroupWise) login, <password> is the password
and <set> is an optional field either 0 or 1. 1 means set the user's
password to <password>.

For example:

Bob,secret
Carol,pussnboots
Ted,vienna69
Alice,"doesn't live here"

To use a password file and *NOT* change (set) any passwords, run:

SGWEx -pf pw.txt

(or whatever your file is named). This will ignore any <set> fields.

If you don't know the user passwords you can use the password file to
reset all or any user's passwords. For example, you could use the file:

Bob,Bob45,1
Carol,Carol23,1
Ted,Ted69,1
Alice,Alice38,1

And tell everyone e.g. "Your new password is your login with your age
appended", then run:

SGWEx -pfs pwset.txt

The -pfs option is like -pf but *DOES* allow setting the password.

There are example password files in pw.txt and pwset.txt

NOTE: If no password is available for a user, or the wrong password is supplied,
you'll get an error like this:

Error dumping user:
COM Error: x80004005


3. Password supplied

If everyone has the same password, you can run:

SGWEx -pw thepassword

Or you can reset everyone's password and use a new password with:

SGWEx -ps newpassword

This is probably the simplest method (except the Trusted Application)
if all users are no longer on GroupWise. But be careful with this.

Usage

The syntax of all the command line flags (for those who like this kind
of thing).

SGWEx
Usage: SGWEx -tinstall [keyfile] | -tremove [keyfile]
| (-pt [keyfile] | -pf <file> | -pfs <file> | -pw <pw> | -ps <pw>)
[-nu] [-nc]
| -help | -?
Must be logged into NetWare before running
-tinstall Install trusted app, write key to keyfile (default key.dat)
-tremove Remove trusted app

Default operation is dump, specify one of these authentication methods:
-pt Use trusted app for authentication, key in keyfile (default key.dat)
-pf Use password file
-pfs Use password file and set passwords
-pw Use supplied password for all accounts
-ps Set all passwords to supplied value
Dump options:
-nu No user details, just user list (default is to dump all details)
-nc No calendars (default is dump calendars)

-help, -? Print this usage