TAA Tools
CVTGRPPRF       CONVERT GROUP PROFILES                 TAASEFL

The Convert Group  Profiles command creates  an outfile of  the members
of a  group profile.  The  user profile information will  appear in the
outfile  if the user profile  is specified as the  value for the GRPPRF
parameter or  is in  the list  supplied for  the SUPGRPPRF  parameters.
This provides a  simple method of reviewing and  processing the members
of a group.  The outfile name is GRPPRFP.

The  model file is  TAASEFLP with a  format of QSYDSUPB.   This file is
created using  the system  model file  QADSPUPB which  is  used by  the
system  DSPUSRPRF command  TYPE(*BASIC)  function  when an  outfile  is
requested.

To convert all group profiles, see the CVTALLGRPP command.

You must have *ALLOBJ special authority to use CVTGRPPRF.

A typical command would be:

             CVTGRPPRF     GRPPRF(xxx) OUTLIB(yyy)

There would be one record for each member of the group.

The  default for  the REFRESH  parameter is *YES  which means  that the
TAASECKP outfile  in TAASECURE  (part of  the DSPSECRVW  tool) will  be
refreshed.

If you  are  using CVTGRPPRF  repeatedly on  the same  day, you  should
consider the *DAYCHG value.

CVTGRPPRF escape messages you can monitor for
---------------------------------------------

      TAA9891    No user profiles exist for the group

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

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

   GRPPRF        The  group profile to  be used  to select  the members
                 of  the group.   The user profile  will be selected if
                 the  value  matches  that  specified  for  the  GRPPRF
                 parameter  or  one of  the  list  of  profiles in  the
                 SUPGRPPRF parameter.

   OUTLIB        The  library   in  which  the  file  GRPPRFP  will  be
                 placed.  The  default is *LIBL.   If the GRPPRFP  file
                 does not already exist, a library must be named.

   OUTMBR        The  member of  the  GRPPRFP file  to  be  used.   The
                 default is  GRPPRFP.  If the member  does not exist it
                 is added.

   REPLACE       A *YES/*NO  value for  whether  the member  should  be
                 cleared before writing  records into it.   The default
                 is *YES.

                 *NO may  be specified to  add records to  any existing
                 data.

   REFRESH       An  option  to  determine  if  the  DSPUSRPRF  OUTFILE
                 function is used to  refresh the TAASECKP file in  the
                 TAASECURE library.   The default  is *YES to  mean the
                 TAASECKP file is refreshed.

                 *NO may be specified to use the existing data.

                 *DAYCHG   means  the   TAASECKP   file  will   not  be
                 refreshed if it was last  changed on the current  day.
                 *DAYCHG  assumes  that  if  you  are  using  CVTGRPPRF
                 repeatedly  on the same day,  you do not  want to keep
                 refreshing the information.

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

You must have *ALLOBJ special authority.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     DSPSECRVW       Display security review
     EDTVAR          Edit variable
     RTVDAT          Retrieve date
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CVTGRPPRF     *CMD                   TAASEFL       QATTCMD
   TAASEFLC      *PGM       CLP         TAASEFLC      QATTCL
   TAASEFLR      *PGM       RPG         TAASEFLR      QATTRPG
   TAASEFLP      *FILE      PF          TAASEFLP      QATTDDS
					

Added to TAA Productivity tools December 15, 2002


Home Page Up to Top