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

 QJbBannerGet() / QJbBannerSet()
------------------------------------------------------------------------------
 Purpose:
 Get or set the queue job banner.

 Syntax:
 lpszBanner = QJbBannerGet( dwQueueID, iJobNum )
 lpszBanner = QJbBannerSet( dwQueueID, iJobNum, lpszNewBan )

 Parameters:
 dwQueueID  The print queue ID number.
 iJobNum    The print job number.
 lpszNewBan The new banner title.

 Returns:
 A character string of length 14.

 The CA-Clipper names for these functions are:
 QJbBanGet() / QJbBanSet().

 Description:
 QJbBannerGet() is used to return the banner title of a queue job.
 dwQueueID is the print queue ID number, iJobNum is the job number.

 Returns the banner title if successful, or an empty string if an
 error occurs.

 QJbBannerSet() sets the banner title to lpszNewBan, which can be up to 14
 characters long. Returns the previous banner title, or an empty string if
 an error occurs.

 Example:
 // To change the banner title of job number 659 of print queue
 // PRINTQ_0 to MY_JOB:
 dwCurrQ = QueIDGet( "PRINTQ_0" )
 if ( dwCurrQ != NOVERRLONG )
    lpszOldTextStr = QJbBannerSet( dwCurrQ, 659, "MY_JOB" )
    lpszNewTextStr = QJbBannerGet( dwCurrQ, 659 )
    if ( !empty(lpszNewTextStr) )
       ? "The new title of job 659 is", lpszNewTextStr
    endif
 endif

 Notes:
 The queue ID number can be obtained using the QueIDGet() function.
 Print job numbers can be obtained from the list returned by QueQJbList().