GeoMedia User Command Installer

Utility Information Version: 02.00.00.09 Date: August 12, 2002 Description: This utility provides a GUI interface to register and install user commands for GeoMedia. Intergraph assumes no liability or responsibility for this utility.

Enhancements made in 02.00.00.09

1. Uninstall will remove empty pull-down menus.
2. A new keyword called PULLDOWN MENU BEFORE HELP will create new top level menus before the help menu.

Enhancements made in 02.00.00.07

1. Install makes an entry into Add/Remove Programs.
2. You can now uninstall from Add/Remove Programs.
3. You can install multiple commands at once.
4. The setup.lst file has many new options. See Automatic mode section for details.

Manual mode: No setup.lst file.

1. Run the GMCommandInstaller.exe.
2. In the Directory That Contains the Command Files field, enter the location of your dlls.
3. Select the Command Files Browse... button.
   The Select File(s) dialog box is displayed.
4. Select the dll files you want to install.
5. Select the OK button.
6. If there are any other DLLS to register, add them to the Other DLLs to Register list box using the Browse... button.
7. Select the Next > button.
8. In the Product field, select the desired GeoMedia product.
9. In the Destination Directory field, enter the destination for the command files.
10. Select the Next > button.
11. Select the Add Command(s) to Menu Bar check box if you want the new command to be displayed in the GeoMedia menu bar. If you choose not to Add Command to Menu Bar at this time, you can always do it inside of GeoMedia.
12. Select the Install button.

Automatic mode:

Use a setup.lst file to drive the GeoMedia Command Installer. Ideal for delivering your GeoMedia User Commands.

Setup.lst Format

TITLE=<Title of command>
WINDOWTYPE=Data, Map, or NoDoc
DELIVER INSTALL EXE=YES or NO
DELIVER UNINSTALL EXE=YES or NO
DESTINATION DEFAULT=<Default directory for command files>
DESTINATION RESTRICTION=<Directory for command files.>
PULLDOWN MENU BEFORE HELP=YES or NO
COPY FILE=<Input Filename>,<Output File>,<shared file>
REGISTER FILE=<Input Dll Name>,<shared dll>
COMMAND=<Input Dll Name>,<Input INI Name>,<shared dll>,<WindowType>,<PullDown Menu>

Where:

TITLE=<Title of command>

• Title of the command or command files.

WINDOWTYPE=Data, Map, or NoDoc

• (optional) For the menus, what is the default window type for all the commands being installed.

DELIVER INSTALL EXE=YES or NO

• (optional) Do you want the GeoMedia Command Installer to be copied to the destination directory.

DELIVER UNINSTALL EXE=YES or NO

• (optional) Do you want the GeoMedia Command UnInstaller to be copied to the destination directory.

DESTINATION DEFAULT=<Default directory for command files>

• (optional) Default directory for command files. The user will still be allowed to override the destination directory.

DESTINATION RESTRICTION=<Directory for command files.>

• (optional) Directory for the command files. The user will NOT be allowed to modify the destination directory.

PULLDOWN MENU BEFORE HELP=YES or NO

• (optional) Semi-control where Top Level Menu is created. If set to YES, the new top level menu will be created before the help menu. By default, any new Top Level Menu will be created at the end of the menu bar.

COPY FILE=<Input Filename>,<Output File>,<shared file>

• (optional)
• <Input Filename> = Input filename to be copied. Do NOT include path.
• <Output File> = (optional) The destination file. Path can be included. You can use the keyword "[COMMAND]" for the destination directory. You can use the keyword "[GEOMEDIA]" for the GeoMedia directory. You can use the keyword "[GEOMEDIA PROGRAM]" for the GeoMedia\Program directory.
• <shared file> = (optional) TRUE or FALSE. The default is FALSE. If set to TRUE, then the Input file will be copied to the GeoMedia\Program directory. If set to TRUE and the Uninstaller is ran, then this file will not be deleted.
• Notes: If <shared file>=TRUE, then the file will be copied to the GeoMedia\Program directory. If just the <Input Filename> is set, then the file will be copied to the destination directory.

