Copyright Digital Equipment Corp. All rights reserved.

Qualifiers

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

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

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

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

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

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

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

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

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

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

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

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

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

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