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

1 - /ALWAYS

    Directs CMS to insert the element generation into the class in
    all cases. If the class already contains a generation from the
    specified element, that generation is removed before the new one
    is inserted.

2 - /BEFORE=date-time

    Directs CMS to insert the element generation based on the
    /GENERATION qualifier or the latest generation on the main line
    of descent if there is no qualifier. The generation inserted is
    the latest ancestor of the generation determined above that
    pre-dates the specified time. If no generation pre-dates that
    time (i.e. generation 1 is later) then no generation is inserted.

    The time value can be an absolute, delta, or combination time
    value, or one of the following keywords: TODAY, TOMORROW, or
    YESTERDAY.  If the time value is a future value, CMS uses the
    current time.  If no time value is supplied, CMS used TODAY.

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

    Specifies a particular generation of the element that is to be
    inserted into the class. If you omit /GENERATION, the INSERT
    command uses the latest generation on the main line of descent.

5 - /IF_ABSENT

    Directs CMS to insert the element generation into the class only
    if a generation of that element is not already in the class. If a
    generation of the element is already in the class, CMS takes no
    action and does not return an error.

6 - /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.

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

8 - /SUPERSEDE

    Controls whether CMS removes a generation of the element that
    exists in the class and replaces it with the specified generation.
    (Using /SUPERSEDE is the equivalent of using the REMOVE command
    before the INSERT command.)

    If you specify /SUPERSEDE and there is no generation of the
    specified element already in the class, an error message is
    issued and the generation is not inserted into the class. You
    cannot use the /IF_ABSENT qualifier on the same command line as
    the /SUPERSEDE qualifier to override this action.

    If you omit the /SUPERSEDE qualifier and a generation of the
    element already exists in the class, an error message is issued
    and no change is made to the library.