NWCreateQueue(3nw)


NWCreateQueue -- creates a new queue and its associated Q_DIRECTORY property in the Bindery and file system of the specified NetWare server

Synopsis

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

NWCCODE N_API NWCreateQueue (NWCONN_HANDLE conn, pnstr8 queueName, nuint16 queueType, nuint8 dirPath, pnstr8 path, pnuint32 queueID);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

queueName
(IN) Points to the name of queue to be created (48 characters).

queueType
(IN) Specifies the number indicating the Bindery object ID type for the new queue.

dirPath
(IN) Specifies the NetWare directory handle pointing to the directory in which the queue's property is to be created (0 if the queue subdirectory name will be stored in Q_DIRECTORY).

path
(IN) Points to the absolute path or a path relative to the NetWare directory handle that will contain the queue files (stored in Q_DIRECTORY).

queueID
(OUT) Points to the new queue ID.

Return values

0x0000
SUCCESSFUL

0x8996
SERVER_OUT_OF_MEMORY

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

0x89EE
OBJECT_ALREADY_EXISTS

0x89FF
Failure

Notices

Q_DIRECTORY is determined by combining dirPath and path. NWCreateQueue then creates a new subdirectory in this directory. The subdirectory's name is the 8-character ASCII hexadecimal representation of the new queue's Bindery object ID. QMS uses this directory to store queue files until they are serviced.

Next, NWCreateQueue creates the following group properties:

   Q_SERVERS 
   Q_OPERATORS 
   Q_USERS 

Only SUPERVISOR or a Bindery object that is security equivalent to SUPERVISOR can create a queue.

dirPath of 0 and SYS:SYSTEM is standard usage.

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 100 Create Queue

References

NWDestroyQueue(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.