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

 QJbRstGet() / QJbRstSet()
------------------------------------------------------------------------------
 Purpose:
 Get / set the job restart flag.

 Syntax:
 bResult= QJbRstGet( dwQueueID, iJobNum )
 bResult= QJbRstSet( dwQueueID, iJobNum, bNewFlag )

 Parameters:
 dwQueueID The print queue ID number.
 iJobNum   The print job number.
 bNewFlag  The new flag setting.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 QJbRstGet() returns TRUE if print job number iJobNum being printed on
 the print queue specified by ID number dwQueueID will be restarted from
 the beginning if the print server aborts the job or goes down before the
 job has finished being printed. QJbRstGet() returns FALSE if the job
 will be cancelled in such an event.QJbRstSet() sets the job's restart
 flag to bNewFlag. If bNewFlag is set to TRUE, the job will restart if a
 print server problem occurs and if set to FALSE, the job is cancelled in
 the event of a problem.Returns FALSE and NWErrorGet() is set if an error
 occurs.

 Example:
 // To determine whether print job number 442 on print queue PRINTQ_1 will
 // be restarted if the print server goes down or aborts the job:
 bJobStart = QJbRstGet( QueIDGet( "PRINTQ_1" ), 442 )
 if( NWErrorGet() = 0 )
    if bJobStart
       ? "Print Job 442 will be restarted in the event"
    else
       ? "Print Job 442 will NOT be restarted in the event"
    endif
    ? "of a problem occurring with the print server"
 endif
 // To change the restart setting of print job 151 on print queue PRINTQ_0
 t// o make sure it restarts if the print server aborts the job:
 bJobStart = QJbRstSet( QueIDGet( "PRINTQ_0" ), 151, TRUE )
 if( NWErrorGet() = 0 )
    if bJobStart
       ? "Print Job 151 will be restarted in the event"
    else
       ? "Print Job 151 will NOT be restarted in the event"
    endif
    ? "of a problem occurring with the print server"
 endif

 Notes:
 The print queue ID number is obtained using the QueIDGet() function
 and print job numbers are obtained using the QueQJbLst() function. If
 FALSE is returned, check NWErrorGet().