REGISTER FILE=<Input Dll Name>,<shared dll>

• (optional)
• <Input Dll Name> = Input dll or ocx to be copied and registered.
• <shared dll> = (optional) TRUE or FALSE. The default is FALSE. If set to TRUE, then the Input Dll file will be copied to the GeoMedia\Program directory and registered. If set to TRUE and the Uninstaller is ran, then this file will not be deleted nor un-registered. If not set or set to FALSE, then the Input Dll file will be copied to the destination directory and registered. If set to FALSE and the Uninstaller is ran, then this Dll file will be deleted and un-registered.

COMMAND=<Input Dll Name>,<Input INI Name>,<shared dll>,<WindowType>,<PullDown Menu>

• <Input Dll Name> = Input dll to be copied and installed.
• <Input INI Name> = Input ini to be copied and used in conjunction with the dll.
• <shared dll> = (optional) TRUE or FALSE. The default is FALSE. If set to TRUE, then the Input command files will be copied to the GeoMedia\Program directory and installed. If set to TRUE and the Uninstaller is ran, then the command files will not be deleted nor un-installed. If not set or set to FALSE, then the input command files will be copied to the destination directory and installed. If set to FALSE and the Uninstaller is ran, then the command files will be deleted and un-installed.
• <WindowType> = (optional) Data, Map, or NoDoc. Which window type menu bar do you want this command to be added to.
• <PullDown Menu> = (optional) Which pulldown menu do you want this command to be added to.

Example 1 (Simple):

Command files are copied to the destination directory and installed. User is given control on where commands are placed on the menu bars.

TITLE=My Command Name
COMMAND=MyCommand1.dll,MyCommand1.ini
COMMAND=MyCommand2.dll,MyCommand2.ini

Example 2 (Simple):

All files are copied to the destination directory. MyControl.ocx is registered. MyCommand*.dll files are installed. User is given control on where commands are placed on the menu bars.

TITLE=My Command Name
COPY FILE=MyReadme.txt
REGISTER FILE=MyControl.ocx
COMMAND=MyCommand1.dll,MyCommand1.ini
COMMAND=MyCommand2.dll,MyCommand2.ini

Example 3 (Simple):

All files are copied to the destination directory. MyControl.ocx is registered. MyCommand*.dll files are installed. User cannot control where commands are placed on the menu bars. Note that in this example a separator bar is added.

TITLE=My Command Name
COPY FILE=MyReadme.txt
REGISTER FILE=MyControl.ocx
COMMAND=MyCommand1.dll,MyCommand1.ini,,Map,&MyPullDown
COMMAND=[Separator],,,Map,&MyPullDown
COMMAND=MyCommand2.dll,MyCommand2.ini,,Map,&MyPullDown
COMMAND=MyCommand3.dll,MyCommand3.ini,,Map,&MyPullDown

Example 4 (Complex):

Because DESTINATION RESTRICTION is set to [GEOMEDIA PROGRAM], all files are copied to the GeoMedia\Program directory, except for the following:


The MyCommand.drx file is copied to GeoMedia\Program\resdlls\0009\MyCommand.drx.
The MyReadme.txt file is copied to GeoMedia\MyReadme.txt.
Note that the install.exe will not be delivered.
TITLE=My Command Name
DELIVER INSTALL EXE=NO
DESTINATION RESTRICTION=[GEOMEDIA PROGRAM]
COPY FILE=SharedDllLibrary.tlb,,TRUE
COPY FILE=MyCommand.drx, [GEOMEDIA PROGRAM]\resdlls\0009\MyCommand.drx
COPY FILE=MyReadme.txt, [GEOMEDIA]\MyReadme.txt
REGISTER FILE=SharedDll.dll,TRUE
REGISTER FILE=MyControl.ocx
REGISTER FILE=MyDll.dll
COMMAND=MyCommand1.dll,MyCommand1.ini
COMMAND=MyCommand2.dll,MyCommand2.ini