1 – REVIEW
The CANCEL REVIEW command changes the review status of each
specified element generation from "pending" to "none" and removes
it from the review pending list.
Format:
CANCEL REVIEW element-expression "remark"
1.1 – Command Parameters
element-expression
Specifies one or more elements. An element expression can be an
element name, a group name, a wildcard expression, or a list of
these separated by commas.
remark
Specifies a string to be 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 logged.
1.2 – Description
The CANCEL REVIEW command changes the review status of each
specified element generation from "pending" to "none" and removes
it from the review pending list.
Use this command only on element generations that have reviews
pending (see the description of the REVIEW GENERATION command for
more information).
1.3 – Qualifiers
1.3.1 /CONFIRM
Controls whether CMS prompts you for confirmation before each
transaction.
When you specify /CONFIRM and run CMS in interactive mode, CMS
prompts you for confirmation. If you type YES, ALL, TRUE, or 1,
CMS executes the transaction. If you type NO, QUIT, FALSE, 0,
or press RETURN or CTRL/Z, no action is performed. If you type
any other character, CMS continues to prompt until you type an
acceptable response.
CMS does not prompt for confirmation in batch mode.
1.3.2 /GENERATION[=generation-expression]
Specifies which generation of the element is to have its review
pending status canceled. If you omit /GENERATION, CMS cancels
the review of the most recently created generation with a
review pending. You specify this qualifier only if more than one
generation of an element is under review.
1.3.3 /LOG (D)
Controls whether CMS displays success and informational messages
on the default output device. By default, if the command executes
successfully, CMS displays a success message. If you specify
/NOLOG, success and informational messages are suppressed. Any
warning, error, or fatal error messages are displayed regardless
of whether /LOG or /NOLOG is specified.
1.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.
1.4 – Example
$ CMS CANCEL REVIEW EXAMPLE.SDML "review the final version only"
%CMS-S-CANCELED, review of generation 2 of element
DISKX:[PROJECT.CMSLIB]EXAMPLE.SDML canceled
This command cancels the review of the element EXAMPLE.SDML,
and removes it from the review pending list.