Specify per-node Variables and Values

$environment nodename varname "value" [start end days]

This command specifies variables which are to be applied to an individual CopiaFacts node. They are intended for use as replacements for values specified in the operating system program "environment", and to avoid the need to set such variables individually on each machine running the CopiaFacts engine. Most CopiaFacts utilities other than the engine make no use of the Windows environment variables and this command is not therefore used by them.

The values defined with this command override 'real' operating system environment variables for any of the purposes defined in Appendix G. When the variable is named in the context of a system variable, the variable defined on a $var_def configuration command takes precedence over a variables of the same name defined for the node on this command. Variables defined on this command are NOT passed in the environment to programs spawned from the engine (e.g. INTERNAL preprocess commands), and are not expanded when environment variables are to be expanded using the special %varname% syntax supported in some places.

The environment variable FFTRC is used before the configuration file is read, so any value set for it on this command is ineffective.

The parameters on this command are used as follows:

nodename The name of the CopiaFacts node (e.g. M1). Use * to specify a variable for use on all nodes.
varname the name of the variable to be defined.
value the value to be assigned to the variable, enclosed in double quotes if it contains embedded spaces. Note that system variables other than FFBASE are not expanded on this command.
start the time at which the specified assignment is to be enabled, formatted as HH:MM.
end the time at which the specified assignment is to be disabled, formatted as HH:MM.
days a string of numbers indicating the days to be scheduled, with Sunday=1.

The optional start, end and days parameters override the value of the variable during the specified schedule period(s). If more than one schedule period is active for a particular variable, the first specified takes precedence; however a variable specification without any schedule period is always overridden, even if it precedes scheduled entries for the same variable. Schedules are always enabled for periods of quarter of an hour, and any time specified within a quarter hour enables the schedule for the whole quarter of an hour. So for example a start time of 16:05 would actually start at 16:00 and an end time of 17:10 would actually end at 17:15. You will therefore find it simplest to specify all times as exact multiples of 15 minutes. You may use up to 64 variable definitions with time specifications.


$environment M1 SVP "\\MASTER\COPIA\faxfacts\specialvox"

$environment * FFTIMESERVER "\\MASTER"

$environment * MyFaxSendLine "1-24" 09:00 17:00 23456

$environment * MyFaxSendLine "1-48"