Set Conversion Options for Document Converter

$convert_options keyword|exptime[H|D] [keyword ... ]

This command controls the default processing of retrievals in Document Converter operations. The command affects all outbound operations under the control of the USR or UJP file. It can be overridden by the same command in an FS file.  This command replaces the now-deprecated $web_options command.

In $convert_options commands in an owner or jobtype UJP file only, an option keyword can be preceded with a tilde (~) character to indicate that a higher-level option is to be deleted. This feature is not available in system convert options because there is no higher level to affect, and is not available in job instance convert options because these will have already been distilled from system, owner and job type convert options when the job instance UJP file was created.  The tilde is not valid on FontSize or Timeout keywords, preceding the expiry time, or when the $convert_options command is placed on an $fs_template command. In these cases the multiple keywords will override each other in the usual hierarchy.

These commands are added to any option letters added as CVSINGLE command-line switches (for single conversions) and any option letters in the or CVTOPTS environment variable value (for all conversions).  Note that some option letters may set multiple options: for example X selects Libre Office for all types of Office Documents, whereas OODOCX selects it only for Word documents.

The parameters on this command are used as follows:

keyword One of the following keywords ([x] indicates the corresponding CVSINGLE or CVTOPTS option letter):
AdobeSETP[K] When specified for an Adobe conversion, adjusts the paper size in printer preferences to match the page size of the first page. See Printer Page Size.
AllowFailDo not fail the FS file if a conversion operation fails.  This reverses the default behavior of earlier releases.  The FailFS keyword is now ignored, but is retained if specified in case the file is used by a version 7 program.
ExcelSETP[V] When specified for an Excel conversion, adjusts the paper size in printer preferences to match the page size of the first Worksheet. See Printer Page Size.
FailFS Abandon the entire transmission (FS file) if a conversion operation fails. The default in version 7 was to send the remaining documents, if any.
FontsizeN Specify the font size to be used in Internet Explorer. The N is a number from 0 (smallest) to 4 (largest), corresponding to the five menu entries under View / Text Size in Internet Explorer. In the internal HTML converter, the same five values implement respectively a scaling of the rendered image by -20%, -10%, 0%, +10% and +20%.  The percentage steps (default 10) can be overridden using the value of variable CVSINGLE_SCALESTEP in the FS file.
FPimage[F] Specifies that an image conversion (PNG, JPG, GIF) is to be scaled to full-page.
GSPDF [G] Specifies the use of Ghostscript for PDF conversions.  We recommend the use of option QPDF (see below) in preference to GSPDF if you are unable to use Adobe.
GS300, GS400 Specifies the use of Ghostscript for PDF conversions, and the use of 300x300 or 400x400 resolution respectively.
HTMLWord[H] Specifies the use of Microsoft Word (or Star Office, see OODOCX above) for conversions of local HTML files instead of Internet Explorer.
IgnoreLM Ignore the Last Modification time of an HTTP URL, if available. The default is to always attempt a retrieval even if a corresponding fax format file exists which has not expired, but to abandon the retrieval if the fax file has a later timestamp than the last modification time in the HTTP header. The last modification time of a FILE URL is always available and is never ignored.
InterPDF[Y] When specified for the conversion of an Office 2007 (SP2) or later Office document, the document is saved as an intermediate PDF file without the use of the print driver, and then converted to TIF using the internal PDF coverter.  See the topic on converting Office documents.
NoIE [N] Specifies the use of an internal HTML converter instead of Internet Explorer. The built-in converter selected by this option is new for version 8.2.0.59 and later; the previous converter could not handle modern HTML.
OODOCX[X] Specifies the use of Open Office or LibreOffice instead of Microsoft Word for DOC and DOCX formats.  See Using Star/Open/Libre Office/
OOPPTX[X] Specifies the use of Open Office or LibreOffice instead of Microsoft Powerpoint for PPT and PPTX formats.  See Using Star/Open/Libre Office/
OOXLSX[X] Specifies the use of Open Office or LibreOffice instead of Microsoft Excel for XLS and XLSX formats.  See Using Star/Open/Libre Office/
PartialOK Treat as successful an IE5 retrieval operation which times out before all the graphics have been downloaded. The default is to treat the retrieval of the partial document as a failure.
PDFAttachWhen specified for the conversion of an Office 2007 (SP2) or later Office document, in an FS file where both $fax_filename and $email_attach reference the same Office document and the e-mail content-type is 'application/pdf', this causes the attachment to be converted directly from the Office document. Note that a $fax_filename command is required to force the FS file to be moved by the engine into PREPROC, but will be removed by the Document Converter if the FS has no $fax_phone command.  Without this option, an attachment with application/pdf content-type is converted from the TIF which results from the conversion to fax format, and is therefore monochrome and an image format in the PDF.
PPTSETP[U]  When specified for a PowerPoint (2007 or later) conversion, adjusts the paper size in printer preferences to match the page size of the first slide. See Printer Page Size.
QPDF[Q] Specifies the use of the internal PDF converter for PDF conversions.
RESCONVForces the use of an alternate Resolution Conversion print driver.
SODOC[S] Specifies the use of StarOffice or Open Office 2.x instead of Microsoft Word for DOC formats (and overrides OODOCX).  Deprecated: see Using Star/Open/Libre Office/
SOPPT[S] Specifies the use of StarOffice or Open Office 2.x instead of Microsoft Powerpoint for PPT formats (and overrides OOPPTX).  Deprecated: see Using Star/Open/Libre Office/
SOXLS[S] Specifies the use of StarOffice or Open Office 2.x instead of Microsoft Excel for XLS formats (and overrides OOXLSX).  Deprecated: see Using Star/Open/Libre Office/
StripJS[C] Causes a PDF to be checked for Javascript which causes it to put up a print dialog as soon as it is opened in Acrobat or Adobe Reader, and for the Javascript to be removed if so.  The file is saved without the Javascript as filename_NJ.PDF.
TIFAcrobat[A] Forces the use of Acrobat Professional V6 .. V10 for XIF and non-faxable TIF files.
TimeoutN Override the timeout default (45 seconds) to timeout in N seconds.  This timeout applies first to the remote retrieval of a document using HTTP or FTP, if applicable, and then to the print operation to the Document Converter print driver, if needed.
WordSETP[W] When specified for a Word conversion, adjusts the paper size in printer preferences to match the page size of the first page. See Printer Page Size.
exptime The expiration time (in hours, after its creation) of the fax-format representation of the HTTP document. The value may be zero or positive (negative values are treated as zero) and is used as follows:
If the IgnoreLM keyword is given, then the fax-format file is used until its expiry date and no web retrieval is attempted if the file has not expired. After the fax file has expired, IE5 web retrieval is attempted and the Last Modification information is ignored.
  If the IgnoreLM keyword is not given, then web retrieval is always attempted, and if there is a Last Modification time available in the HTTP header, it is used to determine whether the fax format file should be replaced or retrieval abandoned, and the expiration time is ignored.
  If the IgnoreLM keyword is not given, then web retrieval is always attempted, and if the Last Modification time is not available in the HTTP header, the expiration time is used to determine whether the fax format file should be replaced or retrieval abandoned.
  If the URL is a file URL, the expiration date is always ignored and the decision to re-convert to fax is based only on the file times.
H A suffix indicating hours (default)
D A suffix indicating days

Note that when the option keywords specify the use of the HTTP Header "Last-Modified" data (which is the default), the machine running FFEXTERN must be configured with the correct time-zone and daylight-savings settings for your location. This is because the HTTP data always uses Universal Time (GMT), and so the correct conversion must be used to match local times of the corresponding fax files on your system.

Default: No keywords are used, and expiration time 0.

Examples:

Allow partial retrievals where the document load timed out before all graphics were loaded:

$convert_options partialok

Ignore web document last modification times and unconditionally retrieve documents.

$convert_options 0 ignoreLM

Use the internal html conversion:

$convert_options noie