Specify Filename of Broadcast List
This command is use to specify the name of a broadcast list, and also to select whether items from that list are to be included in a specific broadcast.
Currently the following list types are supported:
|.TLS, .TAB, .TXT||The list is an ASCII file in which fields are delimited by TAB characters. Because of the variability of CSV specifications, we strongly recommend the use of this type of ASCII file in preference to those with other delimiters.|
|.XLS/XLSX||The list is in the first or only worksheet of an Excel file. The default is now set to use a custom interface in CF8EXCEL.DLL to read Microsoft Excel files, so that Excel is no longer required to be installed on the machine that is using the list to launch a job. See also the Using Excel Files topic for details of worksheet selection options.|
|.DBF||The list is in a standard dBase DBF file.|
|.LST, .CSV||These extensions, and any others apart from the those listed above, denote an ASCII file in which fields are delimited either by the system-defined list-separator character or by a space. This means that fields containing embedded blank space must be enclosed in double-quotes. The list separator is that defined in Windows regional settings. If the list separator is '|' then blank space is not a separator character and double quotes are unnecessary. To prevent the use of a space as a delimiter in unquoted fields when other delimiters are defined, define NO_SPACE_DELIMITER to a non-empty value in job properties.|
Other ASCII-file extensions, as well as those shown above, may be forced globally to be processed as either CSV or TAB types by setting the FORCE_CSV and FORCE_TAB control variables in the configuration file. To vary the settings for individual owners, omit this $var_def from the configuration file and place it instead in SYSTEM.UJP and/or individual owner or jobtype properties.
The parameters on this command are used as follows:
|filename||The full pathname of the file to be used. Except in the presence of a $var_def command defining NO_LIST_GROUP as a non-empty value, a filename part starting with the word 'GROUP' is taken as the name of an ASCII file containing list pathnames, one per line.|
|OMIT||A keyword indicating that the list is to be excluded for the job instance (in an instance UJP only).|
There can be a maximum of 256 $listfile commands in an instance UJP file. Since the instance UJP file is built from the system, owner and jobtype UJP files, this limits the number of list files you can include in each.
Position Requirements: The sequence of the $listfile commands is significant since lists can be selected by sequence number in Job IVR. Lists can also be selected in custom IVR by assigning a string of 0/1 digits to the JOBLISTS system variable. See also the $job_options keyword 'abslist'.