PMDF popstore & MessageStore Manager's Guide

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.