VMS Help CMS, INSERT, GROUP  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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.