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.