TAA Tools
CHKUSRGRP       CHECK USER FOR GROUP                   TAASELC

The Check User for Group  command checks if a user profile  is a member
of  a named  group either  by the  GRPPRF or  SUPGRP attributes  of the
profile.   TAA9891 is sent as an escape  message if the user profile is
not a member of  the group.  No  completion message occurs if the  user
profile is a member.

The  user  of  the  command   must  be  authorized  to  the  TAACHKUSRG
Authorization List.

A  user profile  becomes a  group profile if  a different  user profile
specifies its name  as a group  profile.  The  system prevents a  group
profile from being named a member of another group.

A typical command would be:

             CHKUSRGRP USRPRF(USER1) GRPPRF(GROUP1)

If  USER1  is  a  member  of the  GROUP1  group  profile,  the  command
completes  normally.   If USER1  is not  a member  of the  GROUP1 group
profile, TAA9891 would be sent as an escape message.

Both names may  not be the  same.   The user profile  named for  USRPRF
cannot be  a  group profile.   The  user profile  specified for  GRPPRF
must be a group profile.

CHKUSRGRP escape messages you can monitor for
---------------------------------------------

      TAA9891    The user profile is not a member of the group
      TAA9892    Both user profile names cannot be the same
      TAA9893    The USRPRF user cannot be a group profile
      TAA9894    The GRPPRF user must be a group profile
      TAA9895    The user profile does not exist
      TAA9896    The group profile does not exist

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

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

   USRPRF        The  user profile  to be  checked.   It  may not  be a
                 group profile.

   GRPPRF        The  group  profile the  USRPRF must  be a  member of.
                 The  user profile  specified  for GRPPRF  must  differ
                 from the USRPRF value and must be a group profile.

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

The user must have *ALLOBJ special authority.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     RTVGRPPRFI      Retrieve group profile information
     SCNVAR          Scan variable
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CHKUSRGRP     *CMD                   TAASELC       QATTCMD
   TAAMBRIC      *PGM       CLP         TAASELCC      QATTCL
					

Added to TAA Productivity tools October 15, 2013


Home Page Up to Top