Data Queue APIs--Categories - FTP Directory Listing - IBM
Data Queue APIs--Categories - FTP Directory Listing - IBM
Data Queue APIs--Categories - FTP Directory Listing - IBM
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 Space (QUSCRTUS) API<br />
Whether you want to replace an existing user space.<br />
Valid values for this parameter are:<br />
*NO<br />
Do not replace an existing user space of the same name and library. *NO is the default value.<br />
*YES<br />
Replace an existing user space of the same name and library.<br />
If the user space already exists, it is replaced by a new user space of the same name and library, and<br />
is subject to the same authorities. The user space being replaced is destroyed if both:<br />
❍ The allow user domain (QALWUSRDMN) system value is not set to *ALL or does not<br />
contain the library QRPLOBJ.<br />
❍ The user space you are replacing is in the user domain.<br />
If the user space is in the system domain, it is moved to QRPLOBJ. If QALWUSRDMN is set to<br />
*ALL or if it contains QRPLOBJ, the replaced user space is moved to QRPLOBJ, which is cleared<br />
at system IPL. For details about authorities, ownership, and renaming, see the discussion of the<br />
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 />
Optional Parameter Group 2<br />
Domain<br />
INPUT; CHAR(10)<br />
The domain into which the user space is created. If this parameter is not specified, the value of<br />
*DEFAULT is assumed by the API. Valid values for this parameter are:<br />
*DEFAULT<br />
Allows the system to decide into which domain the object should be created.<br />
*SYSTEM<br />
Creates the user space object into the system domain. The API can always create a user space<br />
into the system domain regardless of the security level in effect. However, you must use <strong>APIs</strong><br />
to access system-domain user spaces if you are running at security level 40 or greater.<br />
*USER<br />
Attempts to create the user space object into the user domain. This is not always possible. If<br />
the library you are creating the user space into does not appear in the QALWUSRDMN<br />
system value, the API cannot create the user space into the user domain. An error will be<br />
returned.<br />
The API uses the following values to determine into which domain to create the user space. The<br />
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quscrtus.htm (4 of 7) [10/4/1999 2:34:54 PM]