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

 NNETJDESC()
 Reads and modifies the job description
------------------------------------------------------------------------------
 Syntax

     NNETJDESC(<cQueue>,<nJob>,[<cDescription>],
        [<cServer>|<nConId>]) --> cDescription

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

     <cDescription>  Designates the new job description for <nJob>.  The
     job description can be up to 49 characters long.

     <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

     NNETJDESC() returns the job description of <nJob> in <cQueue>.  If an
     error occurs (for example, if <cQueue> does not exist), the function
     returns an empty string.

 Description

     NOVELL NET JOB DESCRIPTION
     NNETJDESC() allows you to read or to modify the description of each job
     in a queue.  The description can be up to 49 characters long and is
     printed on the banner page.  By passing the parameter <cDescription>,
     you can overwrite the default description "LPTnCatch".  The operation
     has been successful if the returned character string is identical to the
     parameter <cDescription>.

     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.  The
     job number can be determined with NNETCAPJOB() or NNETJLIST().

 Notes

     .  The reading of a job description requires that the requesting
        user has access to the queue as a user or an operator.  The right to
        modify a job description is reserved for the user who has created the
        job and for the queue operator.

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

 Examples

     .  Query the job description for the first job in the queue
        LINEPRINTER:

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

     .  Start the capture mode for LPT1, send output to the queue
        LINEPRINTER, and set the description of the resulting job to
        "!CONFIDENTIAL!":

        NNETCAPSSF(1)
        NNETCAPBEG(1)
        NNETSETQ(1,'LINEPRINTER')
        SET PRINTER ON
        ? 'Hello'
        NNETJDESC('LINEPRINTER',NNETCAPJOB(1),'!CONFIDENTIAL!')
        NNETCAPFLU(1)

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