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

1 - /ANCESTORS

    Displays the transaction records of the specified element
    generation and all of its ancestors. The transaction records are
    listed in reverse chronological order. If you do not specify a
    particular generation, the list begins with the latest generation
    on the main line of descent.

    The ancestors of a main line generation are all the preceding
    generations back to the first generation of an element. The
    ancestors of a variant-line generation are all preceding
    generations on the variant line of descent, and any generations
    back to the first generation on the main line.

2 - /APPEND

    Controls whether CMS appends the command output 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),
    the output is appended to SYS$OUTPUT.

3 - /BEFORE=date-time

    Displays all of the generation information before a specified time.

    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.

4 - /BRIEF

    The /BRIEF qualifier displays only element names and
    generation numbers for each specified generation.

5 - /DESCENDANTS

    Displays the transaction records of the specified element
    generation and of all its descendants. The transaction records
    are listed in reverse chronological order. If you do not specify a
    particular generation, the list begins with generation 1.

    The descendants of a generation consist of all the successor
    generations, including those that on variant lines of descent.
    Thus, you can use this command to determine whether any variant
    lines of descent exist for a particular element.

6 - /FORMAT="string"

    Controls whether the output of the SHOW GENERATION command is
    formatted. You can use the /FORMAT qualifier in combination
    with the /OUTPUT qualifier to set up a command file. With this
    command file, you can execute a CMS command or a DCL command on a
    specified set of elements (such as all elements in a class).

    The format string can contain printing characters; within the
    format string, CMS recognizes #E (and #e) as the element format
    parameter, and #G (and #g) as the generation number format
    parameter. For each line of output (one line per generation),
    CMS displays the format string and replaces each occurrence of #E
    or #G with the element name or generation number, respectively.
    To include a number sign in the output line, type it twice (##).
    When you specify the /FORMAT qualifier, CMS does not generate the
    heading normally produced by the SHOW GENERATION command.

    To set up a command file, you specify a format string consisting
    of a command, including the dollar sign ($) prompt and a
    format parameter (#E or #G) (for example, /FORMAT="$ CMS FETCH
    #E/GENERATION=#G"). Use the /OUTPUT qualifier to direct the output
    to a command file. When you execute the SHOW GENERATION command
    with these qualifiers, CMS creates a command file containing a
    list of FETCH commands that use each element in the denoted set as
    parameters.

7 - /FROM=generation-expression

    Specifies the generation that begins the list of ancestors. You
    must specify the /ANCESTORS and /FROM qualifiers on the same
    command.

8 - /FULL

    The /FULL qualifier displays standard CMS transaction information
    (the element name, generation number, date, time, user, and remark),
    and also produces information about the file creation and revision
    date and time, the file revision number, and the record format and
    attributes.

9 - /GENERATION[=generation-expression]

    Specifies the generation about which you want information. When
    you use the /GENERATION qualifier with the element-name parameter,
    the transaction record of the indicated generation is displayed.

10 - /INTERMEDIATE

    The /INTERMEDIATE qualifier displays the element name, generation
    number, date, time, user, and remark associated with the transaction
    that created the generation.

11 - /MEMBER

    Lists the element name, generation number, and the names of any
    classes to which the element generation belongs.

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

13 - /OUTPUT[=file-specification]

    Directs CMS to write output to the specified file, except for any
    warning and error messages, which are written to SYS$OUTPUT and
    SYS$ERROR. 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 directs output to
    the default output device (SYS$OUTPUT). If you omit either the
    file name or the file type component, CMS supplies the missing
    component from the default specification.

14 - /SINCE=date-time

    Displays all of the generation information since a specified time.

    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.