Places one or more groups into the specified group or groups.
Format:
INSERT GROUP subgroup-expression group-expression "remark"
1 – Restrictions
o You cannot insert a group into another group that has read-only
access.
o You can insert a group into another group only once.
o You cannot create recursive groups; that is, a group cannot
directly or indirectly be a member of itself.
o You cannot insert a group from one library into a group in
another library (both groups must be in the same library).
2 – Command Parameters
subgroup-expression
Specifies one or more groups to be inserted into a second group
(indicated by group-expression). A subgroup expression can be a
group name, a wildcard expression, or a list of these separated by
commas.
group-expression
Specifies the group into which subgroup-expression is to be
inserted. A group expression can be a group name, a wildcard
expression, or a list of these separated by commas.
remark
Specifies a character string to be logged in the history file
with this command, usually used to explain why the command was
entered. The remark is enclosed in quotation marks. If no remark
was entered, a null remark ("") is logged.
3 – Description
The INSERT GROUP command inserts one or more groups into one
or more other groups. Both groups must exist. When you use the
INSERT GROUP command to insert group A into group B, the elements
accessible through group B change as the contents of group A
change. A group cannot be a member of itself; that is, it cannot
be a subgroup of itself. For example, you cannot insert group A
into group B if group A already contains group B.
4 – Qualifiers
4.1 /CONFIRM
Controls whether CMS prompts you for confirmation before each
transaction.
When you specify /CONFIRM and run CMS in interactive mode, CMS
prompts you for confirmation. If you type YES, ALL, TRUE, or 1,
CMS executes the transaction. If you type NO, QUIT, FALSE, 0,
or press RETURN or CTRL/Z, no action is performed. If you type
any other character, CMS continues to prompt until you type an
acceptable response.
CMS does not prompt for confirmation in batch mode.
4.2 /IF_ABSENT
Directs CMS to insert subgroup-expression into group-expression
only if group-expression does not already contain it. If subgroup-
expression already belongs to group-expression, CMS takes no
action and does not return an error.
4.3 /LOG (D)
Controls whether CMS displays success and informational messages
on the default output device. By default, if the command executes
successfully, CMS displays a success message. If you specify
/NOLOG, success and informational messages are suppressed. Any
warning, error, or fatal error messages are displayed regardless
of whether /LOG or /NOLOG is specified.
4.4 /OCCLUDE[=option,...]
Controls whether CMS selects the first instance of the specified
object, or all instances of the specified object in the library
search list. The options field contains one or more keywords
associated with the name of the object. The options field can
contain the following keywords:
ALL--equivalent to GROUP
GROUP (D)
NOGROUP
NONE--equivalent to NOGROUP
You can specify either ALL, NONE, or the [NO]GROUP keyword.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
5 – Example
CMS> INSERT GROUP USER_MANUAL CODE_AND_DOCS "user documentation"
%CMS-S-INSERTED, group DISKX:[PROJECT.CMSLIB]USER_MANUAL inserted
into group DISKX:[PROJECT.CMSLIB]CODE_AND_DOCS
This command inserts the group named USER_MANUAL into the group
named CODE_AND_DOCS. As long as group USER_MANUAL belongs to
group CODE_AND_DOCS, any changes to the contents of USER_MANUAL
are reflected in the contents of CODE_AND_DOCS. Any element
accessible through USER_MANUAL is also accessible through CODE_
AND_DOCS.