NWGetQueueJobList2(3nw)
NWGetQueueJobList2 --
returns a list of all the jobs currently in a queue
Synopsis
#include <nwqms.h>
or
#include <nwcalls.h>
NWCCODE N_API NWGetQueueJobList2
(NWCONN_HANDLE conn,
nuint32 queueID,
nuint32 queueStartPos,
QueueJobListReply 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 whose job list is
being reported.
- queueStartPos
-
(OUT) Receives the job number from which to start reading jobs.
- job
-
(OUT) Points to QueueJobListReply containing the job numbers of all the jobs in the queue.
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_Q_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
-
Failure
Notices
When used in conjunction with NWReadQueueJobEntry2, NWGetQueueJobList2 allows an application to retrieve information about all the jobs in a given queue.
Because the QMS environment is multi-threaded, the positioning, number, and
type of jobs in the queue can change between consecutive calls.
NWGetQueueJobList2 allows a workstation to determine how many jobs
are in the queue at a particular instant and the job number of each. If a
subsequent call to read
information about a job in the queue fails with NO_Q_JOB, the requesting workstation can assume either the job was deleted from the queue or its service was completed.
NWGetQueueJobList2 will only read in 125 jobs at a time even though the job array is defined as 250. If you wish to read a job that is above 125, set
queueStartPos to 126 and allow NWGetQueueJobList2 to read job numbers 126 through 251.
The workstation calling NWGetQueueJobList2 must be security
equivalent to one of the objects listed in the queue's Q_USERS or
Q_OPERATORS group properties.
Services
Queue Management
NCP calls
- 0x2222 23 17
-
Get File Server Information
- 0x2222 23 107
-
Get Queue Job List (no 1000 user support)
- 0x2222 23 129
-
Get Queue Job List (3.11 and above)
References
NWChangeQueueJobEntry2(3nw),
NWChangeQueueJobPosition2(3nw),
NWReadQueueJobEntry2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.