How to use GWAFE510 (Archive FID Editor).

Instructions on using the GroupWise 5.x Archive FID Editor 1.0, GWAFE510.EXE--Note that the Archive FID editor will work on any GroupWise 5.x or GroupWise 6.x database.

1. CHANGING THE ARCHIVE DIRECTORY NAME

The archive directory should be named such that it matches the new FID, in other words, the same FID that you are trying to get the archive databases to match. So for example, if the FID for BOB was 123 then their archive path would be c:\archive\of123arc. Now you re-created BOB and he now has a FID of ABC. You need to rename the"c:\archive\of123arc" directory to "c:\archive\ofABCarc". Then proceed to the next step.

2. BE LOGGED INTO NETWARE, KNOW YOUR CONTEXT

Log into NetWare with administrative type rights. Determine your login context (* see Note below).

3. Feed the following command to the FID editor.

GW5AFE.EXE
Here's an example of the command line:

gw5afe c:\rod1\of88Xarc 88X .twd1.nrc

Additional information :Note: Be sure to use the leading dot ( . ) in front of the GroupWise domain name ( twd ) or you will receive an error about checking rights.

NOTE:

(a.) I followed step 1 to create the condition that gave me the portion of the command line that says ". . . . c:\rod1\of88Xarc . . ." The GroupWise Domain name is "twd1".

(b.) "88X" is the FID for the new user who I want to get the archive renamed for so the new user can unarchive the E-mail. So since "GR4" is the FID for the old user, the OFGR4ARC directory was renamed to OF88XARC.

(c.) Here's the reasoning behind "twd1.nrc" portion of the command line. TWD1 is the name of a GroupWise domain in my NDS Tree. The fully distinguished name of the domain is TWD1.NRC.ACME1, however if I issue the CX command at a DOS prompt I notice that my context is "ACME1" so I only had to fill in "twd1.nrc" in my command line. I cannot use the fully distinguished name of the domain unless I'm logged in at the root. If I do, then I get an error

LOOK AT MY COMMAND LINE:

"C:\temp\fid>gw5afe c:\rod1\of88xarc 88x twd1.nrc.acme1"

THIS IS THE ERROR I GET:

DS Error checking rights! (0xFFFFFDA7)
Error Checking Password (0xFFFFFDA7)
Terminating Program

HERE'S WHAT DSTRACE SHOWED IN IT'S LOG

364B125A:089:FB007100 resolving twd1.nrc.acme1.ACME1, flags 0x2062
364B125A:089:FB007100 Responding with no such entry for twd1.nrc.acme1.ACME1.ACME.

For this error make sure you have typed in the correct Groupwise Domain name. If the name of the Domain is longer then the DOS limitations you will need to add quates around the Domain name. For example if your domain name it Tray - dom you would need to type you command with quates around the name. IE :"C:\temp\fid>gw5afe c:\rod1\of88xarc 88x "tray - Domain"

* The easiest way to set your context is by using My Network Places in Windows (Network Neighborhood in Windows 95/98). Locate your Tree object in My Network Places, expand the Tree to show the Organizations, expand the appropriate Organization then Organizational Units until you can select the Organizational Unit that contains the Domain object. Then right click on that Organizational Unit and hit "Set Default Context." In the example above you would expand the Tree, then expand ACME1, select NRC right click and hit "Set Default Context." You would then type GW5AFE C:\ROD1\OF88XARC 88X TWD1 to successfully run the FID editor.

Another way to set your context is with CX.EXE which is in the SYS:PUBLIC directory. It is used to view and to change your NDS context in the Tree ("walk the Tree") from a DOS prompt . You should have a search drive mapped to the SYS:PUBLIC directory to run CX. Type "CX" to view your context. Type "CX ." to move up the Tree to the containor above your current context. Type "CX" to move down the Tree to a containor below your current context. In the example above, if the current context were ACME1 you could type "CX NRC" which would set the context to NRC.ACME1. You would then type GW5AFE C:\ROD1\OF88XARC 88X TWD1 to successfully run the FID editor.