Data Queue APIs--Categories - FTP Directory Listing - IBM
Data Queue APIs--Categories - FTP Directory Listing - IBM
Data Queue APIs--Categories - FTP Directory Listing - IBM
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]