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

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Remove User Index Entries (QUSRMVUI) API<br />

OUTPUT; ARRAY of CHAR(8)<br />

A data structure that contains entry lengths and entry offsets for all entries that were found that met<br />

the remove criteria parameter. An entry length and entry offset exist for every entry returned in the<br />

entries removed parameter. These entry lengths and entry offsets are used to parse through the<br />

entries removed parameter. If the length of entries removed parameter is 0, this information will not<br />

be returned.<br />

The size of the entry lengths and entry offsets parameter should be at least:<br />

8 + (the maximum number of entries parameter * 8)<br />

You must provide enough space in both the entries removed and the entry lengths and offset<br />

parameter for this API to return complete information to you.<br />

You will not receive complete information in the following two situations.<br />

❍ You provide enough space in the entries removed parameter for the API to return all index<br />

entries removed, but there is not enough space in the entry lengths and entry offset parameter<br />

to return the lengths and offsets for all entries. You will be unable to parse through all of the<br />

entries in the entries removed parameter. Check the bytes returned and bytes available fields<br />

in the entry lengths and entry offsets parameter to ensure the information is complete.<br />

❍ You provide enough space in the entry lengths and entry offsets parameter to return all<br />

lengths and offsets, but there is not enough space in the entries removed parameter to return<br />

all index entries removed. Some of the entry lengths and entry offsets will not be valid; they<br />

will refer to index entries that could not be returned to you. Check the bytes returned and<br />

bytes available fields in the entries removed parameter to ensure that the information is<br />

complete.<br />

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

Length of entry lengths and entry offsets<br />

INPUT; BINARY(4)<br />

The length of the entry lengths and entry offsets. If the length is longer than the entry lengths and<br />

entry offsets parameter, the results may not be predictable. The minimum length is 8. If the length of<br />

entries removed parameter is 0, which means you do not want the entries removed to be returned,<br />

this parameter is ignored.<br />

Returned library name<br />

OUTPUT; CHAR(10)<br />

The name of the library that contains the user index from which the entries were removed. If the<br />

entries are successfully removed from the user index, the name of the library that contained the user<br />

index entries is returned. This parameter is not set if an error occurs.<br />

Qualified user index name<br />

INPUT; CHAR(20)<br />

The user index from which you want to remove entries, and the library in which it is located. The<br />

first 10 characters contain the user index name, and the second 10 characters contain the library<br />

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

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

Saved successfully!

Ooh no, something went wrong!