The  Retrieve User  Text  command  retrieves  a user  text  description
based  on a user  profile name.   The  command is useful  if additional
information  is stored in  the text description of  the user profile or
as a sub  function when just  the description is needed.   The user  of
the command does  not need to be authorized to the  user profile.  Only
the text description is retrieved.

A typical series of commands would be:

             DCL        &TEXT *CHAR LEN(50)
              .
             RTVUSRTXT  USRPRF(xxx) TEXT(&TEXT)

The text description would be returned.

RTVUSRTXT escape messages you can monitor for
---------------------------------------------

      TAA9891    The user profile does not exist.

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

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

   USRPRF        The  user profile to retrieve the  text for.  The user
                 does not have  to be authorized  to the user  profile.
                 The  special   value  *CURRENT   may  be   entered  to
                 retrieve from the current user profile.

   TEXT          The text description of the user profile.

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

Because  the command returns a  variable, it may  only be used  in a CL
program.

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

The following TAA Tools must be on your system:

     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   RTVUSRTXT     *CMD                   TAASEGD       QATTCMD
   TAASEGDC      *PGM       CLP         TAASEGDC      QATTCL