NAME

       procschema - LAM process schema format

SYNTAX

       #
       # comment
       #
       <program> [$delay] [$inet_topo] [<arguments>]
       <program> [$delay] [$inet_topo] [<arguments>]
        ...

DESCRIPTION

       Most LAM/MPI users can disregard this page.

       A  process  schema  (once ambiguously called a configuration file) lists the programs that
       will constitute the LAM environment on a particular node.   It  drives  the  operation  of
       hboot(1).   LAM system developers will find process schemata very useful for debugging and
       for generating custom systems.  By convention these files begin with the prefix conf.

       The default process schema selected by lamboot(1) (conf.lam) contains  only  one  program,
       the  LAM  daemon (lamd).  A one program process schema makes the whole business of process
       schemata and hboot(1) rather redundant.  LAM can also be run in a de-clustered  mode  with
       the  daemon  reduced  to  a simple local message-passing server (the "kernel") and several
       system clients for network message-passing and remote  services.   This  form  of  LAM  is
       described in the process schema, conf.otb.

       The syntax is line oriented.  Comments begin with # and terminate with a newline.

       Process  lines  consist  of  a  filename, command line arguments, and possibly options and
       substitution variables.  The command line arguments are passed to the process when  it  is
       started.   The  process  options  control how the process is started.  Currently supported
       process options are:

       $delay        After starting the process, pause before starting the next process.

       Substitution variables are set by the tools that interpret the process schema  and  are  a
       way   of   customizing  the  process  at  runtime.   See  hboot(1).   Currently  supported
       substitution variables are:

       $inet_topo    typically, command-line arguments for LAM Internet datalink processes

       $rtr_topo     typically, command-line arguments for the LAM network information process

       The programs found in the LAM de-clustered  mode  process  schema,  conf.otb,  are  listed
       below.

       bufferd     Creates, kills, sweeps, and states buffers.
       bforward    Forward messages; helper for bufferd.
       died        Monitors for death of user processes.
       dli_inet    UDP/IP incoming connection to other nodes
       dlo_inet    UDP/IP outgoing connection to other nodes
       echod       Echoes messages; can be used to test nodes and links.
       filed       Serves file access.
       flatd       Provides symbolic access to node memory.
       kenyad      Controls and monitors processes.
       kernel      Coordinates local message-passing.
       loadd       Loads executable files onto nodes.
       router      Maintains network information.
       traced      Collects and transports trace data.

       Processes  are started in the order given in the process schema, and for LAM, the order is
       important.  In particular, the kernel must be first.

EXAMPLE

       The de-clustered debug mode LAM process schema is shown below:

       ##
       ## The kernel is listed first.
       ##
       kernel $delay

       ##
       ## daemons
       ##
       router
       kenyad
       dli_inet $inet_topo
       dlo_inet
       bufferd
       bforward
       loadd
       echod
       flatd
       filed
       traced

FILES

       $LAMHOME/etc/lam-conf.lamd        default process schema for lamboot(1), where $LAMHOME is
                                         the installation directory

       $LAMHOME/etc/lam-conf.separate    default process schema for hboot(1)

SEE ALSO

       lamboot(1), hboot(1)