1 – ELEMENT
Removes one or more elements from one or more groups.
Format:
REMOVE ELEMENT element-expression group-expression "remark"
1.1 – Restrictions
o You cannot remove elements from a group that has read-only
access (see the description of the MODIFY GROUP command).
1.2 – Command Parameters
element-expression
Specifies one or more elements to be removed from one or more
groups. 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 group does not contain the element being
removed.)
group-expression
Specifies the group from which one or more elements are to be
removed. A group expression can be a group 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.
1.3 – Description
The REMOVE ELEMENT command removes one or more elements from one
or more groups. The command does not delete the elements from
the library, but there is no longer any association between the
elements and the groups.
1.4 – Qualifiers
1.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.
1.4.2 /IF_PRESENT
Directs CMS to remove the element from the group if it belongs to
the group. If the element does not belong to the group, CMS takes
no action and does not return an error. When you use wildcard
characters in the element expression, /IF_PRESENT is the default.
1.4.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.4.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)
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.
1.5 – Example
CMS> REMOVE ELEMENT *.* A2 "remove all elements from group"
%CMS-S-REMOVED, element DISKX:[PROJECT.CMSLIB]SEARCH.FOR
removed from group DISKX:[PROJECT.CMSLIB]A2
%CMS-S-REMOVED, element DISKX:[PROJECT.CMSLIB]ARGCHK.FOR
removed from group DISKX:[PROJECT.CMSLIB]A2
.
.
.
This command removes all the elements from the group A2.
2 – GENERATION
Removes one or more element generations from one or more classes.
Format:
REMOVE GENERATION element-expression class-expression "remark"
2.1 – Restrictions
o You cannot remove a generation from a class with read-only
access (see the description of the MODIFY CLASS command).
2.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.
2.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.
2.4 – Qualifiers
2.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.
2.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.
2.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.
2.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.
2.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.
2.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.
3 – GROUP
Removes one or more groups from another group or groups.
Format:
REMOVE GROUP group-expression1 group-expression2 "remark"
3.1 – Restrictions
o You cannot remove a group from a group with read-only access
(see the description of the MODIFY GROUP command).
3.2 – Command Parameters
group-expression1
Specifies one or more groups to be removed. Wildcards and a comma
list are allowed. When you use wildcard characters or a comma
list in the group name, /IF_PRESENT is the default. (CMS does
not return an error message if group-expression2 does not contain
group-expression1.)
group-expression2
Specifies one or more groups from which the groups in group-
expression1 are to be removed. Wildcards and a comma list are
allowed.
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.3 – Description
The REMOVE GROUP command removes a group from another group. The
command does not delete the group from the library, but there is
no longer any association between the two groups. Removing group
A from group B means that the contents of group A are no longer
accessible through group B.
3.4 – Qualifiers
3.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.
3.4.2 /IF_PRESENT
Directs CMS to remove group-expression1 only if it belongs to
group-expression2. If group-expression1 does not belong to group-
expression2, CMS takes no action and does not return an error.
When you use wildcard characters or a comma list in the group
name, /IF_PRESENT is the default.
3.4.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.
3.4.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 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.
3.5 – Example
CMS> REMOVE GROUP A1 A2 "remove group from group"
%CMS-S-REMOVED, group DISKX:[PROJECT.CMSLIB]A1 removed from group
DISKX:[PROJECT.CMSLIB]A2
This command removes group A1 from group A2.