NWCloseFileAndAbortQueueJob2(3nw)


NWCloseFileAndAbortQueueJob2 -- allows the workstation to close a queue job and abort it

Synopsis

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

NWCCODE N_API NWCloseFileAndAbortQueueJob2 (NWCONN_HANDLE conn, nuint32 queueID, nuint32 jobNumber, NWFILE_HANDLE fileHandle);

Description

The parameters are as follows:

conn
(IN) Specifies the queue server connection handle.

queueID
(IN) Specifies the bindery object ID of the queue.

jobNumber
(IN) Specifies the job entry number of the job whose service is being aborted.

fileHandle
(IN) Specifies the aborted job's file handle returned by NWCreateQueueFile2.

Return values

0x0000
SUCCESSFUL

0x8999
DIRECTORY_FULL

0x89D0
ERR_Q_IO_FAILURE

0x89D1
ERR_NO_QUEUE

0x89D2
ERR_NO_Q_SERVER

0x89D3
ERR_NO_Q_RIGHTS

0x89D4
ERR_QUEUE_FULL

0x89D5
ERR_NO_Q_JOB

0x89D6
ERR_NO_Q_JOB_RIGHTS

0x89D7
ERR_Q_IN_SERVICE

0x89D8
ERR_Q_NOT_ACTIVE

0x89D9
ERR_Q_STN_NOT_SERVER

0x89DA
ERR_Q_HALTED

0x89DB
ERR_Q_MAX_SERVERS

0x89FF
HARDWARE_FAILURE

Notices

jobNumber contains the job number returned by the QMS when the job was originally entered in the queue. The file associated with the job number is closed, and the job is deleted from the queue.

Only the workstation creating the queue job or a queue operator can call NWCloseFileAndAbortQueueJob2.

Services

Queue Management

NCP calls

0x2222 66 File Close
0x2222 23 17 Get File Server Information
0x2222 23 106 Remove Job From Queue (no 1000 user support)
0x2222 23 128 Remove Job From Queue (3.11 and above)

References

NWCloseFileAndStartQueueJob2(3nw), NWCreateQueueFile2(3nw), NWRemoveJobFromQueue2(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.