OOMMF Launcher/Control Interface: mmLaunch
Keywords: userguide

Next: OOMMF eXtensible Solver Up: OOMMF Documentation Previous: Command Line Launching

#
OOMMF Launcher/Control Interface: mmLaunch

Overview
The application mmLaunch launches, monitors, and controls other OOMMF applications. It is the OOMMF application which is most closely connected to the account service directory and host service directory applications that run behind the scenes. It also provides user interfaces to any applications, notably Oxsii and mmSolve2D, that do not have their own user interface window.

Launching
mmLaunch should be launched using the bootstrap application. The command line is

    tclsh oommf.tcl mmLaunch [standard options]

Controls
Upon startup, mmLaunch displays a panel of checkbuttons, one for each host service directory to which it is connected. In the current release of OOMMF there is only one checkbutton, named for the host on which mmLaunch is running. If there is no host service directory running on the localhost when mmLaunch is launched, mmLaunch will start one. In that circumstance, there may be some delay before the host checkbutton appears.

Toggling the host checkbutton toggles the display of an interface to the host service directory. The host service directory interface consists of a row of checkbuttons, one for each account service directory registered with the host service directory. Each checkbutton is labeled with the user ID of the corresponding account service directory. For most users, there will be only one checkbutton, labeled with the user's own account ID. If there is no account service directory running for the account under which mmLaunch was launched, mmLaunch will start one. In that circumstance, there may be some delay before the account checkbutton appears.

Toggling an account checkbutton toggles the display of an interface to the corresponding account service directory. The account service directory interface consists of two columns. The Programs column contains buttons labeled with the names of OOMMF applications that may be launched under the account managed by this account service directory. Clicking on one of these buttons launches the corresponding application. Only one click is needed, though there will be some delay before the launched application displays a window to the user. Multiple clicks will launch multiple copies of the application. Note: The launching is actually handled by the account service directory application, which sets the initial working directory to the OOMMF root directory.

The Threads column is a list of all the OOMMF applications currently running under the account that are registered with the account service directory. The list includes both the application name and an ID number by which multiple copies of the same application may be distinguished. This ID number is also displayed in the title bar of the corresponding application's user interface window. When an application exits, its entry is automatically removed from the Threads list.

Any of the running applications that do not provide their own interface window will be displayed in the Threads list with a checkbutton. The checkbutton toggles the display of an interface which mmLaunch provides on behalf of that application. The only OOMMF applications currently using this service are the 3D solvers Oxsii and Boxsi, the 2D solvers mmSolve2D and batchsolve, and the archive application mmArchive. These interfaces are described in the documentation for the corresponding applications.

The menu selection File|Exit terminates the mmLaunch application, and the File|Exit All OOMMF selection terminates all applications in the Threads list, and then exits mmLaunch. The menu Help provides the usual help facilities.

OOMMF Documentation Team
September 29, 2018