NWCreateQueueFile2(3nw)


NWCreateQueueFile2 -- enters a new job on the queue and creates a job file

Synopsis

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

NWCCODE N_API NWCreateQueueFile2 (NWCONN_HANDLE conn, nuint32 queueID, 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's object ID for the queue.

job
(IN/OUT) Points to NWQueueJobStruct which stores the information about the job.

fileHandle
(OUT) Points to the file handle.

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

0x89FC
NO_SUCH_OBJECT

0x89FF
Failure

Notices

After creating a job file, NWCreateQueueFile2 attaches it to a special file opened at the workstation. The special file handle is returned in fileHandle.

The requesting workstation provides the Bindery ID of the queue the job should be appended to, as well as the address of the entire 256-byte job record (NWQueueJobStruct).

NWCreateQueueFile2 fills in the job record and returns the record (minus jobDescription and clientRecordArea) to the requesting workstation. After NWCreateQueueFile2 is called, all fields are initialized.

NWCreateQueueFile2 can be used in conjunction with NWReadQueueJobEntry2 to change a portion of the job's entry record. However, if the target entry is already being serviced, NWChangeQueueJobEntry2 returns Q_SERVICING and makes no changes to the job's entry record.

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 104 Create Queue Job And File (OS/2 only; no 1000 user support)
0x2222 23 121 Create Queue Job And File (OS/2 only 3.11 or later)
0x2222 66 File Close

References

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