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 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]

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

Saved successfully!

Ooh no, something went wrong!