NWChangeQueueJobPosition2(3nw)
NWChangeQueueJobPosition2 --
changes a job's position in a queue
Synopsis
#include <nwqms.h>
or
#include <nwcalls.h>
NWCCODE N_API NWChangeQueueJobPosition2
(NWCONN_HANDLE conn,
nuint32 queueID,
nuint32 jobNumber,
nuint32 newJobPos);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- queueID
-
(IN) Specifies the bindery object ID of the affected queue.
- jobNumber
-
(IN) Specifies the job number of the job being repositioned.
- newJobPos
-
(IN) Specifies the job's new position.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8996
-
SERVER_OUT_OF_MEMORY
- 0x89D0
-
ERR_Q_IO_FAILURE
- 0x89D1
-
ERR_NO_QUEUE
- 0x89D5
-
ERR_NO_Q_JOB
- 0x89D6
-
ERR_NO_Q_JOB_RIGHTS
- 0x89FE
-
BINDERY_LOCKED
- 0x89FF
-
Failure
Notices
newJobPos ranges from 1 to 250. Position 1 is the first position in
the queue and position 250 is the last position in a full queue. If a
specified position number
places the job beyond the current end of the queue, the job moves to the end
of the current queue.
When a job is moved in the queue, the positions of all job entries are updated
to reflect the change. Changing the position of a job being serviced has no effect on the service
of that job. Also, note that moving a job in the queue does not change
jobNumber, only its position.
Services
Queue Management
NCP calls
- 0x2222 23 17
-
Get File Server Information
- 0x2222 23 110
-
Change Queue Job Position (no 1000 user support)
- 0x2222 23 130
-
Change Queue Job Priority (3.11 or later)
References
NWChangeQueueJobEntry2(3nw),
NWGetQueueJobList2(3nw),
NWReadQueueJobEntry2(3nw),
NWRemoveJobFromQueue2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.