TAA Tools
CRTUSRIDX       CREATE USER INDEX                      TAAIDXB

The Create User  Index command creates  a user index  (*USRIDX) object.
Only a  fixed length keyed  user index may  be created.   The length of
an  index entry may  be from 1  to 2000 bytes.   The user  index may be
used by  other TAA  tools or  system functions.   The  QUSCRTUI API  is
used.

A typical command would be:

            CRTUSRIDX     USRIDX(xxx) ENTRYLEN(100) KEYLEN(10)

The user index would  be created with a length of 100  and a key length
of 10.

When an  entry is written to the user index,  it may be up to 100 bytes
in length and the first 10 bytes are assumed to be the key.

CRTUSRIDX escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   USRIDX        The qualified name  of the user  index to be  created.
                 A  library  name  must  be specified  or  the  special
                 value *CURLIB.

                 Only a  fixed length keyed user  index may be created.

   ENTRYLEN      The entry length  of each  entry.  The  value must  be
                 between 1 and 2000.

   KEYLEN        The length of the  key to each entry.   The value must
                 be between  1 and 2000  and cannot exceed  the size of
                 the  ENTRYLEN value.   The  key makes  up the  first n
                 bytes of an entry.

   EXTATTR       The external  attribute assigned to  the object.   The
                 default is *NONE for no attribute.

   OPTIMIZE      How the  use of  the index should  be optimized.   The
                 default is *RANDOM for random operations.

                 *SEQ  may  be  specified  to  optimize for  sequential
                 operations.

   TEXT          The text description of the object.

   REPLACE       Whether the object  should be  replaced or  not.   The
                 default is  *NO meaning  the create  will fail if  the
                 user index already exists.

                 *YES  may be  specified to  replace  the object  if it
                 already exists.

   AUT           The authorization  to  the  object.   The  default  is
                 *LIBCRTAUT meaning  the  authority is  taken from  the
                 library object.

                 *ALL,  *CHANGE,  *EXCLUDE, or  *USE  may be  specified
                 which   have  the   same  meaning   as  system  CRTxxx
                 commands.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     USRIDX          User index

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CRTUSRIDX     *CMD                   TAAIDXB       QATTCMD
   TAAIDXBC      *PGM       CLP         TAAIDXBC      QATTCL
   TAAIDXBR      *PGM       RPGLE       TAAIDXBR      QATTRPG

Structure
---------

CRTUSRIDX     Cmd
   TAAIDXBC     CL Pgm
     TAAIDXBR     RPG Pgm runs in *NEW activation group
					

Added to TAA Productivity tools June 15, 2004


Home Page Up to Top