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

1 - GENERATION

    Marks each specified element generation for review and adds it to
    the review pending list.

       Format:

          MARK GENERATION  element-expression "remark"

 1.1 - Restrictions

    o  This command can be used only on element generations that do
       not already have reviews pending.

 1.2 - Command Parameters

 element-expression

    Specifies one or more elements or groups of elements whose
    generations are to be marked with pending review status. 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.

 1.3 - Description

    The MARK GENERATION command changes the review status of the
    specified element generation from "none" to "pending" and inserts
    it into the review pending list. You can then review the element
    generation by using the REVIEW GENERATION command. Use one of the
    following commands to change the review status of the element
    generation: ACCEPT GENERATION, REJECT GENERATION, or CANCEL
    REVIEW.

 1.4 - Qualifiers

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

 1. 4.2 - /GENERATION[=generation-expression]

    Specifies which generation of the element is to be marked as
    having review pending status. If you omit /GENERATION, CMS marks
    the most recent generation on the main line of descent.

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

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

 1.5 - Example

    $ CMS MARK GENERATION/GENERATION=1X1 SPEC.COM
    _Remark: check this gen out before reinserting into class
    %CMS-S-MARKED, generation 1X1 of element
    DISKX:[PROJECT.CMSLIB]EXAMPLE.SDML marked for review

      This command marks a specific generation for review. CMS adds
      the generation to the review pending list.