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

 QJbOprHldGet() / QJbOprHldSet()
------------------------------------------------------------------------------
 Purpose:
 Set the queue job on operator hold.

 Syntax:
 bResult=QJbOprHldGet( dwQueueID, iJobNum )
 bResult=QJbOprHldSet( dwQueueID, iJobNum, bHold )

 Parameters:
 dwQueueID The print queue ID number.
 iJobNum   The print job number.
 bHold     Specifies whether to place the job on operator hold - TRUE to
           place the job on hold and FALSE to remove the hold.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 QJbOprHldGet() returns TRUE if job number iJobNum in the print queue
 specified by ID number dwQueueID has been placed on operator hold.

 Returns FALSE if not, or if an error occurs.

 QJbOprHldSet() sets whether to place the job on operator hold based
 on bHold as above.

 Example:
 // To determine whether job number 244 in print queue PRINTQ_1
 // has been placed on operator hold:
 dwCurrQ = QueIDGet( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    bHoldInd = QJbOprHldGet( dwCurrQ, 244 )
    if ( NWErrorGet() = 0 )
       ? "Job 244 in PRINTQ_1 is "
       if ( bHoldInd )
          ?? "on hold"
       else
          ?? "not on hold"
       endif
    endif
 endifTo place job number 244 in print queue PRINTQ_1 on operator
 hold:dwCurrQ = QueIDGet( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    if ( QJbOprHldSet( dwCurrQ, 244 , TRUE ) )
       ? "Job 244 in PRINTQ_1 is now on hold"
    endif
 endif

 Notes:
 The print queue ID number is obtained using the QueIDGet() function
 and print job numbers are obtained using the QueQJbLst() function. To
 change the operator hold status the requesting user must have queue
 operator rights. If FALSE is returned, check NWErrorGet().