Removes one or more element generations from one or more classes.
Format:
REMOVE GENERATION element-expression class-expression "remark"
1 – Restrictions
o You cannot remove a generation from a class with read-only
access (see the description of the MODIFY CLASS command).
2 – Command Parameters
element-expression
Specifies one or more generations of elements to be removed from
one or more classes. An element expression can be an element
name, a group name, a wildcard expression, or a list of these
separated by commas. When you use wildcard characters in the
element expression, /IF_PRESENT is the default. (CMS does not
return an error message if the class does not contain a generation
of the element.)
class-expression
Specifies the class from which the element generation is to
be removed. The class must not have read-only access. A class
expression can be a class name, a wildcard expression, or a list
of these separated by commas.
remark
Specifies a character 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.
3 – Description
The REMOVE GENERATION command removes an element generation from a
class. The command does not delete the element generation from the
library, but the element generation is no longer associated with
the class.
To remove one element generation from a class and replace it with
another generation of the same element, use the INSERT GENERATION
command with the /SUPERSEDE qualifier.
4 – Qualifiers
4.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.
4.2 /GENERATION[=generation-expression]
Directs CMS to remove a particular generation of an element
from one or more classes in the library. The generation must
be currently existing in the class. If you use a wildcard or a
list of class names for the class expression, CMS deletes the
particular generation from each specified class.
4.3 /IF_PRESENT
Directs CMS to remove any generation of the element that exists
in the class. If the class does not contain a generation from the
element, CMS takes no action and does not return an error. When
you use wildcard characters in the element expression, /IF_PRESENT
is the default.
4.4 /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.
4.5 /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 – Example
CMS> REMOVE GENERATION USER.DOC PRE_RELEASE_V3
_Remark: internal documentation is online
%CMS-S-GENREMOVED, generation 2 of element
DISKX:[PROJECT.CMSLIB]USER.DOC removed from class
DISKX:[PROJECT.CMSLIB]PRE_RELEASE_V3
This example removes generation 2 of USER.DOC from class PRE_
RELEASE_V3.