Click above to get retro games delivered to your door ever month!

 QJbFlgGet() / QJbFlgSet()
------------------------------------------------------------------------------
 Purpose:
 Get / set the status flags of a queue job.

 Syntax:
 iFlags = QJbFlgGet( dwQueueID, iJobNum )
 iFlags = QJbFlgSet( dwQueueID, iJobNum, iNewFlag )

 Parameters:
 dwQueueID The print queue ID number.
 IJobNum   The print job number.
 INewFlag  The job control flag mask.

 Returns:
 A numeric value (signed short int).

 Description:
 QJbFlgGet() returns the control flags for a print job specified by
 iJobNum in print queue dwQueueID. Returns NOVERRINT if an error occurs.

 QJbFlgSet() sets the print job control flags; iNewFlag is the
 flag mask which comprises the following bits:

 Bit   Value  Description
 3       8    Job will be serviced automatically if connection broken
 4      16    Job remains in queue after server aborts job
 5      32    Client has not filled associated job file
 6      64    User Hold - job advances, but cannot be serviced until hold
              is cleared by user or operator.
 7     128    Operator Hold - job advances, but cannot be serviced until
              hold is cleared by an operator.

 To change a flag, it must be read first by calling QJbFlgGet(),
 then OR'ed with the appropriate value and passed to QJbFlgSet() as
 NewFlag.

 Returns NOVERRINT if an error occurs.

 Example:
 //To set the operator hold flag of job 511 in print queue PRINTQ_0:
 dwCurrQ = QueIDGet( "PRINTQ_0" )
 if ( dwCurrQ != NOVERRLONG )
    iFlags = QJbFlgGet( dwCurrQ, 511 )
    if ( iFlags != NOVERRINT )
       if ( iFlags < 128 )
          iFlags = iFlags + 128   // Set Operator hold bit
       endif
       QJbFlgSet( dwCurrQ, 511, iFlags )
    endif
 endif

 Notes:
 WARNING: USE WITH CAUTION. Only use if you have a good knowledge of
 how the NetWare QMS works.