Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

ecFlow makes heavy use of different kinds of variables. There are several kinds of variables:

  • Environment variables which that are set in the UNIX shell before the ECFLOW-programs start. These control the server, and client (CLI).
  • Internal variables: suite definition variables. These control serverservers, ecflow_ui, ecflowview and CLI.
  • Generated variables: These are generated within the suite definition node tree during job creation and are available for use in the jobs job file.

This chapter lists the generated and user-defined variables which have special meaning for ecFlow itself.
In an ecFlow script, ecFlow variables are written as text enclosed by a pair of %-characters (the editmicro-character.) As in C-format strings, if there are two %-characters together they are concatenated to form a single %-character in the job-file. For example, if you need to execute the UNIX date command "date +%d". For a job, you must enter it as "date +%%d" into the ecFlow file.
The default editmicro-character is character is defined when ecFlow is compiled. It is possible to configure the editmicro-character to character to be defined as a variable ECF_MICRO (see section 3.6). The default installation uses the %-character.
You can define variables in a suite definition file using the edit keyword. User-defined variables can occur at any node level: suite, family, or task. ecFlow also generates variables from the node name, the host on which ecFlow is running, the time, the date, and so on.

Anchor
inheritance
inheritance