Previous | Contents | Index |
Management groups are manipulated with the GROUP
command. This command has four variants:
GROUP/ADD | Add a new management group |
GROUP/DELETE | Delete a management group |
GROUP/LIST | List one or more management groups and any subgroups |
GROUP/MODIFY | Modify an existing management group |
GROUP
command to establish group-subgroup relationships and to delete groups which are no longer being used. Use the GROUP/ADD
command to add a new management group. If the group already exists, then an error will ensue and the existing group left unchanged. In that case, use the GROUP/MODIFY
command to modify the existing group. To add the management groups class_97
, class_98
, class_99
, and class_00
use the commands
popstore> GROUP/ADD class_97 popstore> GROUP/ADD class_98 popstore> GROUP/ADD class_99 popstore> GROUP/ADD class_00 |
students
containing these four groups, issue the command
popstore> GROUP/ADD STUDENTS CLASS_97,CLASS_98,CLASS_99,CLASS_00 |
GROUP/LIST
command as shown below.2
popstore> GROUP/LIST STUDENTS Group name: Subgroups contained within -------------------------------------------- students: class_97, class_98, class_99, class_00 class_97: class_98: class_99: class_00: popstore> |
After the Class of 2010 has graduated and left and the Class of 2014 arrives, the class_10
group can be removed, the class_14
group added, and the students
group modified as follows
popstore> GROUP/ADD class_14 popstore> GROUP/MODIFY students class_11,class_12,class_13,class_14 popstore> GROUP/DELETE class_10 popstore> GROUP/LIST students Group name: Subgroups contained within -------------------------------------------- students: class_11, class_12, class_13, class_14 class_11: class_12: class_13: class_14: popstore> |
Note that the GROUP/DELETE
command deletes just the specified group. It will recursively delete the subgroups contained within the specified group only when /RECUR
is specified. Also, it does not delete the accounts contained within the group; to do that, use the DELETE/GROUP=group_name *
command; e.g.,
popstore> DELETE/GROUP=class_97/RETURN/LOG/NOCONFIRM * |
It is also important to note that a group can contain only a limited number of subgroups as immediate subgroups. Those subgroups can, of course, contain other subgroups. The limit on the number of immediate subgroups of a given group is controlled by the length in bytes of the names of each of those immediate subgroups. If there are to be N immediate subgroups and their combined name lengths are L, then N+L must be less than 236. If a group needs to contain more subgroups than allowed by that limit, nest its definition an extra level. For example,
popstore> GROUP/ADD blah_x blah_01,blah_02,blah_03,...,blah_29 popstore> GROUP/ADD blah_y blah_30,blah_33,blah_34,...,blah_52 popstore> GROUP/ADD blah blah_x,blah_y |
blah_01
, ..., blah_52
are collectively too long to be contained as immediate subgroups of a given group. Therefore they are split between the two groups blah_x
and blah_y
. Those two groups are then made subgroups of blah
. Consequently, the group blah
contains the all of the groups blah_01
, ..., blah_52
as subgroups despite the length limitation.
2 Note that group names are case insensitive and that the popstore converts all group names to lower case. |
Previous | Next | Contents | Index |