NWServiceQueueJob2(3nw)


NWServiceQueueJob2 -- allows queue server to select new job for servicing

Synopsis

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

NWCCODE N_API NWServiceQueueJob2 (NWCONN_HANDLE conn, nuint32 queueID, nuint16 targetJobType, NWQueueJobStruct N_FAR * job, NWFILE_HANDLE N_FAR * fileHandle);

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 jobs are being serviced.

targetJobType
(IN) Specifies the job type to be serviced.

job
(OUT) Points to NWQueueJobStruct containing the job record of the next available job returned.

fileHandle
(OUT) Points to the file handle of the file associated with the job to be serviced.

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_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

The requesting workstation must have previously established itself as a queue server for the target queue.

NWServiceQueueJob2 will fail if there are not enough directory handles available.

The file handle returned is appropriate for the platform the API is written for. This file handle may be used for access to the attribute value through standard file I/O with the handle. This includes closing the file as well as reading and writing to the file.

For Windows, call _lread, _lwrite, _lclose, and _lseek rather than calling the standard file I/O functions. Calling standard file I/O functions in Windows returns unexpected results.

Services

Queue Management

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 108 Read Queue Job Entry (no 1000 user support)
0x2222 23 113 Serivce Queue Job (no 1000 user support)
0x2222 23 120 Get Queue Job File Size
0x2222 23 122 Read Queue Job Entry (3.11 or later)
0x2222 23 124 Service Queue Job
0x2222 23 125 Service Queue Job (3.11 or later)
0x2222 23 135 Get Queue Job File Size
0x2222 66 - File Close

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   108   Read Queue Job 
                     Entry (no 1000 
                     user support) 
 0x2222   23   113   Serivce Queue 
                     Job (no 1000 
                     user support) 
 0x2222   23   120   Get Queue Job 
                     File Size 
 0x2222   23   122   Read Queue Job 
                     Entry (3.11 or 
                     later) 
 0x2222   23   124   Service Queue 
                     Job 
 0x2222   23   125   Service Queue 
                     Job (3.11 or 
                     later) 
 0x2222   23   135   Get Queue Job 
                     File Size 
 0x2222   66   -     File Close 

References

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