Creating a Local Execution Shortcut

This procedure guides you through the process of creating a Local Execution Shortcut using the Shortcut Wizard

Shortcut Wizard page 1: Shortcut identification and Connection type

1. Complete the fields of the Shortcut identification section:
   1. In the Name field, provide a name for the shortcut.
   2. Optional: In the Icon field, provide a file name that will be used to display an icon associated with this shortcut.
   3. Optional: If you want to store the shortcut locally for the current user, select the Store shortcut in settings checkbox.
      By default, shortcuts are saved in the &AppDataDir/config.xml file (see GDC configuration file directories for more information). Shortcuts written to this file are shared amongst all users who use this installation of the GDC. Selecting the Store shortcut in settings option is useful when the GDC is on a shared network drive and you do not want the current user to modify the common shortcuts.

      Note: When the config.xml file is read-only, the Store shortcut in settings checkbox is selected by default and you do not have the option to deselect it.

      Note: Any modification to a non-local shortcut displays a warning and creates a local copy of the shortcut.
2. In the Connection type section, select the Local execution and click Next.

Shortcut Wizard page 2: Local execution information

3. Enter the Local execution information that you want to specify in the Executable file, Working directory, and Parameters fields To start your program on the Runtime System, GDC will simply start an executable (giving it some parameters). This executable will typically be one of the following types:
   • fglrun started in the application directory
   • a batch file that will start all applications

   You can have, for example:

   Table 1. Local execution shortcut examples

   Executable file	Working Directory	Parameters	Remarks
   fglrun	/home/fgl/demo/	stores.42m	fglrun should be in the PATH
   c:\<mydir>\fgl\bin\fglrun.exe	c:\genero\demo	stores.42m
   c:\demos\stores.bat			stores.bat is a batch file that sets the environment and starts the program.

   Note: For complicated commands, use a script.
   Important: If you have the configuration shown below, you must be sure that all the environment variables are set before starting the application. The variables can be set in the Environment Variables system dialog.

   Table 2. Local connection shortcut example revisited

   Executable file	Working Directory	Parameters	Remarks
   c:\<mydir>\fgl\bin\fglrun.exe	c:\genero\demo	stores.42m

4. Click Finish to complete the setup and exit the Shortcut Wizard.