30.06.2013 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Add User Index Entries (QUSADDUI) API<br />

The type of insert to be performed against all entries that are to be added. Valid values are:<br />

1<br />

Insert unique argument<br />

2<br />

3<br />

This value is only valid for nonkeyed user indexes. If the entry is already in the index or the<br />

index entries are keyed, an error is returned.<br />

Insert with replacement<br />

This value requests to replace the nonkey portion of the index entry if the key is already in the<br />

user index. It is only valid for keyed user indexes. If the entry does not exist, it will be<br />

inserted into the user index. If the index entries are nonkeyed, an error is returned.<br />

Insert without replacement<br />

This value requests to insert the entry only if the key is not already in the user index. It is only<br />

valid for a keyed user index. If the entry does not exist, it will be inserted into the user index.<br />

If the entry is already in the index or the index entries are nonkeyed, an error is returned.<br />

Index entries<br />

INPUT; CHAR(*)<br />

The actual entry or entries to be added to the user index. If the user index contains fixed length<br />

entries, this parameter is processed using the entry length specified when the user index was created.<br />

If the user index contains variable length entries, this parameter is processed using the information<br />

contained in the entry lengths and entry offsets parameter.<br />

When using an index that contains fixed length entries, this parameter should be the same length as<br />

the length of index entries parameter.<br />

Length of index entries<br />

INPUT; BINARY(4)<br />

The length of the index entries parameter. This value must be greater than 0.<br />

Entry lengths and entry offsets<br />

INPUT; ARRAY(*) of CHAR(8)<br />

If the user index contains variable length entries, this parameter is a data-structure array that is used<br />

to parse through the index entries parameter. In this case, an entry length and entry offset need to be<br />

provided for all entries that are to be added. This parameter is ignored for user indexes containing<br />

fixed length entries.<br />

The size of the entry lengths and entry offsets parameter must be at least eight times the number of<br />

entries parameter; otherwise, an error will be returned.<br />

See Format for Entry Lengths and Entry Offsets for details on the data structure.<br />

Number of entries<br />

INPUT; BINARY(4)<br />

http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qusaddui.htm (3 of 6) [10/4/1999 2:33:37 PM]

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!