1 – ACL
Displays the access control list (ACL) associated with the
specified object or objects.
Format:
SHOW ACL object-expression /OBJECT_TYPE=type
1.1 – Command Parameters
object-expression
Specifies the CMS library object whose ACL is to be displayed.
Wildcards and a comma list are allowed.
The object name depends on the object type (see the /OBJECT_TYPE
qualifier). For example, if the object type is CLASS, the object
name is the name of a class in the CMS library. The same principle
applies to elements and groups. If the object type is LIBRARY, the
object expression must be a list of one or more of the following
keywords:
ELEMENT_LIST
CLASS_LIST
GROUP_LIST
HISTORY
LIBRARY_ATTRIBUTES
These keywords are called object subtypes. You can abbreviate
object subtypes. Wildcards are not allowed.
The object name can also be the name of a CMS command. If /OBJECT_
TYPE is specified as COMMAND, SHOW ACL displays the ACL for the
given command.
1.2 – Description
The SHOW ACL command displays the ACL associated with the
specified object or objects.
1.3 – Qualifiers
1.3.1 /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
a file specification (see the description for /OUTPUT), the output
is appended to SYS$OUTPUT.
1.3.2 /OBJECT_TYPE=type
Specifies the type of the object whose ACL is to be displayed.
There is no default object type; therefore, this qualifier is
required. The object type can be one of the following keywords:
ELEMENT
CLASS
GROUP
LIBRARY
COMMAND
1.3.3 /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, OTHER)
ELEMENT (D)
NOELEMENT
GROUP (D)
NOGROUP
CLASS (D)
NOCLASS
OTHER (D)
NOOTHER
NONE--equivalent to (NOELEMENT, NOGROUP, NOCLASS, NOOTHER)
You can specify either ALL or NONE, or any combination of the
[NO]ELEMENT, [NO]GROUP, [NO]CLASS, and [NO]OTHER keywords.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
1.3.4 /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.
1.4 – Example
CMS> SHOW ACL/OBJECT=ELEMENT SAMPLE.PAS
ACLs in CMS Library DISKX:[PROJECT.CMSLIB]
SAMPLE.PAS
(IDENTIFIER=[PROJECT,WALLEN],ACCESS=FETCH)
This command displays the ACE on element SAMPLE.PAS.
2 – ARCHIVE
Displays information about one or more archive files.
Format:
SHOW ARCHIVE file-expression
2.1 – Command Parameters
file-expression
Specifies the name of the archive file. The file expression can be
a file-name.type specification, a wildcard expression, or a list
of these separated by commas.
2.2 – Description
The SHOW ARCHIVE command displays information about the contents
of one or more specified archive files.
2.3 – Qualifiers
2.3.1 /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.
2.3.2 /BRIEF
The /BRIEF qualifier displays the name of the element, the
generations archived into this file, the name of the person
who archived the file, the date and time, the remark entered on
the DELETE GENERATION command, and the name of the library in
which the original element resided.
2.3.3 /FULL
The /FULL qualifier displays complete generation file information
for each archived generation.
2.3.4 /INTERMEDIATE
The /INTERMEDIATE qualifier displays the generation history for
the archived generations.
2.3.5 /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.
2.4 – Examples
(1) CMS> SHOW ARCHIVE/BRIEF SAMPLE.CMS_ARCHIVE
25-JAN-1988 17:08:47 JONES DISKX:[WORK.CMSLIB]
SAMPLE.PAS(2A1--2A3) "delete the variant range and archive
the deleted generations"
This command displays information about the archive file,
consisting of the date and time entered with the DELETE
GENERATION command, the name of the person who archived the
file, the library in which the original element resided, the
generations that were archived into the file, and the remark
entered on the DELETE GENERATION command.
(2) CMS> SHOW ARCHIVE/FULL SAMPLE.CMS_ARCHIVE
25-JAN-1988 17:08:47 JONES DISKX:[WORK.CMSLIB] SAMPLE.PAS(2A1--2A3)
"delete the variant range and archive the deleted generations"
2A1 22-JAN-1988 14:27:41 JONES "reserved concurrently
to add routines"
File creation: 22-JAN-1988 14:27
File revision: 24-JAN-1988 17:12 (1)
Record format: Variable length
Record attributes: Carriage return carriage control
Review status: None
2A2 22-JAN-1988 14:36:56 JONES "another routine added"
File creation: 22-JAN-1988 14:36
File revision: 22-JAN-1988 18:01 (1)
Record format: Variable length
Record attributes: Carriage return carriage control
Review status: None
2A3 22-JAN-1988 14:45:12 JONES "last one I promise"
File creation: 22-JAN-1988 14:45
File revision: 27-JAN-1988 08:30 (1)
Record format: Variable length
Record attributes: Carriage return carriage control
Review status: None
This command displays complete generation file information for
each archived generation in the archive file.
3 – CLASS
Displays information about one or more classes in a CMS library.
Format:
SHOW CLASS [class-expression]
3.1 – Command Parameters
class-expression
Specifies one or more classes to be listed. If you do not specify
a class name, CMS lists all classes in the library. A class
expression can be a class name, a wildcard expression, or a list
of these separated by commas.
3.2 – Description
The SHOW CLASS command lists the names of all established classes
in alphabetical order, along with the associated creation remarks.
3.3 – Qualifiers
3.3.1 /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.3.2 /BRIEF
The /BRIEF qualifier displays only class names.
3.3.3 /CONTENTS
Controls whether CMS identifies the element generations that
belong to each class. If you specify /CONTENTS, CMS displays the
class name and the creation remark, along with the element name
and generation number for each generation in the class.
3.3.4 /FULL
The /FULL qualifier displays the name, creation remark, and
read-only attribute (if established) for each class.
3.3.5 /INTERMEDIATE
The /INTERMEDIATE qualifier displays the name and creation remark
for each class.
3.3.6 /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 CLASS
CLASS (D)
NOCLASS
NONE--equivalent to NOCLASS
You can specify either ALL, NONE, or the [NO]CLASS keyword.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
3.3.7 /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.
3.4 – Examples
(1) CMS> SHOW CLASS
Classes in CMS Library DISKX:[RELEASE.CMSLIB]
INTERNAL_RELEASE "for internal use only"
MESSAGETEST "filter evolution checks"
PASCAL_CLASS "PASCAL tests"
This command displays the class name and the creation remark
for each class in the library.
(2) CMS> SHOW CLASS/BRIEF
Classes in CMS Library DISKX:[RELEASE.CMSLIB]
INTERNAL_RELEASE MESSAGETEST PASCAL_CLASS
This command limits the output to class names only.
4 – ELEMENT
Displays information about one or more elements in a CMS library.
Format:
SHOW ELEMENT [element-expression]
4.1 – Command Parameters
element-expression
Specifies one or more elements to be listed. If you do not supply
an element expression, CMS lists all the elements 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.
4.2 – Description
The SHOW ELEMENT command lists the name of each specified element
in alphabetical order, along with the remark logged at the
time the element was created or modified. You can also specify
qualifiers that provide information about element attributes,
concurrent access, and the groups to which the element belongs.
4.3 – Qualifiers
4.3.1 /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.2 /BRIEF
The /BRIEF qualifier displays only element names.
4.3.3 /FORMAT="string"
Controls whether the output of the SHOW ELEMENT 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 group).
The format string can contain printing characters; within the
format string, CMS recognizes #E (and #e) as the element format
parameter. For each line of output (one line per element), CMS
displays the format string and replaces each occurrence of #E (or
#e) with the element name. To include a number sign in the output
line, type it twice (##). When you specify /FORMAT, CMS does
not generate the heading normally produced by the SHOW ELEMENT
command.
To set up a command file, you specify a format string consisting
of a command, including the dollar sign ($) prompt and the
element format parameter (for example, /FORMAT="$ CMS FETCH #E").
Use the /OUTPUT qualifier to direct the output to a command file.
When you execute the SHOW ELEMENT 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.3.4 /FULL
The /FULL qualifier displays the name, creation remark, and the
attributes in effect for the specified elements.
4.3.5 /INTERMEDIATE
The /INTERMEDIATE qualifier displays the name and creation remark
associated with the element.
4.3.6 /MEMBER
Lists the element name, creation remark, and the names of any
groups to which the element belongs.
4.3.7 /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)
ELEMENT (D)
NOELEMENT
GROUP (D)
NOGROUP
NONE--equivalent to (NOELEMENT, NOGROUP)
You can specify either ALL or NONE, or any combination of the
[NO]ELEMENT and [NO]GROUP keywords.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
4.3.8 /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.4 – Examples
(1) CMS> SHOW ELEMENT/BRIEF
Elements in CMS Library DISKX:[PROJECT.CMSLIB]
CCM.FOR CCM1.FOR COPYTEST.FOR
This command limits the output to element names only.
(2) CMS> SHOW ELEMENT/FORMAT="$ CMS FETCH #E"/OUTPUT=FETCH.COM
This command produces a file named FETCH.COM that contains a
fetch command for each element in the library. The contents of
a file produced by this command might look like the following:
$ CMS FETCH INIT.FOR
$ CMS FETCH INITX.FOR
$ CMS FETCH MSGDOC.FOR
$ CMS FETCH OUTPUT.FOR
$ CMS FETCH SEARCH.FOR
5 – GENERATION
Displays information about one or more element generations in a
CMS library.
Format:
SHOW GENERATION [element-expression]
5.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.
5.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.
5.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.
5.4 – Qualifiers
5.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.
5.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.
5.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.
5.4.4 /BRIEF
The /BRIEF qualifier displays only element names and
generation numbers for each specified generation.
5.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.
5.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.
5.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.
5.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.
5.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.
5.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.
5.4.11 /MEMBER
Lists the element name, generation number, and the names of any
classes to which the element generation belongs.
5.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.
5.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.
5.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.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
6 – GROUP
Displays information about one or more groups in a CMS library.
Format:
SHOW GROUP [group-expression]
6.1 – Command Parameters
group-expression
Specifies the group to be listed. If you do not supply a
group expression, CMS lists all groups in the library. A group
expression can be a group name, a wildcard expression, or a list
of these separated by commas.
6.2 – Description
The SHOW GROUP command lists the names of all established groups
in alphabetical order, along with the remark logged at the time
each group was created or modified.
6.3 – Qualifiers
6.3.1 /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.
6.3.2 /BRIEF
The /BRIEF qualifier displays only group names.
6.3.3 /CONTENTS[=n]
Lists the group name and creation remark, along with the names of
any elements or groups contained within the specified group.
You can specify an integer value (n) that directs CMS to display
nested groups up or down to and including the level indicated by
n. When you specify /CONTENTS without a value, CMS displays one
level of contents. You can also specify /CONTENTS=ALL to display
all levels of contained groups.
6.3.4 /FULL
The /FULL qualifier displays the group name, creation remark, and
read-only attribute (if established) for each group.
6.3.5 /INTERMEDIATE
The /INTERMEDIATE qualifier displays the name and creation remark
associated with each group.
6.3.6 /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 GROUP
GROUP (D)
NOGROUP
NONE--equivalent to NOGROUP
You can specify either ALL, NONE, or the [NO]GROUP keyword.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
6.3.7 /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.
6.4 – Examples
(1) CMS> SHOW GROUP
Groups in CMS Library DISKX:[PROJECT.CMSLIB]
ARTWORK "graph display"
OUT_DEFS "output definition files"
TEST_ART "tests for graphs"
This command displays the group name and the creation remark
associated with the group, by default. Because no group name
is specified on the command line, CMS lists all groups in the
library.
(2) CMS> SHOW GROUP ARTWORK/CONTENTS
Groups in CMS Library DISKX:[WORK.CMSV3.CALL.TEST.CMSLIB]
ARTWORK "graph display"
5666.ARTWRK
CHAP_ART.TXT
FIG3.FIG
MODPARAM5.SDML
TEST_ART
This command produces a list of elements and groups that are
members of group ARTWORK. The group TEST_ART was inserted into
ARTWORK with the INSERT GROUP command; thus, as the contents of
TEST_ART change, the elements accessible in the group ARTWORK
change.
7 – HISTORY
Displays a chronological list of transactions performed on a
CMS library. You can limit the number of transactions that are
displayed by specifying different parameters and qualifiers on the
command.
Format:
SHOW HISTORY [object-expression]
7.1 – Command Parameters
object-expression
Specifies an object about which history information is to be
displayed. The object expression can be one or more class names,
element names, group names, a wildcard expression, or a list of
any of these, separated by commas. If you do not specify an object
expression, CMS lists all classes, elements, and groups in the
library.
7.2 – Description
The SHOW HISTORY command lists information about CMS library
transactions. CMS records all transactions that update the
library. The following transactions are not logged in the library
history:
ANNOTATE SET LIBRARY
DIFFERENCES SHOW commands
FETCH (no remark) VERIFY (no qualifiers)
RETRIEVE ARCHIVE
The SHOW HISTORY command displays a chronological list of
transactions. The transaction records are displayed in the
following format:
date time username command remark
A space separates each item in the transaction record. Each item
is explained below.
date
Displays the date the command was issued, in the following
format:
[d]d-mmm-yyyy
For example:
9-JUN-1988
time
Displays the time the command was issued, in the following
format:
hh:mm:ss
For example:
17:12:12
09:02:33
username
Displays the user name of the person who issued the command.
command
Identifies the command that was issued. The string "CMS" does
not appear as part of the command. The command name, option
name (if any), and any parameters are displayed. If the command
operates on a particular generation of an element, the element
name is followed by the generation number enclosed in parentheses;
for example, SEMANTICS.PAS(3). Qualifiers that indicate some
modification of the library are logged; for example, the /NAME
qualifier with a MODIFY command.
remark
Specifies a character string that was logged in the history file
with this command, usually used to explain why the command was
entered. The remark is enclosed in quotation marks. If no remark
was entered, a null remark ("") is displayed.
The following is an example of one transaction record:
11-AUG-1988 11:54:15 TAYLOR REPLACE SYNTAX.PAS(3) "RECORD and FOR
loop syntax compatible"
This record shows that on August 11, 1988, at 11:54, user TAYLOR
issued the REPLACE command on SYNTAX.PAS, which created generation
3.
For any command that caused an unusual occurrence, CMS displays an
asterisk in the first column.
Note that because transaction records for elements, groups, or
classes deleted from a library are retained (see DELETE ELEMENT,
DELETE GROUP, and DELETE CLASS), SHOW HISTORY can display records
for elements and classes that do not currently exist. If a deleted
name is reused, SHOW HISTORY does not distinguish between the old
and the new histories.
7.3 – Qualifiers
7.3.1 /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.
7.3.2 /BEFORE=date-time
Lists all history information prior to a specified date. By
default, the time is the current date and time. The time value
can be an absolute, delta, or combination time value, or one of
the following keywords: TODAY, TOMORROW, or YESTERDAY.
7.3.3 /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 OTHER
OTHER (D)
NOOTHER
NONE--equivalent to NOOTHER
You can specify either ALL, NONE, or the [NO]OTHER keyword.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
7.3.4 /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.
7.3.5 /SINCE=date-time
Specifies that only those history entries dated on or after the
given time are to be displayed. The time value can be an absolute,
delta, or combination time value, or one of the following
keywords: TODAY, TOMORROW, or YESTERDAY. When the /SINCE qualifier
is omitted, all transactions that occurred since the library was
created are displayed. If you specify the /SINCE qualifier but do
not specify a value, CMS defaults to /SINCE=TODAY.
7.3.6 /TRANSACTIONS=(keyword,...)
7.3.7 /NOTRANSACTIONS=(keyword,...)
Displays all transaction records generated by a specific command.
You can specify the following keywords with this qualifier:
ACCEPT FETCH REMOVE
ALL INSERT REPLACE
CANCEL MARK RESERVE
COPY MODIFY REVIEW
CREATE REJECT SET
DELETE REMARK UNRESERVE
VERIFY
If you specify more than one keyword, you must enclose the keyword
list in parentheses. The /TRANSACTIONS qualifier directs CMS
to list transaction records for only the listed keywords. The
/NOTRANSACTIONS qualifier directs CMS to list transaction records
for all keywords except the listed keywords.
7.3.8 /UNUSUAL
Controls whether transactions recorded as unusual occurrences
are displayed. If you specify /UNUSUAL, only unusual transactions
are displayed. By default, /NOUNUSUAL displays all transactions,
including unusual occurrences. The following CMS transactions are
defined as unusual occurrences:
o A RESERVE command specifying an element that is already
reserved
o A concurrent replacement
o A VERIFY/RECOVER command
o A VERIFY/REPAIR command
o A CONVERT LIBRARY command
o A REMARK/UNUSUAL command
7.3.9 /USER=username
Lists the transactions executed by the specified user.
7.4 – Example
CMS> SHOW HISTORY
History of CMS Library DISKX:[PROJECTLIB]
15-JAN-1988 08:45:15 SNOW CREATE LIBRARY [PROJECTLIB] "code library"
25-JAN-1988 10:23:42 SNOW CREATE ELEMENT STRING.LIB(1) "string defs"
25-JAN-1988 13:37:57 SCHULTZ CREATE ELEMENT SIGNAL.LIB(1) "signaling
defs"
25-JAN-1988 14:09:37 PADDOCK CREATE ELEMENT CONVRT.BLI(1) "gen
conversion util"
26-JAN-1988 13:59:16 PADDOCK DELETE ELEMENT CONVRT.BLI "wrong format"
27-JAN-1988 10:51:05 PADDOCK CREATE ELEMENT CNVNUM.BLI(1) "conversion
routines"
10-FEB-1988 10:51:48 SNOW CREATE ELEMENT SYSUTL.BLI(1) "general
utilities"
21-FEB-1988 11:11:55 SNOW RESERVE STRING.LIB(1) "change definitions"
23-FEB-1988 11:22:31 SNOW REPLACE STRING.LIB(2) "added characters"
23-FEB-1988 11:23:41 PADDOCK RESERVE CNVNUM.BLI(1) "change constant
values"
23-FEB-1988 12:15:21 SNOW FETCH STRING.LIB(1) "check differences"
23-FEB-1988 12:20:42 PADDOCK REPLACE CNVNUM.BLI(2) "constant values
changed"
.
.
.
This command shows part of the early history of a library.
8 – LIBRARY
Displays the directory specification of the current CMS library.
SHOW LIBRARY also checks whether the directory is a valid CMS
library (unless you specify the /BRIEF qualifier).
Format:
SHOW LIBRARY
8.1 – Description
The SHOW LIBRARY command identifies the current CMS library. If
you have not designated a CMS library for the current session
(with SET LIBRARY or CREATE LIBRARY), this command issues an error
message.
8.2 – Qualifiers
8.2.1 /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.
8.2.2 /BRIEF
The /BRIEF qualifier displays the directory specification (and
does not lock the library) even if the default library is locked
by another user. However, if the library needs recovery, it is
not detected until another operation is performed.
8.2.3 /FULL
The /FULL qualifier displays the current library directory
specification, the number of elements, groups, classes,
reservations, concurrent replacements, reviews pending, and
the current reference copy directory specification, if any.
8.2.4 /INTERMEDIATE
The /INTERMEDIATE qualifier displays the directory specification
of the current CMS library.
8.2.5 /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.
8.3 – Examples
(1) CMS> SHOW LIBRARY
Your CMS library list consists of:
DISKX:[PROJECT.CMSLIB]
This command displays the device and directory where the
current CMS library is located.
(2) CMS> SHOW LIBRARY/FULL
Your CMS library list consists of:
DISKX:[CODE.CMSLIB]
and contains
224 elements
4 groups
7 classes
6 reservations
0 concurrent replacements
5 reviews pending
REFERENCE_COPY directory is DISKX:[CODE.REQUIRE]
This command directs CMS to display additional information
about the contents of the library.
9 – RESERVATIONS
Displays all current reservations and concurrent replacements in
effect at the time the command is issued.
Format:
SHOW RESERVATIONS [element-expression]
9.1 – Command Parameters
element-expression
Specifies one or more elements for which CMS displays current
reservation and concurrent replacement information. If you do
not specify an element expression, information is displayed for
all elements. An element expression can be an element name, a
group name, a wildcard expression, or a list of these separated by
commas.
9.2 – Description
The SHOW RESERVATIONS command provides information about current
reservations and concurrent replacements. For each element that
has one or more generations reserved, the output consists of the
element name and the following:
o For each reservation--identification number, user, reserved
generation number, date, time, and remark
o For each concurrent replacement--user, replaced generation
number, date, time, and remark
The elements are listed in alphabetical order.
9.3 – Qualifiers
9.3.1 /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.
9.3.2 /BEFORE=date-time
Lists current reservations that were executed prior to the
specified time. The date value can be an absolute, delta, or
combination time value, or one of the following keywords: TODAY,
TOMORROW, or YESTERDAY. By default, CMS displays all existing
reservations.
9.3.3 /CONCURRENT
Lists only concurrent reservations and concurrent replacements.
9.3.4 /GENERATION[=generation-expression]
Lists reservations for a specific generation or set of generations
in a class.
9.3.5 /NOREPLACEMENTS
Indicates that concurrent replacements are not to be displayed.
9.3.6 /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.3.7 /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.
9.3.8 /SINCE=date-time
Lists current reservations that were executed after the specified
time. The time value can be an absolute, delta, or combination
time value, or one of the following keywords: TODAY, TOMORROW, or
YESTERDAY.
9.3.9 /USER=username
Lists current reservations that were executed by the specified
user. If you do not specify this qualifier, CMS lists reservations
held by all users.
9.4 – Example
CMS> SHOW RESERVATIONS
Reservations in CMS Library DISKX:[PROJECT.CMSLIB]
AUDIT.FOR
(2) STEVEW 8 25-APR-1988 09:46:38 "add checks for
file attributes"
Concurrent replacements
STEVEM 9 16-MAY-1988 16:01:30 "change %ascid
& non-picrefs to pic"
GETCMD.FOR
(1) STEVEM 15 17-MAY-1988 21:28:34 "fix access
violation"
INIT.FOR
(1) SMITH 13 15-MAY-1988 15:09:33 "context
reference--add_field"
LSTUTL.FOR
(1) STEVEM 5 17-MAY-1988 21:43:10 "bug fixes"
This command lists the element name, the identification
number of the reservation, the user who has it reserved, the
generation number, and the date, time, and remark associated
with the reservation for each element. In addition, CMS reports
that the element AUDIT.FOR has been concurrently replaced,
creating generation 9. As a result, user STEVEW must create a
variant when he replaces the element.
10 – REVIEWS_PENDING
Displays a list of element generations that currently have review
pending status.
Format:
SHOW REVIEWS_PENDING [element-expression]
10.1 – Command Parameters
element-expression
Specifies one or more elements which are to be searched for
generations with pending reviews. By default, all elements are
searched. An element expression can be an element name, a group
name, a wildcard expression, or a list of these separated by
commas.
10.2 – Description
The SHOW REVIEWS_PENDING command provides information about
element generations currently marked for review. For each element
with generations under review, the output consists of the element
name, user, generation number, date, time, replacement remark,
and any associated review comments that were established with the
REVIEW GENERATION command. The elements are listed in alphabetical
order.
10.3 – Qualifiers
10.3.1 /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.
10.3.2 /BEFORE=date-time
Specifies that only generations placed under review before the
indicated date and time are to be displayed. By default, all
generations with reviews pending are displayed. The date value
can be an absolute, delta, or combination time value, or one of
the following keywords: TODAY, TOMORROW, or YESTERDAY.
10.3.3 /GENERATION[=generation-expression]
Specifies that only reviews pending for generations matching
the generation expression are to be displayed. By default, all
generations with reviews pending are displayed.
10.3.4 /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.
10.3.5 /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.
10.3.6 /SINCE=date-time
Specifies that only generations placed under review after the
indicated date and time are to be displayed. By default, all
generations with reviews pending are displayed. The date value
can be an absolute, delta, or combination time value, or one of
the following keywords: TODAY, TOMORROW, or YESTERDAY.
10.3.7 /USER=username
Specifies that only reviews pending for generations created by the
indicated user are to be displayed. By default, all generations
with reviews pending are displayed.
10.4 – Example
$ CMS SHOW REVIEWS_PENDING
Reviews pending in CMS Library DISKX:[WORK.CMSLIB]
EXAMPLE.SDML
DAVIS 3 22-JAN-1988 10:40:26 "example is now complete"
Review comments
EVEDITOR 23-JAN-1988 14:41:54 "this looks wonderful!"
JONES 25-JAN-1988 11:30:02 "agreed...let's submit it"
4777TIM_TST.BAS
KENW 6 04-FEB-1988 09:22:36 "we need to verify this
program"
This command shows all generations of elements in the library
that are currently on the review pending list.
11 – VERSION
Displays the version number of the CMS system currently in use.
Format:
SHOW VERSION
11.1 – Description
The SHOW VERSION command shows the version number of the current
CMS system.
11.2 – Qualifiers
11.2.1 /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.
11.2.2 /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.
11.3 – Example
CMS> SHOW VERSION
CMS Version V3.0
This command shows the current version of CMS.