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

    Removes one or more groups from another group or groups.

       Format:

          REMOVE GROUP  group-expression1 group-expression2 "remark"

1 - Restrictions

    o  You cannot remove a group from a group with read-only access
       (see the description of the MODIFY GROUP command).

2 - Command Parameters

 group-expression1

    Specifies one or more groups to be removed. Wildcards and a comma
    list are allowed. When you use wildcard characters or a comma
    list in the group name, /IF_PRESENT is the default. (CMS does
    not return an error message if group-expression2 does not contain
    group-expression1.)

 group-expression2

    Specifies one or more groups from which the groups in group-
    expression1 are to be removed. Wildcards and a comma list are
    allowed.

 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 REMOVE GROUP command removes a group from another group. The
    command does not delete the group from the library, but there is
    no longer any association between the two groups. Removing group
    A from group B means that the contents of group A are no longer
    accessible through 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_PRESENT

    Directs CMS to remove group-expression1 only if it belongs to
    group-expression2. If group-expression1 does not belong to group-
    expression2, CMS takes no action and does not return an error.
    When you use wildcard characters or a comma list in the group
    name, /IF_PRESENT is the default.

 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> REMOVE GROUP A1 A2 "remove group from group"
    %CMS-S-REMOVED, group DISKX:[PROJECT.CMSLIB]A1 removed from group
    DISKX:[PROJECT.CMSLIB]A2

      This command removes group A1 from group A2.