<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>pvm_config</TITLE>
  <TYPE>Scilab function</TYPE>
  <DATE>May 1998</DATE>
  <SHORT_DESCRIPTION name="pvm_config"> sends a message</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>res =  pvm_config()  </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>res</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>list of 7 elements such that:</SP>
          <PARAM_INDENT>
            <PARAM_ITEM>
              <PARAM_NAME>(1)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:
     integer returning the number of hosts (pvmds) in the virtual
     machine.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>(2)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:  integer returning the number of different data formats being used.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>(3)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:  integer returning pvmd task ID for host.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>(4)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:  character string returning name of host.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>(5)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:  character string returning architecture name of host</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>(6)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:  integer returning relative speed of host. Default value is 1000.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
            <PARAM_ITEM>
              <PARAM_NAME>(7)</PARAM_NAME>
              <PARAM_DESCRIPTION>
                <SP>:  integer status code returned by the routine.</SP>
              </PARAM_DESCRIPTION>
            </PARAM_ITEM>
          </PARAM_INDENT>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P><VERB>pvm_config</VERB> returns information about
    the present virtual machine. The information returned is
    similar to that available from the console command.</P>
    <P>
    The <VERB>pvm_config</VERB> function returns information about the entire
    virtual machine in one call.</P>
    <P>
    The returned value <VERB>res(7)</VERB>will be zero if 
    the call is successful and will be 
    will be &lt; 0 if some error occurs.</P>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[
if pvm_start()==0 then
    res = pvm_config()
    pvm_halt()
end
 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>pvm_start</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>pvm_tasks</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
</MAN>
