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

    Changes the review status of each specified element generation
    from "pending" to "rejected" and removes it from the review
    pending list.

       Format:

          REJECT GENERATION  element-expression "remark"

1 - Command Parameters

 element-expression

    Specifies one or more elements whose generations are to be
    rejected. 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 associated with the element
    generation specified, to be logged in the history file with this
    command. The remark is enclosed in quotation marks. If no remark
    was entered, a null remark ("") is logged.

2 - Description

    The REJECT GENERATION command changes the review status of
    each specified element generation from "pending" to "rejected"
    and removes it from the review pending list. You can use this
    command only on element generations that have reviews pending
    (see the description of the REVIEW GENERATION command for more
    information).

    If you attempt to reserve a generation that has been rejected,
    CMS issues a message stating that the generation was rejected,
    and then prompts you for confirmation. Additionally, further
    generations created from a rejected generation are marked for
    review, regardless of the element's review attribute.

3 - Qualifiers

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

 3.2 - /GENERATION[=generation-expression]

    Specifies a particular generation of the element to be rejected.
    If you omit /GENERATION, CMS rejects the most recently created
    generation with a review pending. You specify this qualifier only
    if more than one generation of an element is under review.

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

 3.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 - Example

    $ CMS REJECT GENERATION EXAMPLE.SDML "don't change this until
    it is fixed"
    %CMS-S-REJECTED, generation 1X1 of element
    DISKX:[PROJECT.CMSLIB]EXAMPLE.SDML rejected

      This command rejects the latest generation of EXAMPLE.SDML,
      which was on the review pending list. This generation of
      EXAMPLE.SDML remains rejected unless you specify a MARK
      GENERATION command.