NWSetQueueServerCurrentStatus(3nw)


NWSetQueueServerCurrentStatus -- updates Queue Management copy of server's status record

Synopsis

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

NWCCODE N_API NWSetQueueServerCurrentStatus (NWCONN_HANDLE conn, nuint32 queueID, 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 to which the specified queue server is attached.

statusRec
(IN) Points to the 64-byte buffer containing the new status record of the queue server.

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 does not interpret the contents of the status record. The record contains information important to the calling application only. It is recommended the first four bytes of this record contain an estimated cost (in hours, dollars, or whatever is defined) for the given server to complete a standard job to both indicate and standardize the function.

Only workstations previously attached to the queue as queue servers can call NWSetQueueServerCurrentStatus.

Services

Queue Management

NCP calls

0x2222 23 119 Set Queue Server Current Status

 
 0x2222   23   119   Set Queue Server Current Status 

References

NWReadQueueServerCurrentStatus2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.