PMDF popstore & MessageStore Manager's Guide


Previous Contents Index

4.3.4.1 add_group Command: add a new management group

The add_group command adds a new management group to the popstore. Parameter names and associated values accepted by the command are listed in the Table 4-1.

Table 4-1 add_group command parameters
parameter=value   Description
group=name Required Name of the management group, name, to create. The name can be one to sixteen bytes long.
group_blist=blist Optional Byte delimited list of subgroups to be contained within the new group. The first byte in blist is the delimiter which is then used to delimit each group name in the string; e.g., |name-1|name-2|name-3. The length of the string blist can not exceed 236 bytes.
group_list=list Optional Comma delimited list of subgroups to be contained within the new group. For instance, name-1,name-2,name-3. Leading and trailing white space around each group name is ignored. The length of the string blist can not exceed 236 bytes.
log=bvalue Optional Boolean value, 0 or 1. When bvalue is 1, then a status message will be output indicating a successful operation. The default is bvalue=0. Note that errors are always reported.
on_error=file-spec Required Name of the formatting file to use to format the results when the command fails.
on_success=file-spec Required Name of the formatting file to use to format the results when the command succeeds.

When creating a new management group, at most one of group_list or group_blist should be specified. If neither are specified, then the new group will contain no subgroups. If the specified group name conflicts with an existing group name, then an error will be issued and the pre-existing group definition left unchanged.


Previous Next Contents Index