NWChangeQueueJobEntry2(3nw)
NWChangeQueueJobEntry2 --
changes the information about a job in a queue
Synopsis
#include <nwqms.h>
or
#include <nwcalls.h>
NWCCODE N_API NWChangeQueueJobEntry2
(NWCONN_HANDLE conn,
nuint32 queueID,
NWQueueJobStruct N_FAR job);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- queueID
-
(IN) Specifies the bindery object ID of the queue.
- job
-
(IN) Points to NWQueueJobStruct containing the new information about the job.
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_NO_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,HARDWARE_FAILURE
Notices
Information supplied by the caller overwrites information already in the job record.
NWChangeQueueJobEntry2 can be used in conjunction with NWReadQueueJobEntry2 to change a portion of the job's entry record. However, if the target entry is
already being serviced, NWChangeQueueJobEntry2 returns a servicing error and makes no changes to the job's entry record.
If the caller is an operator, QF_OPERATOR_HOLD can be reset to a value supplied by the caller.
An operator or the job creator can call NWChangeQueueJobEntry2.
Services
Queue Management
NCP calls
- 0x2222 23 17
-
Get File Server Information
- 0x2222 23 109
-
Change Queue Job Entry (no 1000 user support)
- 0x2222 23 123
-
Change Queue Job Entry (3.11 and above)
References
NWChangeQueueJobPosition2(3nw),
NWGetQueueJobList2(3nw),
NWReadQueueJobEntry2(3nw),
NWRemoveJobFromQueue2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.