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

 NNETQSTAT()
 Sets or reads a print queue status
------------------------------------------------------------------------------
 Syntax

     NNETQSTAT(<cQueue>,[<nStatus>],[<cServer>|<nConId>])
        --> nStatus

     Netware: 2.2 and 3.11

 Arguments

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

     <nStatus>  Designates an optional parameter that sets the queue
     status.  <nStatus> must be passed as a bit-coded value according to
     table 25.3.  To change more attributes, the decimal values of the
     required definitions must be added.

     <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

     NNETQSTAT() returns a bit-coded value which describes the queue status.
     The following table contains the definitions of the bits:

     Table 25.3:  Queue Status Coding 
     ------------------------------------------------------------------------
     Bit     Value     Definition
     ------------------------------------------------------------------------
     2       2         No new jobs can be added to queue.
     3       4         Currently, no further print servers can be logged in
                       at queue currently.
     5       16        No jobs are being serviced in queue currently
     ------------------------------------------------------------------------

     If an error occurs (for example, if <cQueue> does not exist), the
     function returns -1.

 Description

     NOVELL NET QUEUE STATUS
     NNETQSTAT() allows you not only to query, but also to set a new queue
     status.  For example, this can be used to stop the print output for a
     queue temporarily.  To change the queue status, the requesting user must
     have access to the queue as an operator.

 Note

     .  This function requires that the requesting user have access to
        the queue as a user or an operator.

 Examples

     .  Check to see if jobs can be added to the queue LINEPRINTER:

        IF ISBIT(NNETQSTAT('LINEPRINTER'),2)
        ? 'No new jobs can be added!'
        ELSE
        ? 'New jobs can be added!'
        ENDIF

     .  Prevent the servicing of jobs in the queue LINEPRINTER:

        NNETQSTAT('LINEPRINTER',16)