Legion GUI single host dialog box

Table of Contents
1. Overview
2. Starting the single host dialog box
3. Using the single host dialog box
3.1. The program data panel (on the left)
3.2. The execution panel (on the right)
3.3. The button panel
4 The registered program list dialog box
4.1. Displaying a single host specification
4.2. Removing a single host specification
Other on-line tutorials & documentation
Other GUI pages:
Click on the to move to the selected text.

A note on this page's style conventions: context path names are in a fixed font and the GUI's main menu bar command options are in green. If you need to click a series of options, they will be separated by a "|" pipe. For example, File | Import indicates that you need to go to the menu bar, click "File" and then click "Import".

1. Overview

The single host dialog box (figure 1) allows you to register and run a program on a single host via the GUI. The program can be already registered in context space or located in local storage space. The dialog box allows you to name input and output files and command-line arguments. If the program is not already registered in Legion, you can provide the necessary information for registering it via the GUI.
Figure 1: Single host dialog box

Once you have entered a program's Legion registration and execution information in the single host dialog box, the program is also registered in the GUI. GUI registration information is not available outside of the GUI but it can be retrieved in subsequent GUI sessions.

2. Starting the single host dialog box

There are two ways to bring up the single host dialog box, both using the main menu bar. Run | List | Single host command displays a list of all of your GUI registered programs (Figure 4). This list does not include programs that have been registered in Legion via the command line. Select a program and click the Display button or double-click on a selection. See below for more information on the registered program list dialog.

If you wish to register a new program or register alternative execution information for a previously registered program, use Run | Single host command. This calls up an empty single host dialog box.

3. Using the single host dialog box

The dialog box is divided into three parts (see Figure 3): two data panels next to each other and a button panel on the bottom. The left-hand data panel identifies the program and its files and the right-hand data panel identifies Legion registration and execution parameters. Each of the information fields are described in the following sections. They are notated with some or all of the following codes in brackets:
Grequired for the GUI registration;
Lrequired for Legion registration; and
Rrequired for program execution.
If none of the codes appear, the field is for information purposes only.

3.1. The program data panel (on the left)

There are five fields and one table in this panel.

Program Title [ ]
Assigns the program a title. This title appears only in the registered program list dialog box (Figure 4).

Program Class [G, L, R]
The program's Legion class. You select the class by selecting a context folder (probably /class or a member of /class) then clicking on the Program Class field. The class's full context path will then appear in this field. If you have selected a context folder as the container for the program class, the GUI will automatically append the name in the Program Name field to the Program Class context path.

Program File Name [G, L, R]
The program's file name. This field has two labels, Legion and Local. The label shows where the name can be found: you can select either label. If Legion, you must select a name from one of the open GUI view windows. If Local, you must manually enter the program name's full local file name (click on the field to call up a file name dialog box, click Done or hit the Enter key on your keyboard when finished). Select the entire entry and hit Delete to clear the dialog.

If you have already entered information in the Program Class field, the GUI will ask if you wish to use the Program File Name as the program class name. If so, the class name in the Program Class field will be replaced with the program file name.

The program name and path is stored in the GUI registration information, so if you are editing a previous GUI registration and change the program file name it will be treated as a new GUI registration and previous registration information will be deleted.

Program Path [G, L, R]
Shows the program's path. This field cannot be edited. You must change the program file name entry in the Program File Name field.

Program Input/Output Files [ ]
Specifies the input and output file that the program will use during execution. You can specify Legion contexts and local files by toggling the lower left hand button (below the input files column) to Legion or Local.

If you are entering Legion contexts, click on the desired context name in an open GUI view window then click a field in either the input or the output column in the dialog box. You can specify as many files as you like. To clear an entry, click on the entry then click the Clear button. To change an entry, click on the entry then click on the desired replacement in an open view window.

If you are using a local source, any file names you provide must be in local storage. You'll need to enter each one manually, with a full path. When you click on an empty cell, an empty file name dialog box will appear. If you click on an occupied cell, the lower right button will read Edit Name. If you select it, a file name dialog box with the cell's contents will appear. You can edit the entry as required (press the Delete key to clear the entry, press Done or the Enter key on your keyboard when you are finished).

