The following operating system environment variables are used by CopiaFacts programs, drivers and utilities. However it is strongly recommended that you use instead the $environment configuration command in FAXFACTS.CFG which makes maintenance easier. For example, you could add to FAXFACTS.CFG:
$environment * COVERTMP "C:\FAXTEMP"
When a value is set in the Windows environment and on a $environment command the value on the $environment command, even an empty value, overrides the Windows environment value.
If you use Windows environment variables, you should set these using the "system variables" part of the system advanced properties dialog, not the "user variables" part.
Variables shown in red below may affect specific programs only and must be set in the Windows system environment.
Some CopiaFacts components support expansion of external variables containing references in the form %varname%. Such references only match variables in the Windows environment, not those on a $environment command.
In the list below, variables affecting only one CopiaFacts component are indicated with the component name (CF indicates the COPIAFACTS engine).
ACTIVE
If set to a directory, then the active files will be placed in this directory, not in the ACTIVE subdirectory of the $request_dir directory. You may wish to choose an alternate location to improve network performance. The directory must be accessible to all network machines running COPIAFACTS or other CopiaFacts programs, and this variable must be set identically on all machines. Avoid changing this variable while CopiaFacts programs are running. If you set ACTIVE using a $environment command, it must apply to all nodes and have no day/time overrides.
ACTIVE_WORK
This special value enables the use of an enhanced method of finding FS files. No ACTIVE lock files are required. This parameter affects all nodes, and must not be changed while any COPIAFACTS instances are running.
This variable controls checking that the BladeWare service is running at COPIAFACTS start-up. If the channels are started before the BladeWare service is running, COPIAFACTS will not be able to run. When no value is defined, the default value is NONE. This is a change from releases earlier than 8.3.1.294.
For this variable only, a Windows environment variable overrides a value on the $environment command.
The value of the variable may be set as follows:
NONE
This value will suppress the check that BladeWare is running. You should use this value if you are not running BladeWare as a service and instead using the StartOTF-CF.CMD batch file; or if you are relying on the Start-up Delay on the COPIAFACTS options tab to delay the start-up of the main part of the engine to give time for the BladeWare service to start.
When no check is done COPIAFACTS will be unable to run unless either the service is already running or the desktop start-up is complete.
WAITn (recommended)
With a value n in seconds, for example WAIT120, this setting assumes that the BladeWare service has been set to start automatically, and it will cause the start-up of the main part of the engine to wait for up to the number of seconds specified until a running BladeWare service has been detected. The start-up time will depend on the number of configured channels and varies from machine to machine, so you may need to experiment with timing a manual start of the service before setting a value. The timer does not start until after the Start-up Delay on the COPIAFACTS options tab has expired; you may be able to reduce this if it has been set, for an earlier release, long enough to allow the service startup.
A zero, missing or alphabetic value of n causes the wait to be skipped. The check is done at ten-second intervals so only multiples of 10 need be entered.
STARTn
With a value n in seconds, this setting will first initiate starting or restarting the BladeWare service, then perform the WAITn operation described above. The service is started using the OMA_BW task which is installed in the task scheduler by the CopiaFacts Server installer, to run OTFSTART. This ensures that the service can be started even when COPIAFACTS is not running elevated.
When the START option is used the BladeWare service start-up should not be set to Automatic. The service should be set to manual if COPIAFACTS will be starting it. Also the supplied OMACKBW.CMD would need to be modified not to start BladeWare if the START option is used.
$environment M1_1234 BLADEWARESERVICE WAIT120
BNFAXL
Sets the number of (low-resolution) scan lines in an ASCII text page sent from a Brooktrout fax board/port. Default 1143.
$environment * BNFAXL 1076 ; US Letter
BUGREPORT_FREEZE_SECONDS This variable controls the time in seconds before a bugreport will be generated, and the program terminated, if the COPIAFACTS main thread freezes. This is a rare condition which can sometimes occur when a call to a board or port interface does not return. The recommended value is 30, but the default is 0, which suppresses the monitoring.
$environment * BUGREPORT_FREEZE_SECONDS 30 ; check for freeze
BWSIP_CCR_COUNT
Saves the BladeWare CCR count, set for the node in OTFCONFIG.
CFCONNECT
No longer supported.
CF_SUPPRESS_INFO
This variable is no longer available in CopiaFacts v9 because potential delays in reporting the system information have been eliminated.
CF_UPDATE_LINKS
[CVSINGLE] When set to a value between 0 and 3, causes Excel conversions to apply this value to the Update Links option parameter on a file open in Excel automation. If omitted, 0 is used.
These variables are described in Appendix D. The values on the $environment commands for the node (set by OTFCONFIG) are overridden by any defined variables of the same name.
COPIACONNECTINIPATH
Contains an override pathname for the local configuration file normally stored as ProgramData\Copia\CopiaConnect.ini. See Advanced Configuration Features for more information.
COUNTRY_PREFIX
Can be set to override the default value of 011 when using the CFUTIL PIN program to add phone numbers to a do-not-send file. This variable only affects PIN; use $country_prefix to specify an override while checking do-not-send numbers.
COVERTMP
If set to a directory, then the cover sheet files generated from the template at call time will be placed in this directory, not the $request_dir directory or the Job Owner temporary directory. You may wish to choose an alternate location such as a local disk to improve network performance. This variable affects both ASCII and Graphical Cover Sheet files generated at call time.
$environment * COVERTMP c:\faxtemp
CVSDELAY
[CVSINGLE] Defines a number of milliseconds for which CVSINGLE will wait before terminating.
CVSINGLE_OPEN_TIMEOUT
[CVSINGLE] When defined as a numeric value from 1 to 90, specifies the timeout value in seconds when CVSINGLE opens a Word or Excel document, or a WordMerge Datasource file. The default value is 10 if this environment variable is not defined. This feature is intended to catch documents which cause a pop-up to be displayed on opening, for example a password request, which blocks the document conversion. To suppress file-open monitoring, set this value to 0. For document converter applications, this value can also be overridden by a CVSINGLE_OPEN_TIMEOUT variable in the FS file.
CVT_GLOBAL_NAMESPACE
When defined as a Windows system environment variable with a non-empty value, this will cause the communication between CVSINGLE and FFCVRT to use object names in the Global Namespace. This is needed when an application runs CVSINGLE in a separate session, for example when it is called from a web service. You should reboot your system after changing this setting. This value need not be set when working with COPIAFACTS and FFEXTERN in service mode.
CVT_LOCAL_COPY
Can be set to the name of a local folder to which CVSINGLE will copy the merge master document of a Word Merge operation if the local copy is not already present or if it has an earlier timestamp. You must arrange to delete such copies after the job is complete using a utility such as DELETEOLDER. The folder is created if it does not already exist. If the copy fails, the original document file will be used.
[FFEXTERN, CVSINGLE] A string of option letters can be specified which are used as if they had been specified as CVSINGLE command-line options.
$environment * CVTOPTS "Q" ; selects built-in PDF converter $environment * CVTOPTS "KUVW" ; use Office-defined page size
DEFAULT_CONVERTER_PAGE
[CVSINGLE] Assigning a valid keyword or number from the table in the Printer Driver topic will define the default Copia Fax Converter paper size, used when variable CONVERTER_PAGE is not defined and when the setting has not been taken from the original document. If this environment variable is not set, the default is Letter in the USA locale and A4 elsewhere.
[CVSINGLE] Assigning one of the values '200x200', '204x196' or '204x98' to this variable will define the default Copia Fax Converter resolution, used when variable CONVERTER_RES is not defined. If this environment variable is not set, '200x200' is the default.
$environment * DEFAULT_CONVERTER_RES "204x196"
DIVA_EXTENSIONS
When set to a non-zero value, this enables support for superfine and ultrafine fax formats on Diva boards.
DIVA_OFFERED_SCANCOUNT
This variable controls the number of times (between 1 and 10, default 1) the system scans (at average 500ms intervals) to find an available channel on an incoming call. This may be needed on a fully-loaded system handling inbound calls, when the CO offers a new incoming call before the Diva channel recovers following the dropping of an earlier call. Careful tuning of this variable may be needed: set too high, more calls may be lost than are occasionally rejected when no channel is available.
DIVA_Q931
A non-empty value in this variable causes outcome codes for dial failure on a Diva board to be reported as a Q.931 cause value plus 6000 instead of the default outcome code plus 8700. Open CF9.SMR in Notepad or COPIAEDIT to show the actual values and meanings. This affects only dialing outcome codes, not fax transmission outcome codes.
DNSUPD_LOG
Set to a full path name to override the log file created by DNSUPD. A value of none suppresses the log.
DTI1
Set to any non-empty value to indicate in a Dialogic system that only the first span on a dual-span telephony board is to be used.
EICON_DELAY
Set to a value in milliseconds (max 2000, default 5) to delay processing a Diva disconnect event.
EICON_NO_INBOUND
Set to a comma-separated list of board numbers, this variable forces the board to ignore incoming calls on the specified Diva boards.
FAX40BASER
Set to the value (0 or 1) for the page number base in fax reception on a Dialogic VFX/40 board.
FAX40BASET
Set to the value (0 or 1) for the page number base in fax transmission on a Dialogic VFX/40 board.
FAXFACTSDIR
Set to the full UNC pathname of the CopiaFacts Application Data folder, with a trailing backslash. In systems running with a system environment variable named CFCONNECT set to a value of Disable, the value of FAXFACTSDIR will be the mapped drive letter path. This environment variable may be useful in Windows batch/command files. The variable is set by SERCONF at installation time and updated if necessary by COPIACONNECT.
FAXFACTSDRIVE
Set to first two bytes (drive letter and colon) of the value of the FAXFACTSLOCAL variable (only set if the folder is local). This environment variable may be useful in Windows batch/command files. The variable is set by SERCONF at installation time and updated if necessary by COPIACONNECT.
FAXFACTSLOCAL
Set to the full local pathname of the CopiaFacts Application Data folder, with a trailing backslash, if this folder is local. Otherwise the variable will not be set. This environment variable may be useful in Windows batch/command files. The variable is set by SERCONF at installation time and updated if necessary by COPIACONNECT.
FAXMSG
Set to a directory specification to be searched for CopiaFacts FAXMSG.n voice messages and for FAXFACTS.DIG, FAXFACTS.AMT, FAXFACTS.ABC and FAXFACTS.RST multiple-segment voice files. Multiple directories may be separated by semi-colons in the manner of the PATH command. These directories, if specified, are searched after the directories named in the user profile command $vmsg_dir. and after those of the SVP environment variable. If any of the folder names contain the string 'WAV', then the multiple-segment voice files will be taken to be the wave versions (for example FAXFACTW.DIG).
FF_BTCALL_1034_PATH
Specifies a local position for the BTCALL.CFG file in a Brooktrout system which requires different CFG settings for different nodes. This overrides the default of looking for this file first in the location specified in the BostonService registry entries and then in the Boston\BIN folder.
FF_LOCAL_LOG
Specifies a local log directory for the DBF log file written on a specific CopiaFacts machine, overriding the $log_def command. Note that the position of the OMA files is not affected by this variable.
FF4EXIT#
If set to a non-empty value then entering a # more than once at Standard Voice Prompt 4 will cause CopiaFacts to end the call.
FFEXTERN_ADJUST_LIMIT
[FFEXTERN] Can be set to the numeric value of a limit on Document Converter future-dated source files for which the output file time stamp is adjusted, after which the FFEXTERN OMA file will stop being updated. The problem usually manifests itself when the computer time has drifted relative to other network machines and will result in outcome 129 errors if not corrected and the discrepancy reaches five minutes.
FFEXTERN_ADJUST_REPORT
[FFEXTERN] Can be set to a numeric value N to cause a report in the FFEXTERN OMA file on every Nth occasion when a time-adjustment (see FFEXTERN_ADJUST_LIMIT) is done.
FFEXTERN_CONSECUTIVE_ERRORS
[FFEXTERN] Can be set to the numeric value of a limit on Document Converter consecutive errors, after which the FFEXTERN OMA file will stop being updated.
FFEXTERN_QUEUE_ERRORS
[FFEXTERN] Can be set to the numeric value of a limit on Document Converter errors reading the Preprocess Queue, after which the FFEXTERN OMA file will stop being updated.
FFEXTERN_TIMEOUTS
[FFEXTERN] Can be set to the numeric value of a limit on Document Converter timeouts, after which the FFEXTERN OMA file will stop being updated.
FFTIMESERVER
No longer used: use an external timeserver instead.
FFTRC
Set to a directory name to be used for CopiaFacts trace files (*.TR?) and FFTRACE trace files. This allows such files to be written to a local drive to minimize network traffic.
FORCE_FS_WRITE
Set to any non-empty value, this variable overrides and suppresses $delete_option keywords FAIL and SENT. It allows sites which use these options to temporarily override them to investigate problems, without needing to change applications which create FS files with these keywords. If you use this variable, make sure that the SENT and FAIL folders are present under CALLBACK. See also LOCAL_FS_COPY_PATH below.
FTPUPLOAD_FOLDER
[FTPUPLOAD] Setting a value of RELATIVE or ROOT causes the first folder element to be taken as being respectively relative to the login folder, or a root folder of the site. This overrides the -relFTPUPLOAD command-line option if different. The default is ROOT.
FTPUPLOAD_METHOD
[FTPUPLOAD] Setting a value of PASSIVE or ACTIVE specifies the FTP method. This overrides the -p FTPUPLOAD command-line option if different. The default is ACTIVE
FSLMACRO
If set to a non-empty value, variables will be expanded in the parameter on the $fax_send_channel / $fax_send_line command. This is rarely beneficial, because the expanded value will remain in place for subsequent attempts and will not be re-expanded.
FX_TEXT_EXT
[FFEXTERN] Allows the file extension to be overridden for the 'Text File' FFEXTERN special process.
GFAX
This variable is now deprecated. Please replace it with the $local_temp configuration command. Set to the directory name in which to create temporary files for the Fax Local Copy feature, this variable is now a required setting for all fax operations (originally it was used for GammaLink fax transmissions only). The folder specified here is also used for temporary cover-sheet files if the COVERTMP environment variable is not set. C:\FAXTEMP will be used (and created if necessary) if absent. If the local folder specified does not exist, it will be created, but if a network folder is specified, COPIAFACTS will not start.
GW_RECIP_LIMIT
[CFGATEWAY] To process more than one To: recipient in incoming messages, use a numeric value higher than the default value of 1, and not greater than 100. This permits users to send a fax to multiple recipients, with each recipient (e.g. faxnumber@fax.company.com) comma-separated on the To: line in their mail client. In this case the sender template option 'Only use a recipient matched in the message envelope' must also be checked. This option is intended to cause the only single recipient named on the SMTP command RCPT TO to be used in each message, but not all mail servers which send mail will be compatible with this approach. Before planning to receive e-mails with multiple recipients, read the linked section of the Gateway documentation.
The number specified may be immediately followed by a plus sign to signify that there may be a GW_RECIP_LIMIT variable to override this value in the sender template. This will cause the sender template to be read to check this for each incoming message.
$environment * GW_RECIP_LIMIT 1+
HTML_MARGINS
This environment variable provides a default for the MARGINS keyword in IMAGE_OPTIONS. The value should consist of four numeric values separated by forward slash characters, for example 10/60/10/60.
JOBADMIN_DELETION
[JOBADMIN] Set to a value of 'Allowed', permits potentially unsafe deletion of owners, jobtypes and job instances from JOBADMIN. For example: $environment * JOBADMIN_DELETETION "allowed"
JOBMON_SKIP
[JOBMON] Can contain a list of comma-separated folder names (excluding path) which are to be ignored by JOBMON during folder scans. If not defined, the list defaults to the single item TEMP.
LOCAL_FS_COPY_PATH
Can contain a local pathname which will contain a copy of each FS written to SENT or FAIL. When a path is set in this variable, a checkbox 'FS Copy' will appear on the CopiaFacts engine Options tab, which can be used to enable the file copies for temporary debugging purposes. See also FORCE_FS_WRITE above.
MAIL_DELETE_THRESHOLD
Set to the size in bytes of a received fax file above which it will not be deleted on a failed receive operation (default 200).
MAX_GDI_OBJECT_INCR
Set to a value (typically 500 or more) which will cause COPIAFACTS to restart if the Windows GDI Object count increases by more than this value. This works around a problem encountered with some fax modem drivers where Windows GDI Objects are not released. You can view the count by pressing Control-H in the COPIAFACTS application.
MAX_HANDLE_INCR
Set to a value (typically 1000 or more) which will cause COPIAFACTS to restart if the Windows handle count increases by more than this value. This works around a problem encountered with some fax modem drivers where Windows handles are not closed. You can view the handle count by pressing Control-H in the COPIAFACTS application.
MAX_VAR_SPACE
A value above 16 assigned to this variable in FAXFACTS.CFG specifies the buffer size (in approximate kilo-characters) for storing (multiple) variables for a single CopiaFacts command file in all CopiaFacts programs which load these files. It therefore limits the maximum size of an individual variable. The default is 32. The number of buffers used is limited by Windows memory available for the process. This differs slightly from the use of this variable in most CopiaFacts version 8 builds.
MAXRES_ACTION
[CVSINGLE] The variable controls the detection of errors when the resolution parameter of the Document Converter printer driver has been set to 300 by an errant application (this causes created TIF files to be non-faxable). A value of 1 will cause the conversion to fail if the registry value is 300. A value of 2 will reset the value to 204 if it is 300 (but will not fix the conversion just done). A value of 4 will add 100 to the 'consecutive errors' counter, effectively causing this to trigger, if the registry value is 300. The values in the variable are additive.
MINUTESLIMIT
Set to a small integer value greater than one, causes the timeout on no screen messages in the COPIAFACTS program to be extended. The default is to time out after 1 minute and then wait 15 seconds for a response to the pop-up message.
MOC_INSTALLED
[CVSINGLE] Set to a value of either YES or NO, this variable can be used to override the automatic detection of the presence of the Microsoft Office Compatibility pack. The compatibility pack allows the Copia Document Converter to handle Office 2007 documents with specific earlier releases of Office installed.
NEXTCALLNO_FOLDER
Can be set to a folder name to override the FAXFACTS\SYSTEM folder where the NEXTCALLNO file is located. Do not set this variable. It should only be used on advice from Copia support staff and with a full understanding of the implications.
NEXTMCF_FOLDER
Can be set to a folder name to override the FAXFACTS\MAIL folder where the NEXTMCF file is located. Do not set this variable. It should only be used on advice from Copia support staff and with a full understanding of the implications.
NO_JOB_LAUNCH
Set to a non-empty value, prevents an engine picking up a job workerbox FS file (jobbot) for actions 3 or 21. (Auto-launch after proof, and delay-launch). This may be necessary to avoid installing Excel on all nodes to process job lists, or to avoid installing Word to allow REMOVEDS to prepare a document for Word Merge. Do not set this variable for all nodes, otherwise these actions will never be processed.
NO_VOIP_KEEPALIVE
Set to a non-empty value to suppress keep-alive messages on Copia VoIP ports. In addition this suppresses the logging of incoming keep-alive messages in CF9SIP trace output.
NOIDLE
Set to a non-empty value to disable idle (sending a stream of silence) on a Dialogic DTI timeslot after dial.
Set to a non-empty value to set the CALL_NOT_END_TO_END_ISDN call progress option on a Dialogic PRI-ISDN channel.
OTF_..._MEDIA
These variables are set as environment variables by OTFCONFIG in FAXFACTS.CFG. See Appendix D and Media Preferences for details.
OTF_CONFIG_OMIT_ITEMS
Saves the BladeWare 'not needed' checkbox options for the node, set in OTFCONFIG.
OTF_OK_DELAY
Set to a value of 1, this variable affects BladeWare only. This is a temporary solution to address an interoperability problem with some behaviorally atypical fax systems. Typically fax sessions will repeat early negotiations until a handshake is established. Field trials have shown that not all fax systems adhere to this industry standard practice. Symptoms of this behavior include frequent fax failures with error code FAX_OTF_T30ErrT1Timeout.
OTF_ROOT
Used by BladeWare to designate the base install folder. This is a Windows environment variable only.
PAD
Set to a non-empty value to force padding of ASCII files on a VFX/40 fax board.
PAGELENGTH
Set to a value of tenths of an inch to override the page length of ASCII files on a VFX/40 fax board.
POLLTIMEOUT
Set to a value in seconds to adjust the timeout for automatic detection of polling or manual receive operation with Dialogic boards. Set this variable only when requested by Copia technical support.
RDS_KILL_DELAY_MS
Set to a value in milliseconds, this extends the delay (default 2000ms) between closing the document and closing Winword.exe in REMOVEDS. If the delay is too short, the first operation may report an error.
RDS_START_DELAY_MS
Set to a value in milliseconds, this extends the delay (default 2000ms) between completing a wait for a previous REMOVEDS operation to finish and starting another. If the delay is too short, the second operation may report an error.
SUPPRESSORIGPDF
Sey to a non-empty value to suppress fallback to the original PDF renderer when PDFIUM conversion fails.
SVP
Set to a directory specification to be searched for CopiaFacts SVPn.VOX and SVPn.WAV voice messages and for FAXFACTS.DIG, FAXFACTS.AMT, FAXFACTS.ABC and FAXFACTS.RST multiple-segment voice files. Multiple directories may be separated by semi-colons in the manner of the PATH command. These directories, if specified, are searched after the directories named in the user profile command $vmsg_dir. If any of the folder names contain the string 'WAV', then the multiple-segment voice files will be taken to be the wave versions (for example FAXFACTW.DIG).
USE_ADOBESETP
Set to a non-empty value, this variable will cause the PDFSETP conversion option to be written as the keyword ADOBESETP (its former name in 8.2) on an output $convert_options USR, UJP or FS command. Both versions are accepted when reading this command.
USE_TIFCAT
When set to a non-empty value, causes COPIAFACTS to perform TIF concatenation during preparation of a fax transmission by spawning a CFUTIL TIFCAT process instead of concatenating within the COPIAFACTS process. This should only be needed if you expect to have to combine large multi-page faxes on systems handling many fax channels, for example when the variable definition XCAPI_COMBINE_FAXFILES is used. This will reduce the memory requirements of the COPIAFACTS process.
VOICETMP
Set to a local folder name to be used to save a temporary voice-format file resulting from processing a multi-segment voice file which has a sample rate of 6000 on a Dialogic Diva board. The default is the Windows temporary folder. This folder is not used if you use multi-segment files with 8k sample rates (such as the supplied WAV-format multi-segment files).
VOIP_INVITE_FAIL1
Set to a non-empty value, this variable will cause an error on provisioning a Copia VoIP port channel with the parameters for an outbound call to result in the CopiaFacts channel on which it occurs to be taken out of service. Normally the dynamically-created VoIP channel will be discarded and call will fail with outcome code 1498.
VOIP_INVITE_FAIL2
Set to a non-empty value, this variable will cause an error on creating a Copia VoIP port channel for an outbound call to result in the CopiaFacts channel on which it occurs to be taken out of service. Normally the dynamically-created VoIP channel will be discarded and call will fail with outcome code 1497.
VOIP_Q931
A non-empty value in this variable causes outcome codes for dial failure on an Copia VoIP port to be reported as a Q.931-equivalent cause value plus 6000 instead of a special code in the 1400 range. A special value of VOIP_SIP_RESPONSE in this variable causes the actual SIP response code to be saved in a variable named VOIP_SIP_RESPONSE, in addition to the Q.931 code as the outcome code.
WMTMP
[FFEXTERN] If set to a directory, then the temporary datasource files for a job which has job option WordMerge will be placed in this directory, not the same folder as the FS file. You may wish to choose an alternate location such as a local disk to improve network performance.
WORK_TYPES
Can be used on $environment commands only. The single value consists of one or more of the letters OEVM for outbound fax, e-mail, voice, and maintenance (worker) respectively. When set for a node, it is assumed that every channel in the node is configured for only the named outbound operations, and that every TOSEND queue enabled for the node will contain only work of the type(s) specified (or forced-fail FS files which can be handled on any channel). In addition no $fax_send_channel ($fax_send_line) commands must be used in FS to be processed by the node, and no $phone_mask should contain line-specific parameters. This allows a smarter method to be used to enhance finding FS files for the node.
XCAPI_DELAY
Set to a value in milliseconds (max 2000, default 5) to delay processing an XCAPI disconnect event.
$environment * XCAPI_DELAY 100 ; not normally needed
XCAPI_EXTENSIONS
This value is now set by default and the variable is ignored. When set to a non-zero value, this enables support for superfine and ultrafine fax formats on TE Systems ports. It also enables reporting of the fax media mode used for a transmission, in variable XCAPI_MEDIA_MODE.
XCAPI_OFFERED_SCANCOUNT
This variable controls the number of times (between 1 and 10, default 1) the system scans (at average 500ms intervals) to find an available channel on an incoming call. This may be needed on a fully-loaded system handling inbound calls, when the CO offers a new incoming call before the XCAPI channel recovers following the dropping of an earlier call. Careful tuning of this variable may be needed: set too high, more calls may be lost than are occasionally rejected when no channel is available.
$environment * XCAPI_OFFERED_SCANCOUNT 3
XCAPI_Q931
A non-empty value in this variable causes outcome codes for dial failure on an XCAPI port to be reported as a Q.931-equivalent cause value plus 6000 instead of the default outcome code plus 8700. Open CF9.SMR in Notepad or COPIAEDIT to show the actual values and meanings. This affects only dialing outcome codes, not fax transmission outcome codes.
$environment * XCAPI_Q931 yes
XCAPI_SDK_LOGFILE, XCAPI_SDK_LOGCODE
When these variables are set to a valid pathname and code respectively, The TE Systems SDK log file will be written. The code increases from 0 (no logging) to 8 (highest level of logging). Set these values only on the advice of Copia support.
Note that the value of any environment variable is also available in a .IIF file using the @varname syntax. You can also specify any environment variable name instead of the node name on the COPIAFACTS program options page, and if found in the environment the contents of the variable will be used as the node name.
