View Source

<span  id="index-0"></span><div  id="running-the-jobs">

<div >
<div >To start a job, ECF uses the content of the ECF_JOB_CMD <a  href="/wiki/display/ECFLOW/Glossary#term-variable"><em >variable</em></a>.</div>
<div >By modifying this variable, it is possible to control where and how a <a  href="/wiki/display/ECFLOW/Glossary#term-job-file"><em >job file</em></a> will run.</div>
<div >The command should be used in conjunctions with the <a  href="/wiki/display/ECFLOW/Glossary#term-variable"><em >variable</em></a> ECF_JOB and ECF_JOBOUT.</div>
<div >ECF_JOB contains the name of the file containing the <a  href="/wiki/display/ECFLOW/Glossary#term-job-file"><em >job file</em></a>, and ECF_JOBOUT contains</div>
<div >the name of the file that should contain the output.</div>
</div>
<div >
<p >Note</p>
<p >The default command ECF_JOB_CMD = %ECF_JOB% 1&gt; %ECF_JOBOUT% 2&gt;&amp;1 &amp;</p>
</div>
<div >
<div >Let us run the tasks on a remote machine. For that we could use the unix command rsh.</div>
<div >We would like the name of the host to be defined by an <a  href="/wiki/display/ECFLOW/Glossary#term-variable"><em >variable</em></a> called HOST.</div>
<div >We assume that all the files are visible on all the hosts, i.e. using NFS.</div>
</div>
<p>Modify the <a  href="/wiki/display/ECFLOW/Glossary#term-family"><em >family</em></a> f5 so that all its tasks will run on another machine in the classroom:</p>
<div ><pre># Definition of the suite test
suite test
 edit ECF_INCLUDE "$HOME/course"
 edit ECF_HOME    "$HOME/course"
 limit l1 2
 family f1
     edit SLEEP 20
     task t1
         meter progress 1 100 90
     task t2
         trigger t1 eq complete
         event a
         event b
     task t3
         trigger t2:a
     task t4
         trigger t2 eq complete
         complete t2:b
     task t5
         trigger t1:progress ge 30
     task t6
         trigger t1:progress ge 60
     task t7
         trigger t1:progress ge 90
 endfamily
 family f2
     edit SLEEP 20
     task t1
         time 00:30 23:30 00:30
     task t2
         day  sunday
     task t3
         date 01.*.*
         time 12:00
     task t4
         time +00:02
     task t5
         time 00:02
 endfamily
 family f3
     task t1
         label info ""
 endfamily
 family f4
     edit SLEEP 2
     repeat string NAME a b c d e f
     family f5
         repeat integer VALUE 1 10
         task t1
             repeat date DATE 19991230 20000105
             label info ""
     endfamily
 endfamily
 family f5
     edit HOST ??????
     edit ECF_JOB_CMD "rsh %HOST% '%ECF_JOB% &gt; %ECF_JOBOUT% 2&gt;&amp;1 &amp;'"
     inlimit l1
     edit SLEEP 20
     task t1
     task t2
     task t3
     task t4
     task t5
     task t6
     task t7
     task t8
     task t9
 endfamily
endsuite</pre>
</div>
<p>In python modify the function create_family_f5() created in the earlier page:</p>
<div ><div ><pre><span >#!/usr/bin/env python2.5</span>
<span >import</span> <span >os</span>
<span >import</span> <span >ecflow</span>

