|
$whitelist_phone [UJP] |
  
|
|
$whitelist_phone [UJP] |
|
Phone White-List Checking
$whitelist_phone pathname [EmptyOK]
This command is used in a Job Administration UJP file to specify a white-list lookup file for use at launch time for phone items (fax, voice, poll, SMS). The command may also be placed in an FS Template file (.FST) for use in an FFBC launch. Multiple commands may be supplied, and commands from System, Owner and Jobtype UJP files migrate to the job instance properties in the usual way.
The advantages of the launch-time do-not-send and white-list commands are described in the Configuration topic and an overview appears in Lauch-Time Do-Not-Send Checking.
A match in the white-list file causes checking specified in the $dns_phone entries in the same file to be skipped. It also causes legacy do-not-send lookups at transmit time to be skipped.
The parameters on this command are used as follows:
| pathname | The pathname of the lookup file to be used. Currently supported file extensions are: |
| .NDX | a character- or numeric-mode index file created and maintained by the PIN utility. |
| .TXT | a list of entries to be matched |
| EmptyOK | A keyword which indicates that the index/list may be empty. This suppresses the check that ensures that at least one entry has been loaded from the file. Failure to load any entries could be a symptom of a corrupted file. |
Matches against a numeric NDX file or any TXT file are performed after removal of any leading zeros in the item checked and in the list.
The NDX file may contain a positive numeric data value for each entry, and the TXT file may contain a positive numeric data value separated from the phone number by a single TAB character. The default value is 1. The value will be saved as the value of a variable named WHITELIST_DATA in the launched FS file. This variable is used to cause legacy do-not-send checking at transmit time to be skipped.
When multiple commands are specified, items will be checked in the order of System, Owner and Jobtype entries and in the reverse sequence to that in which they appear in each file. In an FEB2 broadcast type (two list columns) a matched item will be prevent rejection even if fax transmission was specified to occur second.
Default: Do-not-send items will not be skipped.
Example:
$whitelist_phone @FFBASE\whitephone.ndx
Topic url: http://www.copia.com/support/refmanual/index.html?$whitelist_phone.htm