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

1 - /APPEND

    Controls whether CMS appends the history and source file listing
    to an existing file, or creates a new file. If you specify /APPEND
    and the output file does not exist, CMS creates a new file. If you
    do not provide an output file specification (see the description
    for /OUTPUT), CMS searches your default directory for a file with
    the element file name and the file type .ANN.

2 - /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 - /FORMAT=(data-format,data-partition)

    Controls whether the history and source file listing is formatted,
    and specifies the type of formatting. You can specify one or both
    formatting parameters in any order.

    data-format

    Specifies the type of format. Possible values for data formats
    include:   ASCII (Default), DECIMAL, HEXADECIMAL, and OCTAL.

    data-partition

    Specifies the type of data partition. Possible values for data
    partitions include:  BYTE, LONGWORD, RECORDS (Default), and WORD.

4 - /FULL

    Directs CMS to include the following information about the file
    used to create each generation:

    o  Creation time
    o  Revision time
    o  Revision number
    o  Record format
    o  Record attributes

    CMS also indicates deleted lines in the source listing. Each
    set of one or more deleted lines is identified by a count of the
    deleted lines.

5 - /GENERATION[=generation-expression]

    Specifies a particular generation of the element to be annotated.
    If you omit /GENERATION, CMS annotates the most recent generation
    on the main line of descent.

    The history contains a description of every generation of the
    element, including those created after the specified generation.
    (Generations created after the specified generation are not marked
    with an asterisk.)

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 - /MERGE=generation-expression

    Combines two generations of an element and creates a single
    file that contains the annotated listing. The parameter on the
    /MERGE qualifier specifies the generation that is merged into the
    retrieved generation. This command creates a file that contains
    the text common to both generations and the changes made to both
    generations. When changes that are not identical are made in
    the same position of the common ancestor, the changes from both
    generations are included in the resulting file and are marked as a
    conflict. By default, generations are not merged.

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

9 - /OUTPUT[=file-specification]

    Directs CMS to write output to the specified file. CMS creates a
    new file if you do not specify /APPEND. If you omit the /OUTPUT
    qualifier (or if you specify /OUTPUT but do not provide a file
    specification), CMS creates a file with the element file name and
    the file type .ANN. Wildcards are allowed.

    If you annotate more than one element (by specifying wildcards or
    a group name for the element expression parameter), and you do not
    specify wildcards in the output file specification, CMS creates
    successive versions of the file indicated by /OUTPUT.