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

    Removes one or more element generations from one or more classes.

       Format:

          REMOVE GENERATION  element-expression class-expression "remark"

1 - Restrictions

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

2 - Command Parameters

 element-expression

    Specifies one or more generations of elements to be removed from
    one or more classes. 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 class does not contain a generation
    of the element.)

 class-expression

    Specifies the class from which the element generation is to
    be removed. The class must not have read-only access. A class
    expression can be a class 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 GENERATION command removes an element generation from a
    class. The command does not delete the element generation from the
    library, but the element generation is no longer associated with
    the class.

    To remove one element generation from a class and replace it with
    another generation of the same element, use the INSERT GENERATION
    command with the /SUPERSEDE qualifier.

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 - /GENERATION[=generation-expression]

    Directs CMS to remove a particular generation of an element
    from one or more classes in the library. The generation must
    be currently existing in the class. If you use a wildcard or a
    list of class names for the class expression, CMS deletes the
    particular generation from each specified class.

 4.3 - /IF_PRESENT

    Directs CMS to remove any generation of the element that exists
    in the class. If the class does not contain a generation from the
    element, 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.4 - /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.5 - /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, CLASS)
       ELEMENT (D)
       NOELEMENT
       GROUP (D)
       NOGROUP
       CLASS (D)
       NOCLASS
       NONE--equivalent to (NOELEMENT, NOGROUP, NOCLASS)

    You can specify either ALL or NONE, or any combination of the
    [NO]ELEMENT, [NO]GROUP, and [NO]CLASS 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 GENERATION USER.DOC PRE_RELEASE_V3
    _Remark: internal documentation is online
    %CMS-S-GENREMOVED, generation 2 of element
    DISKX:[PROJECT.CMSLIB]USER.DOC removed from class
    DISKX:[PROJECT.CMSLIB]PRE_RELEASE_V3

      This example removes generation 2 of USER.DOC from class PRE_
      RELEASE_V3.