(v13) %config% device parameters

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

The device %config% is present in all versions of the RIP. This device operates as a source of PostScript-language fragments in the server loop which identifies the actual devices and files from which PostScript jobs are to be run; its parameters vary from version to version. The implementation of the GUI version of %config% has a number of parameters which may occasionally be useful:

ConfigDebug (%config% device)

Boolean

If set to true, this causes the PostScript being emitted by the %config% device to be printed first in the monitor window. This can be useful on occasions when the enigmatic message “error in config file” is encountered.

ConfigJobFailed (%config% device)

Boolean

This is set by the server loop if a job fails (if a PostScript error is not caught by a stopped operator within the job, or if the job is interrupted or times out). Use this parameter to communicate the failure to the source of the job so that appropriate action can be taken: for example, the spool folder moves the spooled file into a safe directory when this occurs. If a core-RIP implementation supports this parameter on its %config% device, it too  receives this information.

appletalktype, printername, jobstate, and jobname (%config% device)

all strings

These are set as side effects of various procedures, such as setprintername and setprinterstate in statusdict: see (v13) AppleTalk statusdict procedures. You can also set the strings explicitly, but remember that a job may then cause them to be overwritten again. (The strings are made available to input plugins in the GUI version in the SWStatus structure of the ChannelContext structure.) For AppleTalk, these strings are used to display the status of the job on the sending Macintosh. If a core-RIP implementation supports these parameters on its %config% device, it too receives the strings. jobstate is used to indicate what the RIP is doing: it sets it to idle (no interpretation in progress), busy (interpreting), and printing (during showpage). jobname is derived from the string jobname in statusdict and the user parameter JobName.