Whether the input/output files are Legion or local, the full path name will not appear in the table (it will appear in the Selected File Path field just below the table).

3.2. The execution panel (on the right)

There are three fields in this panel.

Preferred Architecture [L]
A pull-down list of supported architectures. You must choose an architecture that is compatible with your program.

Preferred Host [ ]
Specify the host on which you prefer to run your program. If you leave this field blank, Legion will select a host with the appropriate architecture for you. The default setting is blank.

Command Line Arguments [ ]
Specify a set of command line arguments for the program's execution. Enter them exactly as you would write them on the command line. This field uses a pull-down list format, which allows you to provide more than one set of arguments. When you run the program, you can select which set of arguments to use.

There are three buttons below this field, which allow you to enter multiple sets of arguments:

Press to enter a new set of arguments. Press the Enter key on your keyboard to complete the entry.

Press to edit the current set of arguments. Press the Enter key on your keyboard to complete the entry.

Press to delete the current set of arguments.

3.3. The button panel

There are six buttons along the bottom of the single host dialog box.

Both the Save/Update and Registration buttons save information entered in the dialog box is in a BasicFileObject stored in a special Legion context (accessible only by the GUI). The program's full path name is used as the context name.

Execute the program in Legion. The execution will use any specified input and output files and command line arguments. This button is enabled only if the program has been registered in Legion (via the Registration button or the command line).

Lists all single host programs that have a GUI registration. This button carries out the same function as the Run | List | Single host command on the main menu bar. This button is enabled as long as there is at least one GUI registered program.

Collects and organizes new and updated information in the dialog box. If the information in the dialog box has not been registered in the GUI, the button will be labeled Save. Otherwise, it will read Update. Processing may take a few minutes, but you will see a notification message when it is finished. This button is enabled once you enter a program name in the Program Class field.

Please note that ONLY the GUI registration information will be updated. GUI registration is not the same as Legion registration.

This button registers a program in Legion and the GUI. You must provide a program class, program name, and architecture in order to successfully register a program in Legion, so the button is disabled until that information is provided. If the program has already been registered with Legion (i.e., a program class name already exists), the button will be disabled and the Run button will be enabled. However, if you change the program class, name, or architecture values, you must reregister the program.

When the button is pressed, the GUI first updates its own registration then registers the program with Legion. A notification message indicating success or failure will appear at the end of this process.

Clears all fields in the dialog box and disables the Run, Save/Update, and Registration buttons.

Closes the dialog box. All information that has not been saved will be lost.

4. The registered program list dialog box

This dialog box (figure 2) displays all program that are registered in the GUI. The programs are not all necessarily registered with Legion. From the dialog box you can select a program and call up its single host dialog box. You can also delete a program.
Figure 2: Registered program list dialog box

Each entry in the list represents a single GUI registration. The entry format is:

source <program file name>: program description
The individual components are as follows:
sourceEither L for Legion or U for user. This indicates that the program's path is Legion context space or local storage space.
program file nameThe program file name.
program descriptionA title assigned to the program in the Program Title field in the single host dialog box.

4.1. Displaying a single host specification

To call up a program's GUI registration, either select the desired program and then click the Display button or double-click the program listing. A single host dialog box with the GUI registration information will appear.

4.2. Removing a single host specification

To remove a program, select the desired program and then click the Remove button. This remove the GUI registration from the GUI cache and the GUI storage in Legion. The registration information will not be available in the current or future sessions. However, the program itself is not deleted from either Legion or local storage. If this program was previously registered in Legion, it will still be registered and can still be run from the command line.

Other relevant on-line documents:
Click on the to go to the page.
Logging in to a running Legion system
Introduction to Legion context space
Context-related commands
Legion tty objects
Running a PVM code in Legion
Running a Legion MPI code
Running native MPI code
Quick list of all 1.7 Legion commands
Usage of all 1.7 Legion commands
FAQs for running programs in Legion
Starting a new Legion system
Legion security
Legion host and vault objects
Adding host and vault objects
Brief descriptions of all on-line tutorials

Last modified: Mon Apr 24 15:58:41 2000


[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]