Configuring GM Launch (Obsolete)


GM Launch is the GM approved application to start NX or TcAE. It sets up the environment that is needed by GM for their customizations. Though the DSL integrates the GM programs into Delphi's customizations, it is necessary to be able to start NX with GM's environment. This document specifies how a site can configure GM Launch for use.

NOTE: GM Launch is a Java application and requires Java 1.X.Y or higher to be installed on the client.

Basic Steps To Configure GM Launch

Follow these steps to setup GM Launch for use:

  1. Copy $DSL_BASE_DIR/plugins/gmtk/gmlaunch.dat to a location under /appl/ugsite and make the necessary modifications to the file for the site.
  2. Run the DSL configure application.
  3. Add the JAVA variable to point to the java runtime application in the Site Settings panel for both UNIX and windows. Only one declaration is needed if just one platform is used at the site.
  4. Add the GMLAUNCH_DAT_FILE variable to point to the local copy of gmlaunch.dat in the Common tab in the Site Settings panel.

Modifications Needed For Local gmlaunch.dat File

Use this table to determine what to modify in the local gmlaunch.dat file. The modifications are isolated to the WINDOWS_GLOBAL and UNIX_GLOBAL sections of the file. The WINDOWS_STANZA and UNIX_STANZA sections should not need any changes.

Section Variable Value to set to
WINDOWS_GLOBAL DSL_BASE_DIR The location of the base DSL installation (ex. C:\Program Files\nxdslX.y)
IMAN_ROOT The location of the GM's TcAE X.Y installation
GMPDM_ROOT Make sure this points to GM's TcAE customizations
UGII_BASE_DIR Set to the NX install location(Must use short path - path with ~)
UGII_PLOT_NODE (Optional) Set to local plot server for plotting
GMIMAN_DATA_DIR Set to directory where GM's imandata directories are installed
The above variables use the Windows path format(c:\some\dir) and windows environment variable format(%ENV_VAR%).
UNIX_GLOBAL WEB_BROWSER_EXE Set to a web browser start script
DSL_BASE_DIR The location of the base DSL installation (ex. /appl/nxdslX.y)
IMAN_ROOT The location of the GM's TcAE X.Y installation
GMPDM_ROOT Make sure this points to GM's TcAE customizations
UGII_BASE_DIR Set to the NX install location
UGII_PLOT_NODE (Optional) Set to local plot server for plotting
GMIMAN_DATA_DIR Set to directory where GM's imandata directories are installed

The above variables use the UNIX path format(/some/dir) and windows environment variable format($ENV_VAR or ${ENV_VAR}).

Running GM Launch

Simply use the DSL menu to run the GM Launch application. The valid applications should appear in the list. This should include the following:

The application names will probably appear differently, but should be simliar. Four TeamCenter databases and native NX should be in the list.