<span >def</span> <span >create_family_f5</span><span >()</span> <span >:</span>
    <span >f5</span> <span >=</span> <span >ecflow</span><span >.</span><span >Family</span><span >(</span><span >&quot;f5&quot;</span><span >)</span>
    <span >f5</span><span >.</span><span >add_inlimit</span><span >(</span><span >&quot;l1&quot;</span><span >)</span>
    <span >f5</span><span >.</span><span >add_variable</span><span >(</span><span >&quot;HOST&quot;</span><span >,</span><span >&quot;??????&quot;</span><span >)</span>
    <span >f5</span><span >.</span><span >add_variable</span><span >(</span><span >&quot;ECF_JOB_CMD&quot;</span><span >,</span><span >&quot;rsh %HOST% &#39;</span><span >%E</span><span >CF_JOB% &gt; </span><span >%E</span><span >CF_JOBOUT% 2&gt;&amp;1 &amp;&#39;&quot;</span><span >)</span>
    <span >f5</span><span >.</span><span >add_variable</span><span >(</span><span >&quot;SLEEP&quot;</span><span >,</span><span >20</span><span >)</span>
    <span >for</span> <span >i</span> <span >in</span> <span >range</span><span >(</span><span >1</span><span >,</span><span >10</span><span >):</span>
        <span >f5</span><span >.</span><span >add_task</span><span >(</span> <span >&quot;t&quot;</span> <span >+</span> <span >str</span><span >(</span><span >i</span><span >)</span> <span >)</span>
    <span >return</span> <span >f5</span>
          
<span >defs</span> <span >=</span> <span >ecflow</span><span >.</span><span >Defs</span><span >(</span><span >&quot;test.def&quot;</span><span >)</span>
<span >suite</span> <span >=</span> <span >defs</span><span >.</span><span >add_suite</span><span >(</span><span >&quot;test&quot;</span><span >)</span>
<span >suite</span><span >.</span><span >add_variable</span><span >(</span><span >&quot;ECF_INCLUDE&quot;</span><span >,</span><span >os</span><span >.</span><span >getenv</span><span >(</span><span >&quot;HOME&quot;</span><span >)</span> <span >+</span> <span >&quot;/course&quot;</span><span >)</span>
<span >suite</span><span >.</span><span >add_variable</span><span >(</span><span >&quot;ECF_HOME   &quot;</span><span >,</span><span >os</span><span >.</span><span >getenv</span><span >(</span><span >&quot;HOME&quot;</span><span >)</span> <span >+</span> <span >&quot;/course&quot;</span><span >)</span>

<span >suite</span><span >.</span><span >add_limit</span><span >(</span><span >&quot;l1&quot;</span><span >,</span><span >2</span><span >)</span>
<span >suite</span><span >.</span><span >add_family</span><span >(</span> <span >create_family_f5</span><span >()</span> <span >)</span>
</pre></div>
</div>
<p>You have to replace the string ?????? with a host name of your choice.</p>
<div >
<p >Note</p>
<p>The environment you get when submitting tasks remotely is different from that when submitting locally.
This depends on how your system is set up. Here we need to set PATH, to allow <a  href="/wiki/display/ECFLOW/Glossary#term-child-command"><em >child command</em></a>&#8216;s to be used.
So add the following line into your <a  href="/wiki/display/ECFLOW/Getting+Started#head-h"><em>head.h</em></a> file before the call to <a  href="/wiki/display/ECFLOW/Glossary#term-ecf-client"><em >ecf_client</em></a> &#8211;init</p>
<p >&gt; export PATH=$PATH:/usr/local/bin</p>
</div>
<div >
<div >You may experience other problems using rsh, caused by standard unix issues.</div>
<div >Make sure that the file $HOME/.rhosts contains a line with your user ID and</div>
<div >the machine where your server is running.</div>
</div>
<p>If your login shell is csh, you should define ECF_JOB_CMD as:</p>
<div ><pre>edit ECF_JOB_CMD "rsh %HOST% '%ECF_JOB% &gt;&amp; %ECF_JOBOUT%'"</pre>
</div>
<p>What to do:</p>
<ol >
<li>Change the <a  href="/wiki/display/ECFLOW/Glossary#term-suite-definition"><em >suite definition</em></a></li>
<li>Load and begin the <a  href="/wiki/display/ECFLOW/Glossary#term-suite"><em >suite</em></a></li>
<li>It may not work immediately. Have a look in the file <tt ><span >$HOME/course/</span><em><span >host</span></em><span >.</span><em><span >port</span></em><span >.ecf.log</span></tt> to see why.</li>
<li>What do you need to do in order to have the task <strong>/test/f5/t9 run</strong> on even another machine? Try your solution.</li>
</ol>
</div>