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
|
