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.