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

 QJbDscGet() / QJbDscSet()
------------------------------------------------------------------------------
 Purpose:
 Get / set the queue job description.

 Syntax:
 lpszDesc = QJbDscGet( dwQueueID, iJobNum )
 lpszDesc = QJbDscSet( dwQueueID, iJobNum, lpszNewDesc )

 Parameters:
 dwQueueID   The print queue ID number.
 iJobNum     The print job number.
 lpszNewDesc The new job description.

 Returns:
 A character string of length 49.

 Description:
 QJbDscGet() returns a character string containing the description of
 print job number iJobNum in the print queue specified by ID number
 dwQueueID. Returns an empty string if an error occurs.

 QJbDscSet() sets the job description to lpszNewDesc and returns the
 previous description if successful.

 Example:
 // To display the description of job number 244 in print queue PRINTQ_1:
 dwCurrQ = QueIDGet( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    lpszTextStr = QJbDscGet( dwCurrQ, 244 )
    if ( !empty(lpszTextStr) )
       ? "The description of job 244 is", lpszTextStr
    endif
 endif
 // To change the description of job number 244 in print queue PRINTQ_1
 // to "JOB 244":
 dwCurrQ = QueIDGet( "PRINTQ_1" )
 if ( dwCurrQ != NOVERRLONG )
    lpszTextStr = QJbDscSet( dwCurrQ, 244, "JOB 244" )
    if ( !empty(lpszTextStr) )
       ? "The new description of job 244 is", lpszTextStr
    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 job description, the requesting user must either own the
 specified job or have queue operator rights.