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  AUTEXT(*YES)  is  specified.   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.

   AUTOEXT       A *YES/*NO value for  whether to automatically  extend
                 the  user space  if  an API  is  writing data  to  it.
                 *YES  is the  default.   *NO may  be specified  to not
                 auto extend.

   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