NWReadQueueServerCurrentStatus2(3nw)

NWReadQueueServerCurrentStatus2 -- reads current status of queue server

Synopsis

   #include <nwqms.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWReadQueueServerCurrentStatus2 
     (NWCONN_HANDLE   conn, 
      nuint32         queueID, 
      nuint32         serverID, 
      nuint32         serverConn, 
      nptr            statusRec);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle.
queueID: (IN) Specifies the bindery object ID of the queue being affected.
serverID: (IN) Specifies the bindery object ID of the queue server whose current status is being read.
serverConn: (IN) Specifies the connection number of the queue server being read.
statusRec: (OUT) Points to a buffer containing the status of the specified queue server (64 bytes).

Return values

0x0000: SUCCESSFUL
0x8999: DIRECTORY_FULL
0x89D0: ERR_Q_IO_FAILURE
0x89D1: ERR_NO_QUEUE
0x89D2: ERR_NO_Q_SERVER
0x89D3: ERR_NO_Q_RIGHTS
0x89D4: ERR_Q_FULL
0x89D5: ERR_NO_Q_JOB
0x89D6: ERR_NO_Q_JOB_RIGHTS
0x89D7: ERR_Q_IN_SERVICE
0x89D8: ERR_Q_NOT_ACTIVE
0x89D9: ERR_Q_STN_NOT_SERVER
0x89DA: ERR_Q_HALTED
0x89DB: ERR_Q_MAX_SERVERS
0x89FF: Failure

Notices

QMS maintains a 64-byte status record for each queue server attached to a queue.

QMS does not interpret the contents of the status record. The record contains information important to the calling application. It is recommended that the first 4 bytes of this record contain an estimated cost for the given server to complete a standard job (in hours, dollars, or whatever you define), to both indicate and standardize the function.

Workstations calling NWReadQueueServerCurrentStatus2 must be security equivalent to one of the objects listed in the queue's Q_USER or Q_OPERATORS properties.

Services

Queue Management

NCP calls

0x222 23 17 Get Server Info

0x2222 23 118 Read Queue Server Current Status (no 1000 user support)

0x2222 23 134 Read Queue Server Current Status

References

NWSetQueueServerCurrentStatus(3nw)

0x222	23	17	Get Server Info
0x2222	23	118	Read Queue Server Current Status (no 1000 user support)
0x2222	23	134	Read Queue Server Current Status