NWSetQueueCurrentStatus2(3nw)
NWSetQueueCurrentStatus2 --
controls addition of jobs and servers to queue
Synopsis
#include <nwqms.h>
or
#include <nwcalls.h>
NWCCODE N_API NWSetQueueCurrentStatus2
(NWCONN_HANDLE conn,
nuint32 queueID,
nuint32 queueStatus);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- queueID
-
(IN) Specifies the bindery object ID of the queue whose status
is being updated.
- queueStatus
-
(IN) Specifies the control byte determining the new queue status.
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
- 0x89FC
-
NO_SUCH_OBJECT
- 0x89FF
-
Failure
Notices
NWSetQueueCurrentStatus2 modifies the bits in
queueStatus. The following queue status values are defined
for NWSetQueueCurrentStatus2:
- 0x01
-
QS_CANT_ADD_JOBS
- 0x02
-
QS_SERVERS_CANT_ATTACH
- 0x04
-
QS_CANT_SERVICE_JOBS
The workstation calling NWSetQueueCurrentStatus2 must be logged
in as one of the objects listed in Q_OPERATORS.
Services
Queue Management
NCP calls
0x2222
|
23
|
17
|
Get File Server Information
|
0x2222
|
23
|
103
|
Set Queue Current Status (no 1000 user support)
|
0x2222
|
23
|
126
|
Set Queue Current Status (3.11 or later)
|
References
NWAttachQueueServerToQueue(3nw),
NWDetachQueueServerFromQueue(3nw),
NWReadQueueCurrentStatus2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.