Specify alternate MSMQ name for writing preprocess notifications
$preproc_altqname node qname [tosendnum]
This command specifies the name of an alternate private MSMQ queue to which messages will be written to prioritize specific preprocessing tasks in FFEXTERN. It is used in Job Administration if a variable named USE_ALT_PREPROC_QUEUE is defined with a non-empty value in the instance UJP.
The parameters on this command are used as follows:
| node | the nodename of the machine which is to use this queue, or * for all nodes. |
| qname | the name of an existing private queue to which this node has permission to write. |
| tosendnum | The TOSEND queue number value below which FS files (of higher priority) will have an MSMQ message created when they are moved to PREPROC. This number should always be 10 for the alternate queue, so that all FS files written to PREPROC are notified by queue messages. |
This command affects:
| • | the FS file written to PREPROC by a Job Admin pre-convert operation for a job instance with job option keyword AutoConvert. |
| • | the FS files written to PREPROC by a Job Admin launch operation for a job instance with job option keyword AutoConvert. |
Note that this command does not currently affect any FS files automatically moved to PREPROC by the CopiaFacts engine when one or more of its $fax_filename files has a file type to be converted as a result of a $convert_types entry.
The FFEXTERN instance(s) processing the PREPROC files must specify the queue name using the command-line flag /Q. It should also use the /NS flag to suppress scans of PREPROC.
The MSMQ message contains only the FS filename to be prioritized. It causes FFEXTERN to pick the specified FS file from PREPROC ahead of any it finds by scanning this folder.
The original TOSEND priority is used to determine the priority in the message queue. TOSEND priorities 0 to 7 are translated to queue priorities 7 to 0 respectively, and TOSEND8 and TOSEND9 are translated to queue priority 0. For special purposes you can override this transformation using the system variable MSMQ_PREPROC_PRI, which affects only job launch operations.
Example:
Always write an MSMQ message when moving files to PREPROC
$preproc_altqname * mname\private$\altpreproc 10
Topic url: http://www.copia.com/support/refmanual/index.html?$preproc_altqname.htm