Page History

ECF_KILL_CMD

Method to kill a running task. Depends on how the task was submitted via ECF_JOB_CMD.

ecFlow must know the value of remote-id (ECF_RID). Variable enables kill(CLI) command to be used.

Can use the generated variable %ECF_JOB%.kill for storing command output

No

rsh %SCHOST% qdel -2 %ECF_RID% > %ECF_JOB% 2>&1

ECF_JOB_CMD

Command to be executed to submit a job. May involve using a queuing system,

like NQS, or may run the job in the background.

Yes

%ECF_JOB% 1> %ECF_JOBOUT% 2>&1

"mkdir -p $(dirname %ECF_JOBOUT%) && ssh -v -o StrictHostKeyChecking=no %USER%@%REMOTE_HOST% ksh -s <%ECF_JOB% >%ECF_JOBOUT% 2>&1 &"

%SCHOST%submit %ECF_JOB%

ECF_STATUS_CMD

Command to be used to check the status of a submitted or running job.

Can use the generated variable %ECF_JOB%.stat for storing command output

No

'rsh %SCHOST% qstat -f %ECF_RID%.%SCHOST% %ECF_JOB% 2>&1'

ECF_URLCMD

Command to be executed to allow the user to view related web pages

No

${BROWSER:=firefox} -remote 'openURL(%ECF_URLBASE%/%ECF_URL%)'Where ECF_URLBASE is the base web address and ECF_URL the specific page.

ECF_HOME

The default location for ecFlow files if ECF_FILES is not used.

Yes

/tmp/ECF/$SUITE

The location for generated files.

These are the job-files and the job-output.

Setting this variable to a different directory to ECF_FILES enables you to clean up

all the files produced by running ECF.

ECF_TRIES

The number of times a job should rerun if it aborts.

If more than one and the job aborts, the job is automatically re-run by ECF.

Useful when jobs are run in unreliable environments.

For example, using commands like ftp(1) in a job can fail easily, but re-running the job will often work.

Yes

2

ECF_FILES

Alternate location for ecFlow files

No

/home/user/ECF/$SUITE

ECF_INCLUDE

Path for the include files.

No

/home/user/ECF/$SUITE/include

ECF_EXTN

Overrides the default script extension

Yes

.sms (default is .ecf)

ECF_DUMMY_TASK

Some tasks have no associated '.ecf' file.

The addition of this variable stops job generation checking from raising errors.

No

Any value is sufficient

ECF_OUT

Alternate location for job and cmd output files.

If this variable exists it is used as a base for ECF_JOBOUT but it is also used to search for the

output by ecFlow when asked by ecflow_ui/CLI. If the output is in ECF_HOME/ECF_NODE.ECF_TRYNO it is returned, otherwise ECF_OUT/ECF_NODE.ECF_TRYNO that is ECF_JOBOUT is used. Job

The job may continue to use ECF_JOBOUT (as in a QSUB directive) but should copy its own output file back into ECF_HOME/ECF_NODE.ECF_TRYNO in at the end of their run.

No

/scratch/ECF/

ecFlow pre-process character to be used by ecFlow pre-processor for variable substitution and including files.

Yes

%