Rose Environment Variables§

COMMAND_INSTANCES
Description
Environment variable provided to Rose Bunch instances at runtime to identify the command instance being run.
Provided At Runtime By
  • Rose Bunch
NPROC
Description
Specifies the number of processors to run on. Default is 1.
Used By
ROSE_APP_COMMAND_KEY
Description
Can be set to define which command in an app config to use.
Used By
ROSE_APP_MODE
Description
Can be set to define which built-in app to run.
Used By
ROSE_APP_OPT_CONF_KEYS
Description
Each KEY in this space delimited list switches on an optional configuration in an application. The (KEY) syntax can be used to denote an optional configuration that can be missing. The configurations are applied in first-to-last order.
Used By
ROSE_BUNCH_LOG_PREFIX
Description
Environment variable provided to Rose Bunch instances at runtime to identify the log prefix that will be used for output e.g. for a bunch instance named foo then ROSE_BUNCH_LOG_PREFIX=foo.
Provided At Runtime By
  • Rose Bunch
ROSE_CONF_PATH
Description

If defined this will override the default configuration search path.

Provide a colon (:) separated list of paths to search for rose.conf files.

If set to an empty string no config files will be loaded.

Used By
See also
ROSE_SITE_CONF_PATH
Description
Defines the location of the “site” configuration. Configurations defined here can be overridden by the “user” configuration.
See also
ROSE_CYCLING_MODE
Description
The cycling mode to use when manipulating dates. Can be either 360day or gregorian.
Used By
Provided By
ROSE_DATA
Description
The path to the data directory of the running suite.
Provided By
ROSE_DATAC
Description
The path to the data directory of this cycle time in the running suite.
Provided By
ROSE_DATAC????
Description

The path to the data directory of the cycle time with an offset relative to the current cycle time. ???? is a duration:

  • A __ (double underscore) prefix denotes a cycle time in the future. Otherwise, it is a cycle time in the past.
  • PnM denotes n months.
  • PnW denotes n weeks.
  • PnD or nD denotes n days.
  • PTnH or TnH denotes n hours.
  • PTnM denotes n minutes.

E.g. ROSE_DATACPT6H is the data directory of 6 hours before the current cycle time.

E.g. ROSE_DATACP1D and ROSE_DATACPT24H are both the data directory of 1 day before the current cycle time.

Provided By
ROSE_ETC
Description
The path to the etc directory of the running suite.
Provided By
ROSE_FILE_INSTALL_ROOT
Description
If specified, change to the specified directory to install files.
Used By
ROSE_LAUNCHER
Description
Specifies the launcher program to run the prog.
Used By
ROSE_LAUNCHER_FILEOPTS
Description
Override [rose-mpi-launch]launcher-fileopts.LAUNCHER setting for the selected ROSE_LAUNCHER.
Used By
ROSE_LAUNCHER_LIST
Description
Specifies an alternative list of launchers.
Used By
ROSE_LAUNCHER_PREOPTS
Description
Override [rose-mpi-launch]launcher-preopts.LAUNCHER setting for the selected ROSE_LAUNCHER.
Used By
ROSE_LAUNCHER_POSTOPTS
Description
Override [rose-mpi-launch]launcher-postopts.LAUNCHER setting for the selected ROSE_LAUNCHER.
Used By
ROSE_LAUNCHER_ULIMIT_OPTS
Description

Tell launcher to run:

rose mpi-launch --inner $@

Specify the arguments to ulimit. E.g. Setting this variable to:

-a -s unlimited -d unlimited -a

results in:

ulimit -a; ulimit -s unlimited; ulimit -d unlimited; ulimit -a
Used By
ROSE_META_PATH
Description
Defines a metadata search path, colon-separated for multiple paths.
Used by
ROSE_NS
Description
Defines the rose namespace. Used to identify if a utility belongs to rose or rosie.
Used and Provided By
  • rose
ROSE_ORIG_HOST
Description
The name of the host where the cylc install command was invoked.
Provided By
ROSE_SITE

Deprecated since version 2.0.0: This variable is no longer available globally from Rose.

However, the Cylc-Rose plugin’s implementation of Rose Stem provides this variable.

ROSE_SUITE_DIR
Description
The path to the root directory of the running suite.
Provided By
ROSE_SUITE_DIR_REL
Description
The path to the root directory of the running suite relative to $HOME.
Provided By
ROSE_SUITE_NAME
Description
The name of the running suite.
Provided By
ROSE_SUITE_OPT_CONF_KEYS
Description
Each KEY in this space delimited list switches on an optional configuration when installing a suite. The (KEY) syntax can be used to denote an optional configuration that can be missing. The configurations are applied in first-to-last order.
Used By
ROSE_TASK_APP
Description
Specify a named application configuration.
Used By
ROSE_TASK_CYCLE_TIME
Description
The cycle time of the suite task, if there is one.
Provided By
ROSE_TASK_LOG_DIR
Description
The directory for log files of the suite task.
Provided By
ROSE_TASK_LOG_ROOT
Description
The root path for log files of the suite task.
Provided By
ROSE_TASK_N_JOBS

Warning

(Deprecated) Use the opt.jobs setting in the application configuration instead.

Description
The number of jobs to run in parallel in fcm make (default=4).
Used By
  • fcm_make built-in application
  • fcm_make2 built-in application
ROSE_TASK_MIRROR_TARGET

Warning

(Deprecated)

Description
The mirror target for the mirror step in the fcm-make.cfg configuration.
Provided By
  • fcm_make built-in application
ROSE_TASK_NAME
Description
The name of the suite task.
Provided By
Used By
ROSE_TASK_OPTIONS

Warning

(Deprecated) Use the args setting in the application configuration instead.

Description
Additional options and arguments for fcm make or rose app-run.
Used By
  • fcm_make built-in application
  • fcm_make2 built-in application
ROSE_TASK_PREFIX
Description
The prefix in the task name.
Provided By
ROSE_TASK_SUFFIX
Description
The suffix in the task name.
Provided By
ROSE_UTIL
Description
Used to identify which rose or rosie utility is being run.
Used and Provided By
  • rose
ROSE_VERSION
Description
The current version of Rose.
Provided by