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

 QJbDeferTimeGet() / QJbDeferTimeSet()
------------------------------------------------------------------------------
 Purpose:
 Get or set the deferred execution time of a job.

 Syntax:
 lpszTime = QJbDeferTimeGet( dwQueueID, iJobNum )
 lpszTime = QJbDeferTimeSet( dwQueueID, iJobNum, lpszNewTime )

 Parameters:
 dwQueueID   The print queue ID number.
 iJobNum     The print job number.
 lpszNewTime The printing deferral time.

 Returns:
 A character string of length 8.

 The CA-Clipper names for these functions are:
 QJbDefTmeGet() / QJbDefTmeSet()

 Description:
 QJbDeferTimeGet() is used to determine the deferred printing time of print
 job number iJobNum in queue ID dwQueueID. Returns the time that print job
 number iJobNum in the print queue specified by ID number dwQueueID is to
 be printed, or an empty string if the job is not deferred or an error
 occurs.

 QJbDeferTimeSet() sets the deferred printing time to lpszNewTime and
 returns the previous time, or an empty string if the job is not deferred or
 an error occurs.Normally when a job is added to a queue it is ready to be
 printed immediately. Using QJbDeferDateSet() and QJbDeferTimeSet() the job
 can be held until a specific date and time before it is released by the
 queue for printing.

 Example:
 // To set the time print job number 442 in print queue
 // PRINTQ_1 is to be printed:
 dwCurrQ = QueIDGet( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    lpszOldDefTime = QJbDeferTimeSet( dwCurrQ, 442, "09:00:00" )
    lpszNewDefTime = QJbDeferTimeGet( dwCurrQ, 442 )
    if ( !empty(lpszNewDefTime) )
       ? "Job 442 is deferred until", lpszNewDefTime
    endif
 endif

 Notes:
 To defer a new print job, QJbDeferDateSet() must be called before
 QJbDeferTimeSet(). The print queue ID number is obtained using the
 QueIDGet() function and print job numbers are obtained using the
 QueQJbList() function. If an empty string is returned, check NWErrorGet().

 The time is passed and returned in the form HH:MM:SS.