The Create User Space command provides a command interface to the
program QUSCRTUS provided by i5/OS for creating a user space.
A typical command is entered as:
CRTUSRSPC USRSPC(QTEMP/SPACE1) TEXT('Space for members')
User spaces are used for the API interfaces to the system to allow a
fast access to such things as object and member lists. A user space
is also a general purpose user object.
For an example of using a user space and the CRTUSRSPC command, see
the TAA tool RTVUSRSPCI.
Command parameters *CMD
------------------
USRSPC The qualified name of the user space to be created.
EXTATR Extended attribute. A 10 byte field to allow a sub
attribute (like PF or LF) to a user space. The
default is *NONE which causes an all blank extended
attribute. The value is only for user purposes.
INLSIZE Initial size. The default is 2000 bytes. You
should use the default unless you are using
CRTUSRSPC for your own application use (other than
when using the system API support). When using the
system API support, the system will automatically
extend the size as required up to a maximum of 16
MB. If this limit is exceeded the API function will
fail with an escape message.
If you are using a user space object for your own
application, you should probably set the size as the
maximum needed. The maximum allowed is 16,773,120.
INLVALUE The value to initialize the space to. The default
is a blank (X'40').
AUT The authority to the user space. The normal values
of *CHANGE, *USE, *ALL and *EXCLUDE are valid.
*CHANGE is the default.
DELETE A *YES/*NO parameter that determines if an existing
space of the same name should be deleted. The
default is *NO. The *YES value is useful for
general purpose programs that are creating spaces in
QTEMP.
DOMAIN The domain into which the user space is created.
The default is *DEFAULT which allows the system to
determine the domain. The system determines the
domain by using the QALWUSRDMN system value and
several rules. See the QUSCRTUS API for the chart
which determines how the domain is determined.
*SYSTEM may be specified to create the user space in
the system domain.
*USER may be specified to create the user space in
the user domain if allowed by the QALWUSRDMN system
value.
TEXT The text description of the object. The default is
*BLANK which produces and all blank description.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
SNDCOMPMSG Send completion message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CRTUSRSPC *CMD TAASPCA QATTCMD
TAASPCAC *PGM CLP TAASPCAC QATTCL
|
