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

 NNETJSTIME()
 Queries or sets the job start time
------------------------------------------------------------------------------
 Syntax

     NNETJSTIME(<cQueue>,<nJob>,[<cNew>],[<cServer>|
        <nConId>]) --> cTime

     Netware: 2.2 and 3.11

 Arguments

     <cQueue>  Designates the name of the print queue that is accessed.

     <nJob>  Designates the job number of the job that is processed in
     <cQueue>.

     <cNew>  Designates a new job start time for <nJob>.  The time must
     be passed as a string in the form ("HH:MM:SS").

     <cServer>  Designates the name of the file server on which <cQueue>
     is processed.  Your workstation must be attached to <cServer>.

     <nConId>  Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETJSTIME() returns the earliest time for <nJob> in <cQueue> as a
     string in the form ("HH:MM:SS").  The function returns an empty string
     ("  :  :  ") if the job start time has not been set or if an error
     occurs (for example, if <cQueue> does not exist).

 Description

     NOVELL NET JOB START DATE
     The Queue Management System (QMS) allows you to provide each job with a
     retention period.  A job is not serviced before the specified time (job
     start time).  With NNETJSTIME(), you can query or set the job start time
     of <nJob> in <cQueue>.  The required job is specified by its job number.
     The job number has nothing to do with the logical position of a job
     within a queue; for example, the job with the highest priority in a
     queue is not automatically job number 1.  The job number must be
     determined with NNETCAPJOB() or NNETJLIST().

     NNETJSTIME() returns the job start time.  An empty string indicates that
     no time has been set.  In this case, the job is serviced as soon as a
     print server is available.  ( An empty string can also indicate an
     error.  A differentiation is possible with the NNETERROR() function.)

     A new job start time can be set by passing a time with the <dNew>
     parameter.  If <dNew> contains an empty time string ("  :  :  "), a
     previously set job start date is removed.  If you reset a job start
     time, the job start date is removed automatically.

     To avoid an incorrect interpretation by the QMS of a date that has not
     been initialized, always set a job start date with the job start time.

 Notes

     .  To determine a job start time, the requesting user must have
        access to the queue as a user or an operator.  The modification of a
        job start time is reserved for the user who created the job or for
        queue operators.

     .  A job that is already in progress cannot be modified.

 Examples

     .  Query the job start time for the first job in the queue
        LINEPRINTER:

        nJob=BIN2I(LEFT(NNETJLIST('LINEPRINTER'),2))
        ? NNETJSTIME('LINEPRINTER',nJob)

     .  Create the capture job, set the job start date for the
        following day, and set the job start time for 10 PM:

        NNETCAPSSF(1)
        NNETCAPBEG(1)
        NNETSETQ(1,'LINEPRINTER')
        SET PRINTER ON
        ? 'Hello'
        nJob=NNETCAPJOB(1)
        NNETJSDATE('LINEPRINTER',nJob,DATE()+1)
        NNETJSTIME('LINEPRINTER',nJob,'22:00:00')
        NNETCAPFLU(1)

     .  The new job is always created at the first output (? "Hello"),
        not by calling NNETCAPBEG().  Therefore, NNETJSTIME() must be called
        after the first output.  If NNETJSTIME() is not called after the
        first output, NNETCAPJOB() returns the number of the previous capture
        job and the job start date is modified for the wrong job.

     .  Remove the retention period for the first job in the queue
        LINEPRINTER (date and time):

        nJob=BIN2I(LEFT(NNETJLIST('LINEPRINTER'),2))
        ? NNETJSDATE('LINEPRINTER',nJob,('  :  :  '))