RTVHOMDIR       RETRIEVE HOME DIRECTORY                TAASEGE

 The Retrieve Home  Directory command retrieves the home  directory from
 the user  profile for a  named user.   You must have  *USE authority to
 the  user profile  to retrieve  the information  for a profile  that is
 not your  own.  The  information is  not available on  RTVUSRPRF.   The
 RtvUsrInf API is used to extract the information.

 A typical series of commands would be:

              DCL           &HOMDIR *CHAR LEN(2048)
               .
              RTVHOMDIR     HOMDIR(&HOMDIR)

 RTVHOMDIR escape messages you can monitor for
 ---------------------------------------------

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

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

    USRPRF        The name  of the user  profile to retrieve from.   The
                  default is *CURRENT for the current user.

    HOMDIR        The  home directory  from the  user profile.   This is
                  an optional  return  variable  that if  used  must  be
                  declared as *CHAR LEN(2048).

    HOMDIRLEN     The  length  of  the  directory entry.    This  is  an
                  optional   return  variable  that  if   used  must  be
                  declared as *DEC LEN(7 0).

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

 You must have  *USE authority to  a retrieve from a  user profile  that
 is not your own.

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

 The following TAA Tools must be on your system:

      SNDESCINF       Send escape information

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

 None, the tool is ready to use.

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

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

    RTVHOMDIR     *CMD                   TAASEGE       QATTCMD
    TAASEGEC      *PGM       CLP         TAASEGEC      QATTCL
    TAASEGER      *PGM       RPGLE       TAASEGER      QATTRPG

Added to TAA Productivity Tools January 15, 2004


Home Page

Powered by AS/400Powered by AS/400 Last modified on July 15, 2010 © 1995, 2010 - Jim Sloan, Inc.