Technical information

DIAL STRING CONVERSION
105
If LocalNumLen + AreaCode < D, then the dial string is an international telephone number, except if the dial
string is in a long distance access format.
Once it is determined which type of telephone number the dial string represents, dial string variables are prepended
or appended to the dial string as shown on this chart.
Long Dist
Prefix
Dial
Prefix
Intl
Prefix
Intl
Access
LongDist
Access
Dial
String
Dial
Suffix
Intl
Suffix
Long Dist
Suffix
Intl.
X Loc. X
X X Non-Loc. X
X X Intl. X
For example, if the dial string is determined to be a long distance number, the dial string conversion function will
prepend the values of LongDistPrefix and LongDistAccess to it and append the value of LongDistSuffix to
it.
Final dial string conversion
In addition to the dial string conversion described so far in the section, supplementary dial string conversion can be
performed by using the dialcvt.lst file. The purpose of the dialcvt.lst file is to accommodate the dynamic
telephone service standards being supplied by providers in theUnited States. Although these additional dial string
conversion features were developed to meet the needs of VSI-FAX users in the United States and the different levels
of phone service available from providers in different U.S. states, they may also be appropriate for use by any users
in similar environments.
Use of the dialcvt.lst file is optional. As installed, the dialcvt.lst file is located in the $VSIFAX/lib
directory. It contains sample entries that have been commented out and are therefore not active. To make use of the
special dial string conversion features that can be implemented with the dialcvt.lst file, edit this ASCII file with a
standard text editor.
Legacy dial string conversion
In versions of VSI-FAX before version 5.1, there was a custom dialstring conversion file, dialcode.lst, located in
the $VSIFAX/lib directory. It is still supported in the current version of VSI-FAX, although the conversion settings in
this file will be ignored if there are any settings in the new dialcvt.lst file.
If you plan to convert your dialstring converstion settings from the old dialcode.lst file to the new dialcvt.lst
dialstring conversion file, please note that use of an externally-supplied conversion routine and the ability to specify
whether to exit the routine immediately upon a match are not supported in the new conversion method.
Testing your dial string conversion
Esker provides a dial string conversion testing program called vdialcvt. You can use this program to test your dial
string conversion setup and determine whether it is correct.
Once you have configured the variables in vsisrv.ini to perform the desired dial string conversion, test the
conversion of several sample dial strings with vdialcvt.
Note
Your exact and complete dial string conversion setup is emulated by vdialcvt, including both the vsisrv.ini
settings and any entries in the dialcvt.lst file. If DialConvert is set to off in the vsisrv.ini file, any dial strings
input to vdialcvt will remain unconverted. If DialcvtProgram is set to a custom program name in the vsisrv.ini
file, vdialcvt will run that program.