Define a Variable and Set its Value

$var_def varname value

This command defines a variable for use on a cover sheet, or for controlling IVR logic flow, for example in $type decision infoboxes. The variable will hide any variable of the same name defined in the configuration file with $var_def and will be hidden itself by any variable defined in an infobox (for example, with $set_var), or by any variable defined by a $var_def in an externally-generated FS file.

Variable names are limited to 32 characters and variable values to approximately 8000.

Writeable system variables listed in Appendix D cannot be set by this command; and the only effect will be to set a  control or user variable with the same name.

Defining a variable with a varname which starts BCF and is followed by a numeric value has a special purpose in a UJP file or an FFBC template file: list items are only selected for launch if they have the specified value in the corresponding BCF field on any such command.

The parameters on this command are used as follows:

varname the name of the variable to be defined.  Variable names starting with a numeric value (1 to 15) and a forward slash are reserved and indicate a member of a Variable Group.
value the value to be assigned to the variable, enclosed in double quotes if it contains embedded spaces.

This value is not expanded unless the first character is the variable expansion character (default @).  This variable expansion is intended for the special case when a double @@ appears at the start of the value.  In this case the value is expanded twice in the specific cases where:

the variable is to be copied to the MCF file and expanded again at the end of an incoming call.  For example @@ANI or @@FOIP_FROM can be copied to MCF $var_def commands in this way.

the variable name is DATA1 to DATA9 and is to be expanded again into the daily DBF log file at the end of an incoming call.  See this example.

The special variable value prefix character ^ (see the FS file $var_def command) has no special significance on this command in a USR or UJP file, but will be significant if the variable definition is copied into a broadcast FS file from a job instance UJP file.


$var_def appname "Sales Data"

$var_def extension "3323"

$var_def DATA6 @@ANI   ; place ANI in log DATA6 and in the MCF as DATA6

$var_def SIPFROM @@FOIP_FROM ; place From header in MCF as SIPFROM