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)

 
 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.