TAA Tools
ADDSUPGRP       ADD SUPPLEMENTAL GROUP                 TAASEGL

The  Add   Supplemental   Group  command   allows  the   adding  of   a
supplemental  group  profile  to  one  or  more  user  profiles.    The
companion   command   is  Remove   Supplemental   Group  to   remove  a
supplemental group profile from one or more user profiles.

You must have  *ALLOBJ and  *SECADM to use  the ADDSUPGRP or  RMVSUPGRP
commands.

Typical commands would be:

             ADDSUPGRP   SUPGRPPRF(ABC) USRPRF(USER1 USER2)

This would  add the ABC  profile as a  supplemental group to  the USER1
and USER2 profiles.

             RMVSUPGRP   SUPGRPPRF(ABC) USRPRF(USER1 USER2)

This  would remove  the ABC  profile as a  supplemental group  from the
USER1 and USER2 profiles.

When  ADDSUPGRP  is  used,  it  is  not  considered  an  error  if  the
supplemental group already  exists or is the group profile.   A message
will be sent to describe this condition.

When  RMVSUPGRP  is  used,  it  is  not  considered  an  error  if  the
supplemental group  does not  exist or  is not  the group  profile.   A
message will be sent to describe this condition.

The commands  will  continue processing  if a  user  profile cannot  be
changed  for   some  reason  (if   it  is  locked  or   the  number  of
supplemental  groups is already  at 15 when an  add is requested, etc).
Diagnostic messages  will be  produced and  an escape  message sent  at
the end of processing.

Group Profile and Supplemental Group Profile system support
-----------------------------------------------------------

A supplemental  group profile  cannot be added  unless a  group profile
exists.   A maximum  of 15 supplemental  group profiles  may exist plus
the group profile.  Therefore,  an individual user profile may have  up
to 16 group profiles.

If no  GRPPRF value  was specified,  *NONE is  displayed by  DSPUSRPRF.
If no  SUPGRPPRF value was specified, *NONE  is displayed by DSPUSRPRF.

ADDSUPGRP determines if GRPPRF(*NONE) exists  for the user profile  and
if so makes the specified supplemental group the group profile.

Conversely, RMVSUPGRP  determines if  the supplemental group  specified
on  the command exists  as the group  profile for a  user.  If  so, the
group  profile is  changed so that  the first  supplemental profile (if
one exists) is the new group profile.

ADDSUPGRP escape messages you can monitor for
---------------------------------------------

      TAA9892    Some error occurred.  See previous messages.

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

RMVSUPGRP escape messages you can monitor for
---------------------------------------------

      TAA9892    Some error occurred.  See previous messages.

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

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

   SUPGRPPRF     The supplemental group to  be added.  This must  be an
                 existing  profile (it  does not  have to  be specified
                 as a group profile).

                 If   the   named   user   profile   already   has  the
                 supplemental  group  specified  as  either  the  group
                 profile  or  is  in  the list  of  supplemental  group
                 profiles,  the condition  is  flagged and  the command
                 continues normally.

   USRPRF        A  list  of  1  to  300  user  profiles  to  add   the
                 supplemental  group  profile to.    The  user  profile
                 must exist.

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

   SUPGRPPRF     The supplemental  group to be  removed.  This  must be
                 an existing profile.

                 If   the  named   user  profile  does   not  have  the
                 supplemental  group  specified  as  either  the  group
                 profile  or   in  the   list  of   supplemental  group
                 profiles,  the condition  is  flagged and  the command
                 continues normally.

   USRPRF        A list  of  1  to  300 user  profiles  to  remove  the
                 supplemental  group profile  from.   The user  profile
                 must exist.

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

You  must have *ALLOBJ  and *SECADM to  use the ADDSUPGRP  or RMVSUPGRP
commands.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKSECADM       Check *SECADM special authority
     EDTVAR          Edit variable
     EXTLST          Extract list
     RSNLSTMSG       Resend last message
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCINF       Send escape information
     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
   ------        ----    ---------      ----------    ----------

   ADDSUPGRP     *CMD                   TAASEGL       QATTCMD
   RMVSUPGRP     *CMD                   TAASEGL2      QATTCMD
   TAASEGLC      *PGM       CLP         TAASEGLC      QATTCL
   TAASEGLC2     *PGM       CLP         TAASEGLC2     QATTCL

Structure
---------

ADDSUPGRP   Cmd
   TAASEGLC   CL pgm

RMVSUPGRP   Cmd
   TAASEGLC2  CL pgm
					

Added to TAA Productivity tools June 1, 2005


Home Page Up to Top