FN_CRQJBFI()
 Create queue job and file
------------------------------------------------------------------------------
 Syntax
 
      fn_crQJbFi( nQueueID, @aJobStruct, [<lSetPrt>] ) -> nHandle
 
 Arguments

    <nQueueID> is the bindery object ID for the queue.
    <aJobStruct> is an array containing a queue "job structure."
    MUST BE PASSED BY REFERENCE!

    The user-defined command CREATE JOBSTRUCT can help you create
    a properly formatted job structure.

    <lSetPrt> is an optional logical argument.  If you set it
    to .t., then the SET PRINTER DEVICE will be redirected
    such that your printer output will go directly to the spool
    file created by this function.  Defaults to FALSE (.f.).

 Returns

    <nHandle>

    Also, the <aJobStruct> will be filled in...

 Description

    It is important that if you set <lSetPrt> to .t., that you
    let the fn_cfabjq() (Close File and Abort Queue Job) or
    fn_stqjob() (Close File and Start Queue Job) functions
    close the SET PRINTER device -- in other words, don't use
    a SET PRINTER TO all by itself.

 Examples

        #include "netto.ch"
        // Get the queue id for the queue, and set up the job
        // structure, then...
                     .
                     .
        hJobFile := fn_crqjbfi( nQid, @aJob, .t. )
        set device to print
        set printer on

        ? "Hello there, this is printed from Clipper!"
        ? "Is it not wonderful?"
        eject
        ? "Next page!"
        @ 20, 10 say "And this is at 20, 10!"

        set printer off
        set device to screen

        if !fn_stqjob( nQid, aJob[ QJ_JOB_NUMBER ], hJobFile )
           qout( "Error closing queue job:", fn_error() )
        endif

 Header File: netto.CH


 Source: N:\SRC\QMS\CRQJBFI.PRG

 Author: Glenn Scott and Chris Boduch