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

Add User Index Entries (QUSADDUI) API
Add User Index Entries (QUSADDUI) API
Required Parameter Group:
1 Returned library name Output Char(10)
2 Number of entries added Output Binary(4)
3 Qualified user index name Input Char(20)
4 Insert type Input Binary(4)
5 Index entries Input Char(*)
6 Length of index entries Input Binary(4)
7 Entry lengths and offsets Input Array(*)
of
Char(8)
8 Number of entries Input Binary(4)
9 Error code I/O Char(*)
Threadsafe: Yes
The Add User Index Entries (QUSADDUI) API inserts one or more entries into the user index by the
insert type. Each entry is inserted into the index at the appropriate location based on the binary value of the
entry. No other collating sequence is supported. Every entry added causes the number of entries added
parameter to be incremented by 1; you can retrieve the current number of entries added by using the
Retrieve User Index Attributes (QUSRUIAT) API.
When you request to add multiple entries to a user index, the request may be partially successful in the
following situations:
● One or more of the entries you requested to add already exists in the index.
● The index becomes full as the entries are added.
● The user profile storage limit is exceeded as entries are added.
● One or more of the entry lengths or offsets are not valid.
When an error occurs, you should check the number of entries added parameter to see if all entries were
successfully added. If the number of entries added parameter and the number of entries parameter are not
equal, then all entries were not added.
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qusaddui.htm (1 of 6) [10/4/1999 2:33:37 PM]