TAA Tools

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.


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


The following TAA Tools must be on your system:

     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message


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

Added to TAA Productivity tools January 15, 2004

Home Page Up to Top