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

    Changes the characteristics of a specified generation or
    generations.

       Format:

          MODIFY GENERATION  element-expression /qualifier "remark"

1 - Restrictions

    o  You must specify one of the following qualifiers: /GENERATION
       or /REMARK.

2 - Command Parameters

 element-expression

    Specifies one or more elements whose generations are to be
    modified. An element expression can be an element name, 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. Note that this parameter
    and the string on the /REMARK qualifier are unrelated.

3 - Description

    The MODIFY GENERATION command changes the remark that is
    associated with a particular generation of one or more
    elements. Use the SHOW GENERATION command to display generation
    characteristics.

    This command does not change a generation's review status. See
    the ACCEPT GENERATION, CANCEL GENERATION, MARK GENERATION, REJECT
    GENERATION, and REVIEW GENERATION commands for more information.

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]

    Specifies which generation of the element is to be modified. If
    you omit /GENERATION, CMS modifies the most recent generation on
    the main line of descent.

 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, 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.

 4.5 - /REMARK="string"

    Specifies a new remark to be substituted for the creation
    (replacement) remark that is associated with the generation. This
    qualifier is required.

5 - Example

    CMS> MODIFY GENERATION/GENERATION=5/REMARK="Obsolete"
    _Element expression: SPEC.TXT
    _Remark: Marked obsolete
    %CMS-S-MODIFIED, generation 5 modified

      This command specifies a new remark to be substituted for the
      creation remark of generation 5 of element SPEC.TXT. You must
      also specify the element expression, and its associated remark,
      which is logged in the history file.