Resource Manager (ResMan)

On rare occasions, you may need to examine or modify the GUID of a server shell .exe Communication Driver module. Use the Resource Manager (ResMan) utility to do this.

Note: Modifying a module’s GUID should be done with great care because the GUID embedded in a module must remain in sync with the GUID inserted in associated code for the Communication Driver to operate properly.

ResMan can be used for the following purposes:

• To examine the GUID of an existing server shell .exe container module (for instance, an EXE file that controls DLL files).

• To generate a server shell .exe container for a specific Communication Driver with a new GUID.

• To insert a new GUID value into an existing server shell .exe container module.

Run ResMan by clicking ResMan.exe from th Utility folder. A dialog box appears in which you can access all of the program’s functions.

Source File specifies the filename of the "template" container module that is to be copied to generate the new server shell .exe container module. If you are examining the GUID of an existing server shell .exe container module, use this element to specify the file that contains the GUID to be examined.

Destination File specifies the filename of a server shell .exe DAServer module. If you are inserting a new GUID value into an existing server shell .exe container module, Destination File is an existing file into which a new GUID will be set. When inserting a new GUID into an existing server shell the Source File field should be empty.

Use the Browse buttons to navigate to filenames that already exist or to a folder location for a new filename.

Click Retrieve to extract the GUID from the file specified in the Source File field and display it in the Server GUID box. The Retrieve button is disabled when Source File is empty.

Note: If you choose to edit the GUID displayed, it must remain in valid "Registry format" ({XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}).

The following figure shows the result of typing a valid name in Source File and clicking Retrieve. For retrieve operation , clear Destination File text box.

The Set button is enabled only if both the Server GUID text box contains a validly formatted GUID and Destination File is not empty. Press Set to do one of the following:

1. Copy the source file into the destination file (if you are generating a server shell .exe container for a specific Communication Driver with a new GUID).

2. Set the GUID in the Server GUID box into the newly copied file (if you are generating a server shell .exe container for a specific DAServer with a new GUID or inserting a new GUID value into an existing server shell .exe container module).

   The following figure shows the result of entering a valid name in Destination File. Note that the Set button is enabled. For Set Operation, clear Source File text box.

   

3. Click Close to close the ResMan program.

   Note: If you are using the ServerExe.exe shell and Resource Manager utility to update an existing shell, then you must embed a manifest into the resulting executable after resman has embedded the server GUID. To do this you must run the following command from the Visual Studio 2008 command prompt: "mt.exe -manifest serverexe.exe.manifest -outputresource:<ServerName>.exe;1," where <ServerName> is the output of the resman utility after the GUID is embedded.