NWAbortServicingQueueJob2(3nw)


NWAbortServicingQueueJob2 -- signals that previously accepted job cannot be completed successfully

Synopsis

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

NWCCODE N_API NWAbortServicingQueueJob2 (NWCONN_HANDLE conn, nuint32 QueueID, nuint32 JobNumber, NWFILE_HANDLE fileHandle);

Description

The parameters are as follows:

conn
(IN) Specifies the job server connection handle.

QueueID
(IN) Specifies the bindery object ID for the queue in which the aborted job is located.

JobNumber
(IN) Specifies the job number of the job to abort (on servers previous to 3.11, the top 16 bits are ignored).

fileHandle
(IN) Specifies the file handle of the file associated with the aborted job.

Return values

0x0000
SUCCESSFUL

0x8996
SERVER_OUT_OF_MEMORY

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

NWAbortServicingQueueJob2 is NetWare® 3.11+ compatible.

NWAbortServicingQueueJob2 closes the job file and resets the job server's access rights to their original (login) values. Only a queue server that has previously accepted a job for service can call NWAbortServicingQueueJob2.

An aborted job returns to its former position in the job queue if its QF_ENTRY_RESTRART flag (bit 0x10 of jobControlFlags in QueueJobStruct) is set. For example, if a job is at the beginning of the queue before being called, it returns to the beginning of the queue after being aborted. Therefore, an aborted job could remain in the queue and be serviced and aborted again and again. A job should not be aborted because of an error in the job's format or requests. Instead, call NWFinishServicingQueueJob2 to remove such a job from the queue.

Also, if a job attempts to access data without proper security clearance and is aborted, the job returns to the end of the queue. To remove such a job from the job queue, call NWFinishServicingQueueJob2.

A job should be aborted only if some temporary internal problem prevents it from completing. For example, a print job might be aborted if the printer has a paper jam. After the paper jam is corrected, the job server can service the job successfully.

Services

Queue Management

NCP calls

0x2222 66
File Close

0x2222 23 17
Get File Server Information

0x2222 23 115
Abort Servicing Queue Job (no 1000 user support)

0x2222 23 132
Abort Servicing Queue Job (3.11 and above)

References

NWChangeQueueJobEntry2(3nw), NWCreateQueueFile2(3nw), NWFinishServicingQueueJob2(3nw), NWReadQueueJobEntry2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.