Data Queue APIs--Categories - FTP Directory Listing - IBM

Create User Space (QUSCRTUS) API
truncated using the Change User Space Attributes (QUSCUSAT) API of the Modify Space (MODS) MI
instruction (for user-domain user spaces). (The MODS instruction will not work on system-domain user
spaces if the security level of the system is 40 or greater.)
Note: For performance reasons, the *USRSPC object is created before checking to see if it exists in the
library specified for the qualified user space name. If you have an application using this API repeatedly,
even if you are using *NO for the replace parameter, permanent system addresses will be used. Change
User Space Attributes (QUSCUSAT) API or the Modify Space (MODS) MI instruction (for user-domain
user spaces). (The MODS instruction will not work on system-domain user spaces if the security level of
the system is 40 or greater.)
Authorities and Locks
User Space Authority
*OBJMGT, *OBJEXIST, and *READ. These authorities are required only if the replace parameter
is used and if there is an existing user space to replace.
User Space Library Authority
*READ and *ADD.
User Space Lock
*EXCL. This applies to both the user space being created and an existing user space being replaced.
Required Parameter Group
Qualified user space name
INPUT; CHAR(20)
The first 10 characters contain the user space name, and the second 10 characters contain the name
of the library where the user space is located. The only special value supported for the library name
is *CURLIB.
User spaces created in the QTEMP and QRPLOBJ libraries are not forced to permanent storage;
they are deleted when those libraries are cleared at sign-off and system IPL, respectively.
Extended attribute
INPUT; CHAR(10)
The extended attribute of the user space. For example, an object type of *FILE has an extended
attribute of PF (physical file), LF (logical file), DSPF (display file), SAVF (save file), and so on.
The extended attribute must be a valid *NAME. You can enter this parameter in uppercase,
lowercase, or mixed case. The API converts it to uppercase.
Initial size
INPUT; BINARY(4)
The initial size of the user space being created. This value must be from 1 byte to 16, 776, 704
bytes.
Initial value
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quscrtus.htm (2 of 7) [10/4/1999 2:34:54 PM]