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.