The Copy User Profile  3 command assists in duplicating  a user profile
from  one system to  another.  The  DSPUSRPRF OUTFILE function  must be
used  to  capture the  information  from one  or  more profiles  on the
source system.    The outfile  must  then be  transferred to  a  target
system.   The  CPYUSRPRF3 command  may  then be  used to  create a  new
profile based on the existing information.

If  you  periodically capture  the  DSPUSRPRF information  on  a single
system, CPYUSRPRF3 can  also be used  to re-create a  profile that  has
been deleted.

You must have *SECADM authority to use CPYUSRPRF3.

On the source system  you would enter the command  for one, generic, or
*ALL user profiles.

            DSPUSRPRF  USRPRF(xxx) OUTFILE(yyy/zzz)

TYPE(*BASIC) which is the default must be used on DSPUSRPRF.

The  outfile  would  then  be transferred  to  the  target  system.   A
variety of techniques could be used such as DDM.

On the target system you would then enter the command:

            CPYUSRPRF3      USRPRF(xxx) USRINF(yyy/zzz)

A different named  user profile may  be created by  using the  FILEUSER
parameter.   For  example,  you may  use  the profile  information  for
USER1 to create a profile for USER2.

Following the  creation of the  new profile, you may  check the results
with the CMPUSRPRF2 TAA command.

            CMPUSRPRF2   USRPRF(xxx) USRINF(yyy/zzz)

Object auditing information is copied.

After  creating  the  user profile,  CHGOBJOWN  is used  to  change the
owner to QSECOFR.   The CPYUSRPRF user  retains all rights to  the user
profile.   Changing  to QSECOFR  as the  owner is  done to  prevent the
problem  in a disaster recovery  situation where the name  of the owner
of the profile comes later in  the alphabet than the user profile  that
was created.   System profiles are restored first followed  by the user
created  profiles in alphabetical order.   If user  BBB creates profile
AAA, the AAA user profile is  restored without BBB being on the  system
and the owner would become QDFTOWN.

Non-supported user profile attributes
-------------------------------------

The following keywords are  not supported (defaults are taken  when the
profile is created):

             PASSWORD
             DOCPWD
             AUT
             UID
             GID
             LOCALE
             HOMEDIR

Any  authorizations to  the user  profile object  on the  source system
are not transferred to the target system.

CPYUSRPRF3 escape messages you can monitor for
----------------------------------------------

      TAA9891    The FILEUSER does not exist in the DSPUSRPRF outfile.

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

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

   USRPRF        The  new  user  profile  to  be  created.    The  user
                 profile must not exist.

   USRINF        The qualified  name  of  the file  that  contains  the
                 user  profile information.   The  file must  have been
                 created   by   the   DSPUSRPRF   OUTFILE  TYPE(*BASIC)
                 function.   The  format name  of QSYDSUPB  is  checked
                 for.   The  library defaults  to *LIBL.   *CURLIB  may
                 also be used.

                 The  DSPUSRPRF  OUTFILE  function  creates one  record
                 for each requested  profile.   CPYUSRPRF3 will  search
                 the file  for  the user  profile named  in the  USRPRF
                 parameter.

   FILEUSER      The user  profile name in the DSPUSRPRF  outfile to be
                 used  as a base.   The default  is *USRPRF meaning the
                 same user profile  name will be  used as specified  in
                 the USRPRF parameter.

   MBR           The member  of the USRINF  file to be processed.   The
                 default is *FIRST.

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

See the previous comments.

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

The following TAA Tools must be on your system:

     CHKAPOST        Check apostrophes
     CHKSECADM       Check *SECADM special authority
     RTVFMT          Retrieve format
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message

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

None, the tool is ready to use.

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

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

   CPYUSRPRF3    *CMD                   TAASEFJ       QATTCMD
   TAASEFJC      *PGM       CLP         TAASEFJC      QATTCL