Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Book 4-Appendices - <b>nnetjpos()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETJPOS()
 Determines or changes the position of a job in a queue
------------------------------------------------------------------------------
 Syntax

     NNETJPOS(<cQueue>,<nJob>,[<nNewPos>],[<cServer>|
        <nConId>]) --> nPos

     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>.

     <nNewPos>  Designates an optional parameter that contains the new
     position of <nJob> in the logical sequence of <cQueue>.

     <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

     NNETJPOS() returns the new position of <nJob> in the logical sequence of
     <cQueue>.  If an error occurs (for example, if  <cQueue> does not
     exist), the function returns -1.

 Description

     NOVELL NET JOB POSITION
     Within a queue, the jobs are organized as a waiting line.  Generally,
     the jobs are put into a queue in the sequence of their creation.  With
     NNETJPOS(), you can determine the position of a job within a queue.  The
     job with position 1 is serviced first.  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().

     NNETJPOS() allows a queue operator to change the position of <nJob> in
     <cQueue> by passing the parameter <nNewPos>.

 Note

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

 Examples

     .  Determine the position of the last created capture job via
        LPT1 in the queue LINEPRINTER:

        ? NNETJPOS('LINEPRINTER',NNETCAPJOB(1))

     .  Change the priority of the job:

        IF NNETJPOS('LINEPRINTER',NNETCAPJOB(1),1)<>1
        ? 'No queue operator rights!'
        ENDIF

See Also: NNETCAPJOB() NNETJLIST()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson