Data Queue APIs--Categories - FTP Directory Listing - IBM

Create User Queue (QUSCRTUQ) API
Create User Queue (QUSCRTUQ) API
Required Parameter Group:
1 Qualified user queue name Input Char(20)
2 Extended attribute Input Char(10)
3 Queue type Input Char(1)
4 Key length Input Binary(4)
5 Maximum message size Input Binary(4)
6 Initial number of messages Input Binary(4)
7 Additional number of messages Input Binary(4)
8 Public authority Input Char(10)
9 Text description Input Char(50)
Optional Parameter Group 1:
10 Replace Input Char(10)
11 Error code I/O Char(*)
Optional Parameter Group 2:
12 Domain Input Char(10)
13 Pointers Input Char(10)
Optional Parameter Group 3:
14 Number of queue extensions Input Binary(4)
15 Reclaim storage Input Char(1)
Threadsafe: Yes
The Create User Queue (QUSCRTUQ) API creates a user queue in either the user domain or the system
domain, based on the input parameters. A user-domain user queue can be directly manipulated with MI
instructions. If you are running at security level 40 or greater, you cannot directly manipulate a
system-domain user queue using MI instructions.
If the number of queue extensions is not specified, user queues can grow to a maximum of 16MB in
size, though some of that is used for the queue definition. If the number of queue extensions is specified
and non-zero, the queue will be extended by the number of additional messages specified until either the
number of queue extensions is reached or the storage limit of 32MB is reached.
The system can automatically extend user queues, so you should create a small queue and allow the
system to extend the queue as needed. Smaller queues provide better performance and use less storage.
However, the system does not automatically reduce the size of the queue if it is too large. If you specify
the additional number of messages as 0, the system does not extend the user queue you create when the
queue is full.
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quscrtuq.htm (1 of 9) [10/4/1999 2:33:25 PM]