Displays a list of element generations that currently have review
pending status.
Format:
SHOW REVIEWS_PENDING [element-expression]
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.
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.
3 – Qualifiers
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.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.
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.
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.
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.
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.
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.
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.