group modify

group modify group_name_list
{-add extended_rgy_attr_list | -remove extended_rgy_attr_list [-types] |
-change extended_rgy_attr_list | -attribute value}

Options

-attribute value
As an alternative to using the -attribute option with an attribute list, you can change individual attribute options by prepending a - (hyphen) to any attributes listed in Attributes in this reference page. You cannot use this option to specify ERAs; it is only for the standard attributes described in Attributes.

-add extended_rgy_attr_list
Allows you to modify attributes, including ERAs, by using an attribute list rather than using individual attribute options. The format of an attribute list is:

{{extended_rgy_attr_list value}…{extended_rgy_attr_list value}}

-change extended_rgy_attr_list
Allows you to modify attributes, including ERAs, by using an attribute list rather than using individual attribute options. See the -add option for the attribute list format.

-remove extended_rgy_attr_list
Allows you to modify attributes, including ERAs, by using an attribute list rather than using individual attribute options such as -alias, -inprojlist, and so on. See the -add option for the attribute list format.

Without the -types option, -remove deletes individual attribute instances attached to the group. In this case, extended_rgy_attr_list is a list of attribute-value pairs. With the -types option, -remove deletes attribute types (and all instances of that type) attached to the group. In this case, extended_rgy_attr_list is a list of attribute types.

-types
Used with the -remove option to remove attribute types (and all instances of that type) attached to the group.

Description
The group modify operation changes attributes of groups. The argument is a list of names of groups to be operated on. All modifications are applied to all groups named in the argument. Groups are modified in the order they are listed and all modifications to an individual group are atomic. Modifications to multiple groups are not atomic. A failure for any one group in a list causes an error to be generated and the rest of the operation to be aborted. Returns an empty string on success.

The -change option can be used to modify the value of any one of the attributes except for gid and uuid. The value of the -change option is an attribute list describing the new values for the specified attributes. Also supports the -alias, -inprojlist, and -fullname options. Specify only ERA attributes by using the -add and -remove options.

Privileges Required
You must have r (read) permission to the group to be modified and f (full_name) permission to modify the group's full name and/or m (mgmt_info) permission to modify the group's management information.

Examples

dcecp> group modify users3 -change {fullname "General Nursing Staff"}
dcecp>

dcecp> group show users3
{alias no}
{gid 5212}
{uuid 0000145c-9363-21cd-a601-0000c08adf56}
{inprojlist no}
{fullname {General Nursing Staff}}
dcecp>

dcecp> group modify users3 -add {test_era 101}
dcecp>

dcecp> group show users3
{alias no}
{gid 5212}
{uuid 0000145c-9363-21cd-a601-0000c08adf56}
{inprojlist no}
{fullname {General Nursing Staff}}
{test_era 101}}
dcecp>