FN_SQJOBFI()
 Service queue job and open file
------------------------------------------------------------------------------
 Syntax
 
      fn_sQJobFi( nQueueID, nJobType, @nHandle ) -> aJobStruct
 
 Arguments

     <nQueueID> is the bindery object ID of the queue
     <nJobType> is the target job type this queue server will service.
                If you set it to -1, you'll get the first available
                job in the queue.
     <@nHandle> is a numeric, sent in by reference, and will be
                replaced by the DOS file handle of the queue job file
                when the call returns
                MUST BE SENT IN BY REFERENCE!!!

 Returns

      <aJobStruct>, the job entry structure for the queue.
      If <aJobStruct> is empty ( {} ), then there was an error
      that can be retrieved from FN_ERROR().

 Description

      Queue servers use this call to get the next job to service.
      Once called, the specificed queue is searched from front to
      back for a job that meets the following criteria:

            -  The Target Server ID must either be -1 or must
               match the ID of the server that makes the call

            -  The target execution date must either be ctod("")
               or the target execution time must be "99:99:99"
               or must specify a time earlier than the system
               clock

            -  The job type field must match that of the call
               if the call doesn't specify -1 for target job type

            -  The job control flags "Operator Hold", "User Hold",
               and "Entry Open" must be .f.

            -  The Server ID number field must be 0, indicating
               that no other server is working on this job.

     If we get a job, the job entry structure is updated to reflect
     your server's information (server station, server task, server
     ID).

     In addition, the job file is opened and a DOS file handle is
     returned in <nHandle>, suitable for fwrite()ing.

     In order to use this call, the station making the call must
     have attached to the queue as a queue server first and must
     have the proper security (i.e., must be in the queue's
     Q_SERVERS property).

 Examples


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

 Author: Glenn Scott