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.

Create User Index (QUSCRTUI) API<br />

description.<br />

*EXCLUDE<br />

The user cannot access the user index in any way.<br />

*LIBCRTAUT<br />

The public authority for the user index is taken from the CRTAUT value for the target library<br />

when the object is created. If the CRTAUT value for the library changes later, that change<br />

does not affect user indexes already created. If the CRTAUT value contains an authorization<br />

list name and that authorization list secures an object, do not delete the list. If you do, the next<br />

time you call this API with the *LIBCRTAUT parameter, it will fail.<br />

*USE<br />

The user can read the object description and contents but cannot change the user index.<br />

Text description<br />

INPUT; CHAR(50)<br />

A brief description of the user index.<br />

Optional Parameter Group 1<br />

Replace<br />

INPUT; CHAR(10)<br />

Whether you want to replace an existing user index. Valid values for this parameter are:<br />

*NO<br />

Do not replace an existing user index of the same name and library. *NO is the default value.<br />

*YES<br />

Replace an existing user index of the same name and library.<br />

If the user index already exists, you can replace it with a new user index of the same name and<br />

library. The new user index is subject to the same authorities. The user index being replaced is<br />

destroyed if both:<br />

❍ The allow user domain (QALWUSRDMN) system value is not set to *ALL or does not<br />

contain the QRPLOBJ library.<br />

❍ The user index you are replacing is in the user domain.<br />

If the user index is in the system domain, it is moved to the QRPLOBJ library. If QALWUSRDMN<br />

is set to *ALL or if it contains QRPLOBJ, the replaced user index is moved to QRPLOBJ, which is<br />

cleared at system IPL. For details about authorities, ownership, and renaming, see the discussion of<br />

the REPLACE parameter in Appendix A of the CL Reference (Abridged) book.<br />

Error code<br />

I/O; CHAR(*)<br />

The structure in which to return error information. For the format of the structure, see Error Code<br />

Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the<br />

application.<br />

http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quscrtui.htm (5 of 10) [10/4/1999 2:33:41 PM]

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

Saved successfully!

Ooh no, something went wrong!