# GBM PM-Tools Installation

The following chapters describe the installation procedure for the GBM PM-Tools on OS/2 and eComStation.

All applications included in this package require a version of GBM.DLL higher than version 1.11. Recommended is GBM.DLL 1.35 or higher.

Depending on the applications you want to use, copy the following files into an empty directory. For the PM applications GBMV and GBMV2 German and English versions are available.

- GBMV:

  Required files: `gbmv.exe`, `gbm.dll`

- GBMV2:

  Required files: `gbmv2.exe` , `gbmv2.hlp`, `gbmdlg.dll`, `gbmdlg.hlp`, `gbm.dll`

- GBMDLG:

  Required files: `gbmdlg.dll`, `gbmdlg.hlp`
  Developers who want to use it in their own programs need additionally `gbm.h`, `gbmdlg.h`, `gbmdlg.lib`.

- GBMLOGO:

  Required files: `gbmlogo.exe`, `gbm.dll`

- GBMVFSA:

  Required files: `gbmvfsa.exe`, `gbm.dll`

There is a REXX script included (gbmwpobj.cmd) that creates desktop icons for GBMV and GBMV2. Simply copy it to their installation directory and run it.

## Accessing all tools from everywhere

GBM.DLL can be installed at a central location of the system so that it is found in the paths defined by LIBPATH in CONFIG.SYS. Thus sharing between all programs of this package and the programs from the gbmos2 (the command line tools) package is possible.

If you're using eComStation 1.2 or 1.2R please read the special notes for installing GBM to this system here.

Note:

If gbmv.exe and gbmv2.exe should be run from everywhere on the command line or a different work directory in the WPS program object than the program installation directory should be used, it is necessary to add the installation directory to some environment variables in CONFIG.SYS.

The following changes are necessary: (It is assumed that the installation directory is D:\GBM)

1. Add D:\GBM to the end of the line beginning with SET PATH separated by ; to the previous parameter.
   (e.g. `SET PATH=C:\OS2;D:\GBM`)

2. Add D:\GBM to the end of the line beginning with SET HELP separated by ; to the previous parameter. This is necessary so that the system can find GBMV2.HLP and GBMDLG.HLP.
   (e.g. `SET HELP=C:\OS2\HELP;D:\GBM`)

3. Add D:\GBM to the end of the line beginning with LIBPATH separated by ; to the previous parameter. This is necessary so that the system can find GBM.DLL and GBMDLG.DLL.
   (e.g. `LIBPATH=.;C:\OS2\DLL;D:\GBM)`

4. Reboot.

5. For this step you need gbmver.exe. It is included in the GBM base package only, which you have already as you have GBM.DLL. Copy it into the installation directory if it's not already there.
   Open a command line and go to a directory OTHER THAN the installation. Then start gbmver.exe as if it would be in this directory. It should report the location and the version of GBM.DLL as well as the location of GBMDLG.DLL (GBM File Dialog). Verify that the reported files are the installed versions. If the reported files are found in a different path, do a file search for GBM.DLL or GBMDLG.DLL on your system and check for duplicates or older versions.
   If an older version of GBM.DLL is found (version must be higher than 1.11 !!!), you can replace it with the GBM.DLL from the GBM base package. Alternatively modify the LIBPATH statement in CONFIG.SYS so that the correct path to GBM.DLL and GBMDLG.DLL is placed before all other versions. After the changes are done, check again with gbmver.exe.