Starting Fire

Syntax

fire { application } { options ... }

Description

Enter the Fire application development environment.

Parameters

• application
  A Fire application archive (.mxa or .fsa) to execute. If omitted, the macro indicated by the -start option is executed.

Options

• -reg
  Register the Fire environment with the Windows registry. Any other command options are also registered for future ole deployment. Fire will not execute, but confirmation of successful registration is given via a message window. This option must not be used if Fire is located outside of the Xmarc installation file hierarchy.

The -reg option is applicable to Windows systems only.

• -env=<dir>
  If specified as a command line parameter, the following environment variables are set:

Variable	Value
MXSITE	<dir>/config (standard deployment)
MXSITE	<dir>/web_config (browser deployment)
MXSYS	<dir>/system
MXTEMPDIR	<dir>/tmp
MXCACHE	<dir>/cache
MXBIN	<dir>/mx/<arch>/<os>/bin

• -root=<dir>
  If specified as a command line parameter, then similar to -env, but variables MXSITE, MXSYS, MXTEMPDIR, MXCACHE and MXBIN will only be set to the above if not already defined.

• -h
  Prints a summary of the program usage (Unix systems only).

• -appstart=<file>
  Run an application via a .fsc or .xml configuration file.

• -devel
  Start the Fire development system. The default behavior is not to. This can also be indicated by an entry in the Fire Configuration File (fire.ini). The development system will be invoked before any start macro or command line application is executed.

• -display=<dpy>
  Provide an X server/display for Fire to run in. The default is the value of the Unix environment variable DISPLAY. The -display option is applicable to Unix systems only.

• -fxenc
  Encode all database connection strings.

• -listen_udp=<num>
  Create (1) or don't create (0) udp listening sockets for external asynchronous events. The default is 0.

• -log
  Save monitor output in a log file. The default behavior is (-no_log), do not save monitor output.

• -mess=<>file>
  Use <file> as the source of system messages displayed by Fire. If this is omitted, the message file indicated in the Fire Configuration File (fire.ini) is used.

• -monitor=<num>
  Show the monitor window in full or iconic form on start-up. <num> should have a value of 1 or 0. The option -no_monitor is an alternative to -monitor=0. The default behavior is for the monitor window to be in full, i.e. not iconic. The initial state of the monitor window may also be supplied by a monitor entry in the Fire Configuration File (fire.ini).

• -netsock=<port>
  A socket through which peer processes can connect to Fire. This option determines the value of the system identifier network_socket. If omitted, a value zero is used, which means a port number will be chosen arbitrarily when required. It may also be provided by a netsock entry in the Fire Configuration File (fire.ini).

• -proxy=<string>
  Set details of a proxy web server for outgoing internet traffic. This is equivalent to setting the MXPROXY environment variable.

• -rt
  Run time only, no keyboard command input facilities (afire only).

• -sock=<port>
  A socket through which external commands are to be received (browser-deployment). This option is called automatically when Fire is invoked from a browser. It should not be used when Fire is started manually.

• -start=<file>
  Execute the macro file <file> on start-up. If this is omitted, the start macro as indicated in the Fire Configuration File (fire.ini) is executed. Use the option -no_start to suppress macro execution on start-up. Parameters within parentheses may be passed to the macro but the whole string, including file name, should be enclosed within double quotes to avoid problems with shell handling of special characters.

• -no_start
  Do not execute a macro on startup.

• -url=<url>
  Run as a service, registered to a FireRender service broker. <url> is the registration url.

• -web
  Run in browser-deployed mode (as a browser plug-in). This option is called automatically when Fire is invoked from a browser. It should not be included manually.

• -webreg
  Run in browser-deployed mode (as a browser plug-in), and register the location of Fire for future browser-deployment. This option is called automatically when Fire is invoked from a browser. It should not be used when Fire is started manually. The -webreg option is applicable to Windows systems only.

• -wm=<text>
  Provide the name of the X window manager. This is usually redundant since Fire attempts to detect it automatically. It may also be provided by a wm entry in the Fire Configuration File (fire.ini). The -wm option is applicable to Unix systems only.

• -xfont=<font>
  Provide a default X font for text display in widgets and graphics. If this is omitted Fire uses a default according to workstation type. It may also be provided by an xfont entry in the Fire Configuration File (fire.ini). The -xfont option is applicable to Unix systems only.

See Also