Legion: A Worldwide Virtual Computer
Home General Documentation Software Testbeds Et Cetera Map/Search
 


NAME
    legion_make_hostlist  - create a context holding hosts for
                             running a class object, as with
                             legion_mpi_run's -h flag

SYNOPSIS
     legion_make_hostlist
      -h <host context> -f <file1> <file2> ... <filen>
      [<host context path>] [-v] [-help]


DESCRIPTION
     Creates a new context that contains a list of hosts that can
     be used to run a Legion class object, such as a Legion MPI
     program with legion_mpi_run(1). It reads the file(s) and/or
     host names provided in command-line parameters and 
     concatenates them into a new context in your current working 
     context. The new context contains links (via legion_ln) to
     the specified hosts.


PARAMETERS
     -h <host context>
          The name of the new context that you wish to create.
          It will be placed in your current working context.

     -f <file1> <file2> ... <filen>
          One or more local text files that contains context
          paths of hosts that you wish to include in the new 
          context.


OPTIONS
     The following options are supported:

      <host context path>
          The context path of a host that you wish to include in
          the new context. You can list as many host context
          paths as you wish.

     -v   Run the command in verbose mode.

     -help
          Print command syntax and exit.


EXAMPLE
     The example below will create a new context called "/myList"
     in the current working context. The new context will contain
     pointers to HostA, HostB, and any hosts listed in List1.txt.

          $ legion_make_hostlist -h myList -f List1.txt \


---------------

 NAME
       legion_add_sub_collection - adds a subcollection

 SYNOPSIS
       legion_add_sub_collection
        {-l <collection LOID> | -c <collection path> }
        {-l <member LOID> | -c <member path> } [-q <query>]

 DESCRIPTION
       
       This command creates a new parent-sub collection
       relationship. A subcollection is a collection object that
       is polled by another collection object (called the parent
       collection) with a specified MESSIAHS-type query (see
       legion_query_collection for details). If no query is
       specified, the default value of 'true' will be used. You
       can run this command multiple times to start multiple
       queries on a single subcollection.

       A parent collection can have more than one subcollection
       and can run multiple queries on a single subcollection. A
       subcollection can have more than one parent as well as its
       own subcollections.
       
       You must designate a parent collection (named in <collection
       LOID> or <collection path>). The member (named in
       <member LOID> or <member path>) is the
       subcollection. Both collections must already exist.

 NOTE
       Full path syntax can be used as well as relative path syntax.

 OPTIONS
       -q <query>
              A MESSIAHS-style query that will be run on the sub
              collection. The default selection is 'true'.

---------------

 NAME
       legion_remove_sub_collection - remove a subcollection

 SYNOPSIS
       legion_remove_sub_collection
        {-l <collection LOID> | -c <collection path> }
        {-l <member LOID> | -c <member path> } 
        [-q <query>]

 DESCRIPTION
       
       This command ends a parent-sub collection relationship.
       It does not destroy either collection. You must name the
       parent collection and the subcollection. If the parent
       collection is running multiple queries on the subcollection, 
       you can use the -q flag to stop a specific query (use
       legion_list_sub_collections to see which queries
       are running on which subcollections). Otherwise, all
       queries will be stopped.

 NOTE
       Full path syntax can be used as well as relative path syntax.

 OPTIONS
       -q <query>
              A MESSIAHS-style query that is being run on the
              subcollection. See legion_query_collection for
              details.

_________________________________

 NAME
       legion_list_sub_collections - list a parent collection's
                                     subcollections and queries

 SYNOPSIS
       legion_list_sub_collections
        {-l <collection LOID> | -c <collection path> }

 DESCRIPTION
       List a collection's set of subcollections and queries.
       
 NOTE
       Full path syntax can be used as well as relative path syntax.

Last modified: Fri Aug 4 17:10:00 2000

 

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

This work partially supported by DOE grant DE-FG02-96ER25290, Logicon (for the DoD HPCMOD/PET program) DAHC 94-96-C-0008, DOE D459000-16-3C, DARPA (GA) SC H607305A, NSF-NGS EIA-9974968, NSF-NPACI ASC-96-10920, and a grant from NASA-IPG.

legion@Virginia.edu
http://legion.virginia.edu/