The Find User  Attribute command finds  objects that have a  named user
attribute  or any user  attribute.  A  listing is displayed  or output.
User attributes allow a further identification of objects.

You  must have *ALLOBJ special authority  to use the special value *ALL
as the library qualifier.

A typical command would be:

             FNDUSRATR  USRATR(ABC) OBJ(XXX/*ALL)

All objects in  the named library  with a user  attribute of ABC  would
be displayed.

FNDUSRATR escape messages you can monitor for
---------------------------------------------

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

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

   USRATR        The  user attribute to  be searched  for.   A specific
                 value may be entered.

                 *ALL  may be specified  to include  any user attribute
                 as well as blanks.

                 *NONBLANK may be  specified to  include any  non-blank
                 user attribute.

   OBJ           The  qualified name  of  the objects  to be  searched.
                 The  object may  be a specific  name, a  generic name,
                 or *ALL  for  all  objects in  the  qualified  library
                 name.

                 The library  name may  be a  specific name, a  generic
                 name,  *ALL,  *LIBL,   or  *CURLIB.    You  must  have
                 *ALLOBJ special authority to use *ALL.

   OBJTYPE       The  object  type to  be searched  for.   *ALL  is the
                 default.    Use  the  prompter  to  see  the  list  of
                 supported values.

   OUTPUT        How  to output  the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  If  the display  is ended with  F3/F12
                 or the  Enter key, the  spooled file is  deleted after
                 it  is displayed.   To  retain  the spooled  file, you
                 may use the the  System Request 'Cancel' function  and
                 the spooled file will exist in a HLD status.

                 If  the command  is  entered  in  batch or  *PRINT  is
                 specified,  the spooled file  is output  and retained.


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

You  must have *ALLOBJ special authority  to use the special value *ALL
as the library qualifier.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CVTOBJD4        Convert object description 4
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   FNDUSRATR     *CMD                   TAAOBML       QATTCMD
   TAAOBMLC      *PGM       CLP         TAAOBMLC      QATTCL
   TAAOBMLR      *PGM       RPG         TAAOBMLR      QATTRPG