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.