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.

Create User <strong>Queue</strong> (QUSCRTUQ) API<br />

Authorization list name<br />

The user queue is secured by the specified authorization list, and its public authority is set to<br />

*AUTL. The specified authorization list must exist on the system when this API is issued. If<br />

it does not exist, the create process fails, and an error message is returned to the application.<br />

*CHANGE<br />

The user has read, add, update, and delete authority to the user queue and can read the object<br />

description.<br />

*EXCLUDE<br />

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

*LIBCRTAUT<br />

The public authority for the user queue 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 queues 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 the user queue's contents but cannot change<br />

them.<br />

Text description<br />

INPUT; CHAR(50)<br />

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

Optional Parameter Group 1<br />

Replace<br />

INPUT; CHAR(10)<br />

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

*NO<br />

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

*YES<br />

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

The user queue being replaced is destroyed if both:<br />

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

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

contain the library QRPLOBJ.<br />

If the QRPLOBJ library is specified in the QALWUSRDMN system value, then the replaced<br />

user-domain user queue is moved to the QRPLOBJ library. If the user queue is in the system<br />

domain, it is moved to the QRPLOBJ library, which is cleared at system IPL. For details about<br />

authorities, ownership, and renaming, see the discussion of the REPLACE parameter in Appendix A<br />

of the CL Reference (Abridged) book.<br />

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

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

Saved successfully!

Ooh no, something went wrong!