NWReadQueueCurrentStatus2(3nw)

NWReadQueueCurrentStatus2 -- reads current status of queue

Synopsis

#include <nwqms.h> or #include <nwcalls.h>

NWCCODE N_API NWReadQueueCurrentStatus2 (NWCONN_HANDLE conn, nuint32 queueID, pnuint32 queueStatus, pnuint32 numberOfJobs, pnuint32 numberOfServers, pnuint32 serverIDlist, pnuint32 serverConnList);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle.
queueID: (IN) Specifies the bindery object ID of the queue for which the status is being obtained.
queueStatus: (OUT) Points to the status of the specified queue (optional).
numberOfJobs: (OUT) Points to the number of jobs currently in the queue, 0-250 (optional).
numberOfServers: (OUT) Points to the number of queue servers currently attached to service the queue, 0-25 (optional).
serverIDlist: (OUT) Points to an array of server IDs associated with numberOfServers (25 nuint32s, optional).
serverConnList: (OUT) Points to an array of station numbers corresponding to the servers returned by serverIDlist (25 nuint16s, optional).

Return values

0x0000: SUCCESSFUL
0x8801: INVALID_CONNECTION
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

queueStatus indicates the overall queue status. The status mask is defined as follows:

0x01: QS_CANT_ADD_JOBS
0x02: QS_SERVERS_CANT_ATTACH
0x04: QS_CANT_SERVICE_JOBS

serverIDList and serverConnList identify queue servers currently servicing the queue by object ID number and current workstation attachment.

NOTE: Workstations calling NWReadQueueCurrentStatus2 must be security equivalent to one of the objects listed in the queue's Q_USERS, Q_OPERATORS, or Q_SERVERS properties.

Services

Queue Management

NCP calls

0x2222 23 17 Get File Server Information

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

0x2222 23 125 Read Queue Current Status (3.11 or later)

 
 ------------------------------------------ 
| 0x2222|  23|  17 |  Get File Server     | 
|       |    |     |  Information         | 
|-------|----|-----|----------------------| 
| 0x2222|  23|  102|  Read Queue Current  | 
|       |    |     |  Status (no 1000 user| 
|       |    |     |  support)            | 
|-------|----|-----|----------------------| 
| 0x2222|  23|  125|  Read Queue Current  | 
|       |    |     |  Status (3.11 or     | 
|       |    |     |  later)              | 
|-------|----|-----|----------------------|

References

NWAttachQueueServerToQueue(3nw), NWDetachQueueServerFromQueue(3nw), NWReadQueueServerCurrentStatus2(3nw), NWSetQueueCurrentStatus2(3nw), NWSetQueueServerCurrentStatus(3nw)

0x2222	23	17	Get File Server Information
0x2222	23	102	Read Queue Current Status (no 1000 user support)
0x2222	23	125	Read Queue Current Status (3.11 or later)