The parameter passed to the coldStart() method is just a
mapping from String names to Property objects. These
String/Property entries are gathered from several
sources, including the creation of the launch descriptor XML (Section ![[*]](crossref.png) ):
):
- The string plugins will be mapped to whatever string was specified
as the -plugins parameter. This entry is listed in the launch
descriptor.
- The string name will be mapped to a default name for the first
manager netlet, and is set by Beatrix. This entry is listed in the
launch descriptor.
- Other String/Property entries can be specified in
the launch descriptor XML. Each entry will have the name, allowed
PropertyType, whether it is required, and a possible default
value. Those required entries without a default value must be specified
in the console's run command. Those entries with a default
value may optionally have that value overridden in the console's run
command. Any entry not explicitly specified in the launch XML cannot
be entered with the run command. Jtrixmaker can be used to
set these other string/property values.
- The launch descriptor's config element is a BeatrixApplicationDescriptor
object. This also contains String/Property pairs
which are copied into the IPropertyCollection parameter of
coldStart(). Two are set by default: debug and debug-no
are both long values set to zero. See Section ![[*]](crossref.png) for more on these. for more on these.
- If the same string name is set both in the BeatrixApplicationDescriptor
and the launcher command line, then the command line takes precendence.
For example when we use the run command we can append debug={long:-1}
to switch on maximum debug output (Section ![[*]](crossref.png) ). ).
Nik Silver
2002-03-09