Displays information about one or more element generations in a
CMS library.
Format:
SHOW GENERATION [element-expression]
1 – Restrictions
o You cannot specify the /ANCESTORS and /DESCENDANTS qualifiers
on the same command line.
o You cannot specify the /DESCENDANTS and /FROM qualifiers on the
same command line.
o If you specify the /FROM qualifier, you must also specify the
/ANCESTORS qualifier on the same command line.
2 – Command Parameters
element-expression
Specifies one or more elements. For each element, CMS lists the
transaction record of the most recent generation on the main line
of descent. If you do not supply an element expression, CMS lists
a transaction record for each element in the library. An element
expression can be an element name, a group name, a wildcard
expression, or a list of these separated by commas.
3 – Description
The SHOW GENERATION command lists information about a specific
generation of an element or a group of elements. By default, this
command displays the transaction record of the latest generation
on the main line of descent. You can also use SHOW GENERATION
to display the element name and generation number of all element
generations belonging to a specified group or class.
4 – Qualifiers
4.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.
4.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.
4.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.4 /BRIEF
The /BRIEF qualifier displays only element names and
generation numbers for each specified generation.
4.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.
4.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.
4.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.
4.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.
4.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.
4.10 /INTERMEDIATE
The /INTERMEDIATE qualifier displays the element name, generation
number, date, time, user, and remark associated with the transaction
that created the generation.
4.11 /MEMBER
Lists the element name, generation number, and the names of any
classes to which the element generation belongs.
4.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.
4.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.
4.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.
5 – Examples
(1) CMS> SHOW GENERATION/BRIEF
Element generations in CMS Library DISKX:[TAYLOR.CMSLIB]
CCM.FOR/2 CCM1.FOR/1 COPYTEST.FOR/2
This command directs CMS to display only the element name
and the number of the latest main line generation for each
element. Because no element is specified in the command line,
CMS displays information about all elements in the library.
(2) CMS> SHOW GENERATION CCM.FOR
Element generations in CMS Library DISKX:[TAYLOR.CMSLIB]
CCM.FOR 2 7-DEC-1988 14:15:51 SMITH "header changed"
This command displays the element name, generation number,
date, time, and remark associated with the latest main line
generation for element CCM.FOR.
(3) CMS> SHOW GENERATION/FULL CCM.FOR
Element generations in CMS Library DISKX:[TAYLOR.CMSLIB]
CCM.FOR 2 6-MAR-1988 17:34:04 SMITH "header changed"
File creation: 6-MAR-1988 17:24
File revision: 6-MAR-1988 17:24 (1)
Record format: Variable length
Record attributes: Carriage return carriage control
This command produces information about the file creation
and revision date and time, the file revision number, and
the record format and attributes, in addition to the standard
CMS transaction information (element name, generation number,
date, time, user, and remark). This additional information
describes the file that was used to create the particular
element generation, in this case generation 2 of CCM.FOR.
(4) CMS> SHOW GENERATION/GENERATION=RELEASE5 -
_CMS> /FORMAT="$ CMS FETCH #E/GENERATION=#G" -)
_CMS> /OUTPUT=FETCH_CLASS.COM
This example produces a file named FETCH_CLASS.COM that
contains a fetch command for each element that belongs to
the class named RELEASE5. The FETCH command retrieves the
element of the correct generation from the RELEASE5 class. The
contents of a file produced by this command might look like the
following:
$ CMS FETCH INIT.FOR/GENERATION=6
$ CMS FETCH OUTPUT.FOR/GENERATION=7
$ CMS FETCH SEARCH.FOR/GENERATION=3