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

Add User Index Entries (QUSADDUI) API
Note: If you add new entries with an entry length longer than the user index is expecting, the entries are
truncated to the right. No error is given.
If you are using a fixed length index and the entries you are adding are less than the fixed length,
you may get undesirable results. The entries are not padded with blanks before being entered into
the user index. The API checks the length of index entries parameter to ensure that the length you
pass is a multiple of the length of one index entry.
Authorities and Locks
User Index Library Authority
*EXECUTE
User Index Authority
*CHANGE
User Index Lock
*SHRUPD
Required Parameter Group
Returned library name
OUTPUT; CHAR(10)
The name of the library that contains the user index to which the entries were added if they were
added successfully. This parameter is not set if no entries were successfully added. This information
helps you identify the specific library used when *LIBL or *CURLIB is specified in the qualified
user index name parameter.
Number of entries added
OUTPUT; BINARY(4)
The number of entries successfully added to the specified user index. If an error is received while
processing the entries, this number indicates how many were added before the error occurred.
Qualified user index name
INPUT; CHAR(20)
The user index to which you want to add entries and the library in which it is located. The first 10
characters contain the user index name, and the second 10 characters contain the library name. You
can use these special values for the library name:
*CURLIB
The job's current library
*LIBL
The library list
Insert type
INPUT; BINARY(4)
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qusaddui.htm (2 of 6) [10/4/1999 2:33:37 PM]