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

    Removes one or more elements from one or more groups.

       Format:

          REMOVE ELEMENT  element-expression group-expression "remark"

1 - Restrictions

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

2 - Command Parameters

 element-expression

    Specifies one or more elements to be removed from one or more
    groups. An element expression can be an element name, a group
    name, a wildcard expression, or a list of these separated
    by commas. When you use wildcard characters in the element
    expression, /IF_PRESENT is the default. (CMS does not return an
    error message if the group does not contain the element being
    removed.)

 group-expression

    Specifies the group from which one or more elements are to be
    removed. 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 REMOVE ELEMENT command removes one or more elements from one
    or more groups. The command does not delete the elements from
    the library, but there is no longer any association between the
    elements and the groups.

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 the element from the group if it belongs to
    the group. If the element does not belong to the group, CMS takes
    no action and does not return an error. When you use wildcard
    characters in the element expression, /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 (ELEMENT, GROUP)
       ELEMENT (D)
       NOELEMENT
       GROUP (D)
       NOGROUP
       NONE--equivalent to (NOELEMENT, NOGROUP)

    You can specify either ALL or NONE, or any combination of the
    [NO]ELEMENT and [NO]GROUP keywords.

    By default, CMS performs occlusion for all objects; that is, CMS
    selects only the first occurrence of a specified object.

5 - Example

    CMS> REMOVE ELEMENT *.* A2 "remove all elements from group"
    %CMS-S-REMOVED, element DISKX:[PROJECT.CMSLIB]SEARCH.FOR
    removed from group DISKX:[PROJECT.CMSLIB]A2
    %CMS-S-REMOVED, element DISKX:[PROJECT.CMSLIB]ARGCHK.FOR
    removed from group DISKX:[PROJECT.CMSLIB]A2
        .
        .
        .

      This command removes all the elements from the group A2.