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.