Specify Fax Mail Post-Receive Processing
This command is used to specify a post-receive action which is performed after a fax has been received in a fax-mail operation. The normal method of post-receive processing is now to specify an infobox method, in which control is transferred to an infobox sequence. This still allows an external program to be run, of course, but also provides a method of creating an FS file to forward the incoming fax for further processing.
The parameters on this command are used as follows:
|command||the name of an operating system command, program, or batch file that will be executed to initiate external post-receive processing; or an infobox name for infobox method processing; or a plugin name for FFEXTERN processing. A program or batch file name must have a file extension if its extension is not .EXE. Operating system commands should be preceded by CMD /c.|
|args||the arguments, if any, for command.|
|method||one of the following keywords:|
|internal||COPIAFACTS will invoke (spawn) the specified post-processing command with the program arguments listed below. If the pathname of the MCF file contains blank spaces, it will first be converted to its 'short' filename form (usually with embedded tilde characters). The five arguments are:|
The pathname of the mail directory (without drive letter and colon, nor the leading \\ of a UNC filename).
The MCF file filename (with leading zeros, without extension)
The received fax file extension (.TIF or .1)
Either the drive letter of the mail directory (with a colon), or \\ for a UNC filename.
The mailbox number (without leading zeros)
|Internal post-receive processing should be used for legacy applications only: to run a program with your own choice of parameters, use infobox post-receive processing to run a $type query infobox and execute a $run command.|
|infobox||for faxes received without error, control will pass to an infobox sequence, which MUST be terminated by a transfer to state IIF_PROC_COMPLETE (s191). Either $next_box or $chain can be used to transfer to this state.|
|infoboxall||for all faxes, control will pass to an infobox sequence, which MUST be terminated by a transfer to state IIF_PROC_COMPLETE (s191). Either $next_box or $chain can be used to transfer to this state.|
|FFEXTERN||post-receive processing will be performed by FFEXTERN (for example to print incoming faxes).|
|external||keyword to specify processing by a separate program.|
Infobox postprocessing can be used for operations such as calling an external DLL or program from an infobox. The user profile or user job properties file used to receive the fax must have one or more $script_locn commands to locate the infobox file(s). Your infobox logic must finish by transferring to state 191 (IIF_PROC_COMPLETE). Voice operations within your infobox sequence will be ignored, and transfer to any other state may cause unpredictable results. The PR_... system variables contain specific data pertaining to the active MCF file, but any valid system variables may also be used. Any program or DLL called from the infobox sequence should not attempt to modify the MCF file.
$post_receive postproc infobox