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.