(v13) SubmitFile in the HqnControl procset

This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP

When submitting a file that is intended to represent a job (as opposed to a file used for annotations), SubmitFile should be used in preference to ExecFile . See (v13) ExecFile in the HqnControl procset for more information.

datasource [ <<config>> ] -> SubmitFile

Where datasource can be:

string	A file name.
integer	The number of bytes to read from current file to get the file name.
null	The input file is the rest of the current file. This is spooled to disk, and then run.

Three examples follow: Code example 1

12 << /FileType /PDF >> /HqnControl /ProcSet findresource /SubmitFile get exec %C%runme.pdf

Code example 2:

TEXT

            null <<
                  /FileType /PDF
                  /JobName (Sample job)
                  /PageSetup (TEST)
            >> /HqnControl /ProcSet findresource /SubmitFile get exec
            %PDF-1.3
            1 0 obj
            << ...

Code example 3:

(File.prn) << >> /HqnControl /ProcSet findresource /SubmitFile get exec

The optional config dictionary can include:

`FileType`	The value of this key must be a literal name describing the type of file. being submitted (`/PS` , `/PDF` , `/EPS` , and so on). See also "TypeOrder".
`PageRange`	If this key is supplied, only the requested pages from the job will be rendered. The format of the array value matches that documented for the `pdfexec` operator.
`JobName`	This sets `jobname` in `statusdict` to this string.
`PageSetup`	This should be a string and loads this page setup before executing the file.
`Header`	This is only used where `datasource` is `null` , and copies this string or array of strings to the `temp` file before the rest of the stream.
`TypeOrder`	This is an array of names from `InputTypes` in `HqnConfigProvider` . Test these file types in the opposite order to the order in this array. `/PS` should be first in the array. This only used when `FileType` is not supplied.
`JobNameIsFileName`	This should be set to `true` if `JobName` is to be treated as a filename, and to `false` if not. If `JobNameIsFileName` is not specified previous behavior is maintained.
`JobNameUTF8`	If provided it must be a UTF-8 representation of `/JobName` .