Apply 'Approval' Annotations to Fax Document

APPLYGCT imagefile outputfile gctfile boxoffset [parm1 parm2 ... parm9]
APPLYGCT filename.MCF [parm1 parm2 ... parm9]
APPLYGCT filename.FS  [parm1 parm2 ... parm9]

This program is intended to fit into a system of approving inbound and outbound faxes, although it can also be used to apply any GCT file to any faxable document.

The first form of the command takes a faxable imagefile as a watermark file and applies the annotations from gctfile.  The output file is given the same name as the input file and the extension of the original file is changed to .bak.tif.

The boxoffset parameter is a value (expressed as high-resolution scan lines, 196 per inch) which determines how the annotations are applied to the pages. A positive value (for example, 49) causes a quarter-inch blank strip to be added to the document at the top, before the annotations are applied. A negative value (for example, -49) causes a quarter-inch strip to be cleared at the top or the incoming document, before the annotations are applied. A value of zero simply applies the annotations directly to the incoming page.

Up to nine value parameters may be specified to be used in expanding variables in the GCT text.  The nine parameters can be referenced by using variable names @PARM1 to @PARM9.  In addition the following variables are available for expansion:

Configuration file $var_def commands

@FFBASE, @FFREQ, @FFPO, @FFUSER, @FFJOBS
@DATEx
@TIMEx
@CALLDATEx
@CALLTIMEx
@DOW
@COUNT_0
@COUNT_1
@PFC

When specified with a .MCF filename, APPLYGCT uses the values of variables GCT_ACCEPTIN, GCT_REJECTIN, OFFSET_ACCEPTIN and OFFSET_REJECTIN, defined on $var_def lines in the configuration file, to specify the gctfile and the boxoffset parameters for the operation.  The document file is taken as the value on the $message_file command in the MCF.  Variables defined with $var_def in the MCF are also available for expansion. The decision on whether to use the 'accept' or 'reject' values is based on whether an ASSIGN_TO variable appears in the MCF.  This variable will have been inserted by FFVIEWER operating in 'Accept' mode.

When specified with a .FS filename, APPLYGCT uses the variables GCT_ACCEPTOUT, GCT_REJECTOUT, OFFSET_ACCEPTOUT and OFFSET_REJECTOUT, defined on $var_def lines in the configuration file, to specify the gctfile and the boxoffset parameters for the operation.  The document file is taken as the value on the first $fax_filename command in the FS; only a single document is processed.  Variables defined with $var_def in the FS are also available for expansion, as are OC_CODE, OC_DESC, OC_DATE, OC_TIME, OC_CLASS and OC_CLDESC. The FS_FILE1 variable is set to the document filename.  The decision on whether to use the 'accept' or 'reject' values is based on whether the outcome code in $fax_status2 is 126.  This value will have been inserted by FFVIEWER operating in 'Accept' mode.