TAA Tools

 CRTUSRSPC       CREATE USER SPACE                      TAASPCA

 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

Added to TAA Productivity Tools April 1, 1995


Home Page

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.