Create a Local Execution shortcut

With a Local execution shortcut, the Runtime System is on the same computer as the GDC.

To open the Shortcut Wizard, in the Shortcuts window, click the New button.

Shortcut Wizard page 1: Shortcut identification and Connection type

  1. In the Shortcut identification section, specify the Name and optionally the Icon for the shortcut.

    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 Local execution and click Next.

Shortcut Wizard page 2: Local execution information

  1. In the Executable file field, enter the name of the executable to start.
    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
  2. In the Working directory field, enter the name of the working directory. This is typically the directory that holds your executable programs.
  3. In the Parameters field, enter any needed parameters, such as the name of the program to execute.

    This table shows some possible examples for completing the Local execution information page:

    Table 1. Local execution shortcut examples
    Executable file Working Directory Parameters Remarks
    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.
  4. Click Finish to complete the setup and exit the Shortcut Wizard.

The shortcut is created and ready to use.

Important:

Environment variables must be set prior to starting the application. Set the variables in the Environment Variables system dialog.