|
$request_dir [CFG] |
  
|
|
$request_dir [CFG] |
|
Specify the Directories for Outbound Fax Requests
$request_dir dirname [count]
This command is used to name a non-standard directory and optional subdirectories that will be used to store outbound request files. CopiaFacts uses these directories to schedule outbound requests (FS files). Outbound FS files are generated automatically for fax-on-demand callbacks, or by the user using supplied client applications or broadcast launchers.
The parameters on this command are used as follows:
| dirname | a directory pathname naming the directory in which CopiaFacts will create TOSEND, SENT, FAIL, TEMP, PREPROC, POSTPROC and ACTIVE subdirectories. This pathname should be a UNC pathname. Note that system variables other than FFBASE are not expanded in this parameter. |
| count | the number of additional TOSENDx directories (1 to 9) which are used to prioritize outbound requests. The TOSENDx subdirectories are created if they do not already exist. Additional TOSENDx folders are required for broadcast operations. |
When a request is first created, CopiaFacts generates an outbound request (extension of .FS) file in a subdirectory named TOSEND within the request directory. A file named NEXTFS in this same directory is used to assign the next available number to the request. This number becomes the base filename of the request file. After a request has been sent, CopiaFacts removes the request from the TOSEND subdirectory and places it in the SENT subdirectory (also in the request directory) and updates the completion status. If CopiaFacts is unable to send the fax, it places the request in the FAIL subdirectory with a fail status in $fax_status2.
The optional numeric parameter count must have a value between 1 and 9 inclusive. The number represents the number of extra "to send" subdirectories to be used, which will be named TOSEND1 through TOSEND9 and also placed in the named request directory. These subdirectories would typically be used to contain FS files for broadcast operations. CopiaFacts considers these subdirectories to be extensions of the main TOSEND subdirectory and searches them in numeric sequence. The TOSEND subdirectory is the normal one used for caller requests (unless a value is assigned to the TOSEND system variable during the request) and is the only one to contain the NEXTFS control file.
The use of multiple subdirectories allows large broadcast jobs to be set up without disrupting urgent operations (such as fax-on-demand) by filling the main TOSEND subdirectory with large numbers of FS files. The Queues page of the COPIAFACTS Server program can be used to set blackout periods on individual TOSEND subdirectories.
Take great care when adding, deleting or changing this command on a live system. The system should be shut down at the time of the change, and while the CALLBACK folder tree is being moved to its new location.
Default: the CALLBACK folder in the CopiaFacts Application Data folder; all 9 TOSENDx folders.
Examples:
Specify the use of queue and control sub directories in the FAXFACTS\OUTBOUND directory. The directories (other than SENT) will be created if they do not exist:
$request_dir \\FFSERVER\COPIA\faxfacts\outbound
Specify the use of queue and control sub directories with TOSEND1 and TOSEND2 directories in the FAXFACTS\CALLBACK directory.
$request_dir \\FFSERVER\COPIA\faxfacts\callback 2
Topic url: http://www.copia.com/support/refmanual/index.html?$request_dir.htm