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

 OjbDefDteGet() / OjbDefDteSet()
------------------------------------------------------------------------------
 Purpose:
 Get / set the deferred execution date of a job.

 Syntax:
 lpszExDate = OjbDefDteGet( dwQueueID, iJobNum )
 lpszExDate = OjbDefDteSet( dwQueueID, iJobNum, lpszNewDate )

 Parameters:
 dwQueueID   The print queue ID number.
 iJobNum     The print job number.
 lpszNewDate The printing deferral date.

 Returns:
 A character string of length 8.

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

 OjbDefDteSet() sets the deferred printing date to lpszNewDate and
 returns the previous value. Returns an empty date if the job is not
 deferred, or if an error occurs.

 Normally when a job is added to a queue it is ready to be printed
 immediately. Using OjbDefDteSet() and QJbDefTmeSet() the job can be
 held until a specific date and time, before it is released by the queue for
 printing.

 Example:
 // To set the date print job number 442 in print queue
 // PRINTQ_1 is to be printed:
 dwCurrQ = QueIDGet( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    lpszOldDate = OjbDefDteSet( dwCurrQ, 442, ctod("04/15/96"))
    lpszNewDate = OjbDefDteGet( dwCurrQ, 442 )
    if ( !empty(lpszNewDate) )
       ? "Job 442 is deferred until", lpszNewDate
    endif
 endif

 Notes:
 The print queue ID number is obtained using the QueIDGet() function
 and print job numbers are obtained using the QueQJbLst() function.The
 format of the date values is the ANSI style "yyyymmdd" except with
 CA-Clipper and CA-Visual Objects where the date values are of type DATE The
 CA-Clipper names for these functions are QJbDefDteGet() / QJbDefDteSet().