The Retrieve  User  Profile Nbr  2 command  allows a  user to  retrieve
basic  information about a  user profile even  though he does  not have
*USE  authority  to  the profile.    About  half of  the  return values
available  on  the  system  RTVUSRPRF  command  are  available  on  the
RTVUSRPRF2 command.

The user  must be  authorized to the  TAARTVUSR2 authorization  list to
use the command.

A typical command would be:

                RTVUSRPRF    USRPRF(xxxx) TEXT(&TEXT)

This would return the Text description of the named profile.

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

   USRPRF        The user profile name to be retrieved.

   STGUSED       The  amount  of  storage  used.    An  optional return
                 variable  that  if  used  must  be  declared  as  *DEC
                 LEN(15 0).

   JOBD          The  Job Description  specified.   An optional  return
                 variable  that  if  used  must  be  declared as  *CHAR
                 LEN(10).

   JOBDLIB       The Job Description  library specified.   An  optional
                 return  variable that  if  used  must be  declared  as
                 *CHAR LEN(10).

   GRPPRF        The Group  profile name.  An  optional return variable
                 that if used must be declared as *CHAR LEN(10).

   OWNER         The   Owner  specified   for  Group   Profile  created
                 objects.   An optional  return variable  that if  used
                 must be declared as *CHAR LEN(10).

   GRPAUT        The  authority  granted  to   the  Group  Profile  for
                 created  objects.   An  optional return  variable that
                 if used must be declared as *CHAR LEN(10).

   ACGCDE        The Accounting  code.   An  optional  return  variable
                 that if used must be declared as *CHAR LEN(15).

   MSGQ          The Message queue  assigned to the user.   An optional
                 return  variable  that if  used  must  be declared  as
                 *CHAR LEN(10).

   MSGQLIB       The Message queue  library assigned to  the user.   An
                 optional  return  variable   that  if  used   must  be
                 declared as *CHAR LEN(10).

   OUTQ          The  Output queue.   An optional return  variable that
                 if used must be declared as *CHAR LEN(10).

   OUTQLIB       The   Output  queue  library.     An  optional  return
                 variable  that if  used  must  be  declared  as  *CHAR
                 LEN(10).

   TEXT          The  User  profile  text  description.    An  optional
                 return  variable  that  if used  must  be  declared as
                 *CHAR LEN(50).

   USRCLS        The User class  of the  profile.   An optional  return
                 variable  that  if  used  must be  declared  as  *CHAR
                 LEN(10).

   STATUS        The  status  of  the  profile.    An  optional  return
                 variable that  if  used  must  be  declared  as  *CHAR
                 LEN(10).   A value  of *ENABLED  or *DISABLED will  be
                 returned.

   PWDNONE       Whether  the profile  has been  set  to *NONE  for the
                 password.   An  optional return variable  that if used
                 must be  declared  as *CHAR  LEN(4).   A  *YES or  *NO
                 will be returned.

   CURLIB        The  Current  library  specified  for the  user.    An
                 optional   return  variable  that  if   used  must  be
                 declared as *CHAR LEN(10).

   DLVRY         The  Message  Queue  Delivery  mode  specified.     An
                 optional  return   variable  that  if  used   must  be
                 declared as *CHAR LEN(10).

   PRTDEV        The  Print Device assigned  to the user.   An optional
                 return variable  that  if  used must  be  declared  as
                 *CHAR LEN(10).

   GRPAUTTYP     The Group Authority  Type specified for the user.   An
                 optional  return   variable  that  if   used  must  be
                 declared as *CHAR LEN(10).

   ASTLVL        The  Assistance  Level  specified for  the  user.   An
                 optional  return  variable   that  if  used  must   be
                 declared as *CHAR LEN(10).

   LMTCPB        The Limited  Capabilities specified for the  user.  An
                 optional   return  variable  that   if  used  must  be
                 declared as *CHAR LEN(10).

   SUPGRPPRF     The Supplemental  Group  Profiles  specified  for  the
                 user.  An  optional return variable that  if used must
                 be declared as *CHAR LEN(150).

   PRVSIGN       The  Previous Signon date and  time for the  user.  An
                 optional  return  variable  that   if  used  must   be
                 declared as  *CHAR  LEN(13).   If the  user has  never
                 signed on, the return value will be blank.

   ACTJOB        A *YES/*NO  return value for  whether the user  has an
                 active   job  on  the  system.    An  optional  return
                 variable  that  if used  must  be  declared  as  *CHAR
                 LEN(4).

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

The user must be authorized to the TAARTVUSR2 authorization list.

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

The following TAA Tools must be on your system:

     CHKTAAOWN       Check TAA owner
     RSNLSTMSG       Resend last message
     RTVJOBSTS       Retrieve job status
     RTVPWDSTS       Retrieve password status

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

None, the tool is ready to use.

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

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

   RTVUSRPRF2    *CMD                   TAASEDL       QATTCMD
   TAASEDLC      *PGM       CLP         TAASEDLC      QATTCL